(easywechat + Laravel 5.8) WeChat 스캔코드 결제 전 과정을 PC에서 정리

비즈니스 시나리오 설명:

사용자가 사이트 페이지에서 "구매"를 클릭합니다. --> QR 코드가 나타납니다. --> WeChat QR 코드로 QR 코드 --> WeChat의 안내에 따라 결제를 완료하세요 --> 결제가 성공하면 페이지에 결제 성공 메시지가 표시되고 점프됩니다

#🎜🎜 # WeChat과 상호작용하는 데는 세 가지 단계만 있습니다. #🎜 🎜#1. 매개변수 전달, WeChat 통합 주문 인터페이스 요청, 결제 QR 코드 받기

2 . WeChat 알림 수신(WeChat은 이전 단계 매개변수 주소의 콜백을 전달하고 결제 결과를 내 서버로 전송)

3 WeChat에 주문 인터페이스를 요청하고 결제가 성공하면 페이지가 점프됩니다

다음 기록은 기본적으로 위의 프로세스에 따릅니다.

준비:

설치

overtrue/laravel-wechat

composer require "overtrue/laravel-wechat:~5.0"

# 🎜🎜#구성 파일 생성:

php artisan vendor:publish --provider="Overtrue\LaravelWeChat\ServiceProvider"

응용 프로그램 루트의 config/wechat.php에서 해당 매개변수를 수정합니다. 디렉터리(이 부분을 복사/붙여넣기):

'payment' => [
         'default' => [
             'sandbox'            => env('WECHAT_PAYMENT_SANDBOX', false),
             'app_id'             => env('WECHAT_PAYMENT_APPID', ''),
             'mch_id'             => env('WECHAT_PAYMENT_MCH_ID', 'your-mch-id'),
             'key'                => env('WECHAT_PAYMENT_KEY', 'key-for-signature'),
             'cert_path'          => env('WECHAT_PAYMENT_CERT_PATH', 'path/to/cert/apiclient_cert.pem'),    // XXX: 绝对路径！！！！
             'key_path'           => env('WECHAT_PAYMENT_KEY_PATH', 'path/to/cert/apiclient_key.pem'),      // XXX: 绝对路径！！！！
             'notify_url'         => env('WECHAT_PAYMENT_NOTIFY_URL',''),                           // 默认支付结果通知地址
         ],
         // ...
     ],

#🎜🎜 #구성해야 할 것은 위 배열의 콘텐츠이지만 실제로는 .env 파일에서 구성해야 합니다:

# wechat_payment
WECHAT_PAYMENT_SANDBOX=false
# 真正需要配置的就下面这四行
WECHAT_PAYMENT_APPID=xxxxxxxxxxxxxxx // 自己的
WECHAT_PAYMENT_MCH_ID=xxxxxxx  // 自己的
WECHAT_PAYMENT_KEY=xxxxxxxxxxxxxxxxxxxx  // 自己的
WECHAT_PAYMENT_NOTIFY_URL='test.abc.com/payment/notify' // 这个地址只要是外网能够访问到项目的任何地址都可以, 不是需要在微信那里配置的那种, 现在还不知道怎么定义没关系, 后面用到的时候自然就有了
SWAGGER_VERSION=3.0

Installation

Simple QrCode

QR 코드 패키지 생성

은 다음과 같이 작곡가.json 파일에 추가됩니다. #🎜🎜 #

"require": {
    "simplesoftwareio/simple-qrcode": "~2"
}

터미널에서 실행: 작곡가 업데이트, 나중에 사용됩니다.#🎜🎜 #---------------------- ---------- 위는 준비작업입니다. 과정을 따라가 보겠습니다--------------- --------------

# 🎜🎜#사용자가 "구매"를 클릭합니다.

주문하기#🎜 🎜# --> QR 코드가 뜹니다

WeChat 요청은 다음과 같습니다

통합 주문#🎜🎜 #Interface.

내가 처리하는 논리는 :

사용자가 구매 요청을 하면 먼저 결제 로그에 기록을 생성하고 사용자가 결제를 완료할 때까지 기다린 후 주문 기록을 생성합니다.

Create WeChat 결제 로직을 처리하기 위한 새로운 PaymentController(OrderController와 다름) [통합 주문] 인터페이스.

주문 요청을 시작하는 페이지 부분

Html 부분:

#🎜🎜 # (QR 코드의 모달박스는 부트스트랩 문서를 기준으로 작성되었습니다.)

<button type="button" id="order" class="btn btn-secondary btn-block">
    扫码支付
</button>
<!-- 二维码, 随便放在当前页面的那里都可以, 因为是通过 axios 控制, 请求成功后才会弹出的 -->
<div class="modal fade" id="qrcode" tabindex="-1" role="dialog" aria-hidden="true">
        <div class="modal-dialog modal-sm" role="document">
            <div class="modal-content bg-transparent" style="border:none">
                <div class="modal-body align-items-center text-center">
                    <p class="modal-title" id="exampleModalLabel" style="color:white">微信扫码支付</p>
                    <br>
                    {{--生成的二维码会放在这里--}}
                    <div id="qrcode2"></div>
                </div>
            </div>
        </div>
    </div>

JS 부분:

$('#order').click(function () {
    /** 请求下单接口 **/
    axios.get("/payment/place_order", {
        params: {
            id: "{{ $post->id }}"
        }
    }).then(function (response) {
        if (response.data.code == 200) {
            /** 把生成的二维码放到页面上 */
            $('#qrcode2').html(response.data.html);
            /** 弹出二维码 **/
            $('#qrcode').modal('show');
            /** 设置定时器, 即一弹出二维码就开始不断请求查看支付状态, 直到收到支付成功的返回, 再终止定时器 **/
            var timer = setInterval(function () {
                /** 在这里请求微信支付状态的接口 **/
                axios.get('/payment/paid', {
                    params: {
                    'out_trade_no':response.data.order_sn,
                    }
                }).then(function (response) {
                    if (response.data.code == 200) {
                        /** 如果支付成功, 就取消定时器, 并重新加载页面 */
                        window.clearInterval(timer);
                        window.location.reload();
                        }
                    }).catch(function (error) {
                            console.log(error);
                        });
                    }, 3000);
                }
            }).catch(function (error) {
                    console.log(error);
                });
            });

경로 만들기

여기서 먼저 위의 JS 부분에서 요청한 두 경로를 작성합니다. 첫 번째 경로는 아래에 설명되어 있습니다.

// 请求微信统一下单接口
Route::get('/payment/place_order', 'PaymentController@place_order')->name('web.payment.place_order');
// 请求微信接口, 查看订单支付状态
Route::get('/payment/paid', 'PaymentController@paid')->name('web.payment.paid');
PaymentController 里的支付逻辑
下面是具体的逻辑，用户点击支付后，先创建一条记录在 PayLog (用来记录支付的详细信息，所以这里还需要建 Paylog 的 model 和 migration, migration 的内容我附在最后了，都是微信返回的字段，基本可以直接 copy 来用的)
class PaymentController extends Controller
{
    // 请求微信接口的公用配置, 所以单独提出来
    private function payment()
    {
        $config = [
            // 必要配置, 这些都是之前在 .env 里配置好的
            'app_id' => config('wechat.payment.default.app_id'),
            'mch_id' => config('wechat.payment.default.mch_id'),
            'key'    => config('wechat.payment.default.key'),   // API 密钥
            'notify_url' => config('wechat.payment.default.notify_url'),   // 通知地址
        ];
        // 这个就是 easywechat 封装的了, 一行代码搞定, 照着写就行了
        $app = Factory::payment($config);
        return $app;
    }
    // 向微信请求统一下单接口, 创建预支付订单
    public function place_order($id)
    {
        // 因为没有先创建订单, 所以这里先生成一个随机的订单号, 存在 pay_log 里, 用来标识订单, 支付成功后再把这个订单号存到 order 表里
        $order_sn = date('ymd').substr(time(),-5).substr(microtime(),2,5);
        // 根据文章 id 查出文章价格
        $post_price = optional(Post::where('id', $id)->first())->pirce;
        // 创建 Paylog 记录
        PayLog::create([
            'appid' => config('wechat.payment.default.app_id'),
            'mch_id' => config('wechat.payment.default.mch_id'),
            'out_trade_no' => $order_sn,
            'post_id' => $id
        ]);
        $app = $this->payment();
        $total_fee = env('APP_DEBUG') ? 1 : $post_price;
        // 用 easywechat 封装的方法请求微信的统一下单接口
        $result = $app->order->unify([
            'trade_type'       => 'NATIVE', // 原生支付即扫码支付，商户根据微信支付协议格式生成的二维码，用户通过微信“扫一扫”扫描二维码后即进入付款确认界面，输入密码即完成支付。  
            'body'             => '投资平台-订单支付', // 这个就是会展示在用户手机上巨款界面的一句话, 随便写的
            'out_trade_no'     => $order_sn,
            'total_fee'        => $total_fee,
            'spbill_create_ip' => request()->ip(), // 可选，如不传该参数，SDK 将会自动获取相应 IP 地址
        ]);
        if ($result['result_code'] == 'SUCCESS') {
            // 如果请求成功, 微信会返回一个 'code_url' 用于生成二维码
            $code_url = $result['code_url'];
            return [
                'code'     => 200,
                // 订单编号, 用于在当前页面向微信服务器发起订单状态查询请求
                'order_sn' => $order_sn,
                // 生成二维码
                'html' => QrCode::size(200)->generate($code_url),
            ];
        }
    }
}

----- ------ 위챗과 소통하는 첫 번째 단계(통합 주문 인터페이스 요청)가 완료되었습니다. -----------

#🎜🎜 받기 of WeChat #Notification

routing

WeChat은 위 요청에 전달된 inform_url을 기반으로 내 서버를 요청합니다. 결제 결과가 나에게 왔다면 반드시 포스트 요청이어야 합니다:

Route::post('/payment/notify', 'paymentController@notify');

CSRF 인증 취소

하지만, WeChat 서버에서 시작된 게시물 요청은 csrf 토큰 확인을 통과할 수 없으므로 app/Http/Middleware/VerifyCsrfToken 파일에서 WeChat 라우팅 확인을 취소해야 합니다.

protected $except = [
        //
        'payment/notify'
    ];
在 PaymentController.php 文件中处理接收微信信息的逻辑
    // 接收微信支付状态的通知
    public function notify()
    {
        $app = $this->payment();
        // 用 easywechat 封装的方法接收微信的信息, 根据 $message 的内容进行处理, 之后要告知微信服务器处理好了, 否则微信会一直请求这个 url, 发送信息
        $response = $app->handlePaidNotify(function($message, $fail){
            // 首先查看 order 表, 如果 order 表有记录, 表示已经支付过了
            $order = Order::where('order_sn', $message['out_trade_no'])->first();
            if ($order) {
                return true; // 如果已经生成订单, 表示已经处理完了, 告诉微信不用再通知了
            }
            // 查看支付日志
            $payLog = PayLog::where('out_trade_no', $message['out_trade_no'])->first();
            if (!$payLog || $payLog->paid_at) { // 如果订单不存在 或者 订单已经支付过了
                return true; // 告诉微信，我已经处理完了，订单没找到，别再通知我了
            }
            // return_code 表示通信状态，不代表支付状态
            if ($message['return_code'] === 'SUCCESS') {
                // 用户是否支付成功
                if ($message['result_code'] === 'SUCCESS') {
                    // 更新支付时间为当前时间
                    $payLog->paid_at = now();
                    $post_id = $payLog->post_id;
                    // 联表查询 post 的相关信息
                    $post_title = $payLog->post->title;
                    $post_price = $payLog->post->price;
                    $post_original_price = $payLog->post->original_price;
                    $post_cover = $payLog->post->post_cover;
                    $post_description = $payLog->post->description;
                    $user_id = $payLog->post->user_id;
                    // 创建订单记录
                    Order::create([
                        'order_sn' => $message['out_trade_no'],
                        'total_fee' => $message['total_fee'],
                        'pay_log_id' => $payLog->id,
                        'status' => 1,
                        'user_id' => $user_id,
                        'paid_at' => $payLog->paid_at,
                        'post_id' => $post_id,
                        'post_title' => $post_title,
                        'post_price' => $post_price,
                        'post_original_price' => $post_original_price,
                        'post_cover' => $post_cover,
                        'post_description' => $post_description,
                    ]);
                    // 更新 PayLog, 这里的字段都是根据微信支付结果通知的字段设置的(https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_7&index=8)
                    PayLog::where('out_trade_no', $message['out_trade_no'])->update([
                        'appid' => $message['appid'],
                        'bank_type' => $message['bank_type'],
                        'total_fee' => $message['total_fee'],
                        'trade_type' => $message['trade_type'],
                        'is_subscribe' => $message['is_subscribe'],
                        'mch_id' => $message['mch_id'],
                        'nonce_str' => $message['nonce_str'],
                        'openid' => $message['openid'],
                        'sign' => $message['sign'],
                        'cash_fee' => $message['cash_fee'],
                        'fee_type' => $message['fee_type'],
                        'transaction_id' => $message['transaction_id'],
                        'time_end' => $payLog->paid_at,
                        'result_code' => $message['result_code'],
                        'return_code' => $message['return_code'],
                    ]);
                }
            } else {
                // 如果支付失败, 也更新 PayLog, 跟上面一样, 就是多了 error 信息
                PayLog::where('out_trade_no', $message['out_trade_no'])->update([
                    'appid' => $message['appid'],
                    'bank_type' => $message['bank_type'],
                    'total_fee' => $message['total_fee'],
                    'trade_type' => $message['trade_type'],
                    'is_subscribe' => $message['is_subscribe'],
                    'mch_id' => $message['mch_id'],
                    'nonce_str' => $message['nonce_str'],
                    'openid' => $message['openid'],
                    'sign' => $message['sign'],
                    'cash_fee' => $message['cash_fee'],
                    'fee_type' => $message['fee_type'],
                    'transaction_id' => $message['transaction_id'],
                    'time_end' => $payLog->paid_at,
                    'result_code' => $message['result_code'],
                    'return_code' => $message['return_code'],
                    'err_code' => $message['err_code'],
                    'err_code_des' => $message['err_code_des'],
                ]);
                return $fail('通信失败，请稍后再通知我');
            }
            return true; // 返回处理完成
        });
        // 这里是必须这样返回的, 会发送给微信服务器处理结果
        return $response;
    }

위는 다음의 공동 쿼리입니다. pay_logs 테이블과 post 테이블, post pay_log가 여러 개 있을 수 있으므로 일대다 관계입니다. PayLog.php에서 설정하세요.

public function post()
{
    return $this->belongsTo(Post::class);
}

------ -------- 위챗 소통 2단계(정보수신) 완료 ----

Request WeChat주문 보기Interface#🎜 🎜#

주문 상태 인터페이스를 보려면 WeChat에 요청하세요. 라우팅은 상호작용의 첫 번째 단계에서 작성되었습니다

public function paid(Request $request)
    {
        $out_trade_no = $request->get('out_trade_no');
        $app = $this->payment();
        // 用 easywechat 封装的方法请求微信
        $result = $app->order->queryByOutTradeNumber($out_trade_no);
        if ($result['trade_state'] === 'SUCCESS') 
            return [
                'code' => 200,
                'msg' => 'paid'
            ];
        }else{
            return [
                'code' => 202,
                'msg' => 'not paid'
            ];
        }
    }

# 🎜🎜#--------------- --위챗 소통 3단계(주문상태 확인)가 완료되었습니다---#🎜 🎜#

첨부: migration of pay_logs 테이블

이 표의 필드는 기본적으로 위챗 결제 결과 알림을 위한 필드이므로 다음 번에도 쉽게 사용할 수 있도록 아래에 첨부합니다.

public function up()
    {
        Schema::create('pay_logs', function (Blueprint $table) {
            $table->bigIncrements('id');
            // 根据自身业务设计的字段
            $table->integer('post_id')->default(0)->comment('文章id');
            // 以下均是微信支付结果通知接口返回的字段
            $table->string('appid', 255)->default('')->comment('微信分配的公众账号ID');
            $table->string('mch_id', 255)->default('')->comment('微信支付分配的商户号');
            $table->string('bank_type', 16)->default('')->comment('付款银行');
            $table->integer('cash_fee')->default(0)->comment('现金支付金额');
            $table->string('fee_type', 8)->default('')->comment('货币种类');
            $table->string('is_subscribe', 1)->default('')->comment('是否关注公众账号');
            $table->string('nonce_str', 32)->default('')->comment('随机字符串');
            $table->string('openid', 128)->default('')->comment('用户标识');
            $table->string('out_trade_no', 32)->default('')->comment('商户系统内部订单号');
            $table->string('result_code', 16)->default('')->comment('业务结果');
            $table->string('return_code', 16)->default('')->comment('通信标识');
            $table->string('sign', 32)->default('')->comment('签名');
            $table->string('prepay_id', 64)->default('')->comment('微信生成的预支付回话标识，用于后续接口调用中使用，该值有效期为2小时');
            $table->dateTime('time_end')->nullable()->comment('支付完成时间');
            $table->integer('total_fee')->default(0)->comment('订单金额');
            $table->string('trade_type', 16)->default('')->comment('交易类型');
            $table->string('transaction_id', 32)->default('')->comment('微信支付订单号');
            $table->string('err_code', 32)->default('')->comment('错误代码');
            $table->string('err_code_des', 128)->default('')->comment('错误代码描述');
            $table->string('device_info', 32)->default('')->comment('设备号');
            $table->text('attach')->nullable()->comment('商家数据包');
            $table->nullableTimestamps();
        });
    }

위는 페이지에서 주문, 결제, 전체 과정의 기록 페이지로 점프하는 것입니다. 오래 전에 한 번 Laravel-china 튜토리얼을 따라한 것을 제외하면, 실제로 직접 탐색하고 필요에 따라 만든 것은 이번이 처음입니다. 인터넷에 공유되는 글과 튜토리얼이 많지만 모두 마스터 수준이고, 한 획으로 많은 곳이 언급되는 저 같은 후배에게는 한 군데는 망치 같고, 다른 곳은 막대기 같은 느낌이 듭니다. 따라하기 어려운 부분이 있어서 최대한 자세히 정리하려고 노력하는데, 저 같은 초보자들에게 도움이 되었으면 좋겠습니다. 매우 길어 보이지만 적어도 현재 수준에서는 정말 많은 콘텐츠가 필요합니다.

위 내용은 (easywechat + Laravel 5.8) WeChat 스캔코드 결제 전 과정을 PC에서 정리의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!