ホームページ >PHPフレームワーク >Laravel >(easywechat + Laravel 5.8) PC 上で WeChat スキャンコード支払いのプロセス全体を整理します

(easywechat + Laravel 5.8) PC 上で WeChat スキャンコード支払いのプロセス全体を整理します

藏色散人
藏色散人転載
2019-08-21 14:47:306502ブラウズ

ビジネス シナリオの説明:

ユーザーがサイト ページで [購入] をクリック --> QR コードがポップアップ --> ユーザーが WeChat を使用して QR コードをスキャン--> ; WeChat の指示に従って支払いを完了します --> 支払いが成功すると、支払いが成功したことを示すメッセージがページに表示され、ジャンプします

WeChat とのやり取りは 3 つのステップで行われます。

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

インストール シンプルな QrCode QR コード パッケージの生成

composer.json に次のコードを追加しますfile:

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

ターミナルで実行:composer update 、後で使用します。

---------------------- ------------------------ ----以上が準備作業です。手順を追っていきましょう ------------------------ ----------------------------------- --

ユーザーが「購入」をクリック 注文する --> ポップアップ QR コード

WeChat のリクエストです統合注文インターフェイス。

私が処理するロジックは次のとおりです。 :

ユーザーが購入リクエストを開始すると、まず支払いログにレコードを作成し、ユーザーが支払いを完了するまで待ってから注文レコードを作成します。

具体的には新しい PaymentController を作成しますWeChat 支払いのロジックを処理します (OrderController とは異なります)。「購入」をクリックするというユーザーのリクエストに対して、「place_order」メソッドを使用して処理します。つまり、ここで WeChat の [統合注文] インターフェイスをリクエストします。

##注文リクエストを開始するページ上の部分

Html 部分:#(QR コードのモーダル ボックスはブートストラップに従って記述されています) document)

<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 部分:

$(&#39;#order&#39;).click(function () {
    /** 请求下单接口 **/
    axios.get("/payment/place_order", {
        params: {
            id: "{{ $post->id }}"
        }
    }).then(function (response) {
        if (response.data.code == 200) {
            /** 把生成的二维码放到页面上 */
            $(&#39;#qrcode2&#39;).html(response.data.html);
            /** 弹出二维码 **/
            $(&#39;#qrcode&#39;).modal(&#39;show&#39;);
            /** 设置定时器, 即一弹出二维码就开始不断请求查看支付状态, 直到收到支付成功的返回, 再终止定时器 **/
            var timer = setInterval(function () {
                /** 在这里请求微信支付状态的接口 **/
                axios.get(&#39;/payment/paid&#39;, {
                    params: {
                    &#39;out_trade_no&#39;: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);
                });
            });

ルートの作成

ここでは、まず要求された 2 つのルートを JS に記述します上の部分 これは書かれています。まず最初の部分を説明しましょう:

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

----------- WeChat と対話する最初のステップ (統合された注文インターフェイスの要求) 完了----- - -----

WeChat から

通知を受信する

WeChat リクエストをルーティングする

アップロードパラメータのnotify_urlは、サーバーに支払い結果を送信するようリクエストするため、ポストリクエストである必要があります:

Route::post(&#39;/payment/notify&#39;, &#39;paymentController@notify&#39;);

Cancel csrf validation

ただし、WeChat サーバーが開始されました 投稿リクエストは csrf トークン検証に合格できないため、WeChat に使用されるルートの検証をキャンセルする必要があります。app/Http/Middleware/VerifyCsrfToken ファイル内:

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

上記はpay_logs テーブルと Posts テーブルを使用したジョイント テーブル クエリ。投稿には複数の pay_log を含めることができるため、1 対多の関係になります。PayLog.php で設定します:

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

------ --------WeChat との対話 2 番目のステップ (情報の受信)、完了 --------------

WeChat のリクエスト

View orderInterface WeChat に注文ステータス インターフェイスの表示をリクエストします。ルーティングは対話の最初のステップで記述されています

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

--------- -------WeChat との対話の 3 番目のステップ (注文ステータスの確認)、完了しました-----

添付ファイル: pay_logs テーブルの移行

この表のフィールドは基本的に WeChat 決済なので、次回使いやすいように結果通知のフィールドを以下に添付します。

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

上記はページから注文までの全過程の記録ですお支払いへページジャンプへ。ずっと前に一度 Laravel-china のチュートリアルに従ったことを除けば、実際に自分で調べて自分のニーズに合わせて作成したのは今回が初めてです。インターネット上には多くの記事やチュートリアルが共有されていますが、どれもマスターレベルであり、多くの場所が一度に言及されているため、私のような初心者にとって、ある場所ではハンマー、別の場所では槌のような感じです。分かりにくいので、頑張ってメモを詳しくまとめてみましたが、私のような初心者の方の参考になれば幸いです。非常に長く見えますが、少なくとも私の現在のレベルでは、非常に多くの内容が必要です。

以上が(easywechat + Laravel 5.8) PC 上で WeChat スキャンコード支払いのプロセス全体を整理しますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

声明:
この記事はlearnku.comで複製されています。侵害がある場合は、admin@php.cn までご連絡ください。