ホームページ > 記事 > WeChat アプレット > WeChat ミニプログラムの支払いと返金のプロセス例の共有

WeChat ミニプログラムの支払いと返金のプロセス例の共有

小云云オリジナル: 2018-01-05 13:15:353215ブラウズ

まず最初に、WeChat ミニプログラムの支払いのメインロジックはバックエンドに集中していることを説明します。フロントエンドは支払いに必要なデータを送信してバックエンドインターフェイスをリクエストし、それに基づいて対応する成功または失敗を処理するだけで済みます。返された結果。もちろん、このブログでは、支払いの具体的な実装を説明するために大量のコードを投稿するつもりはありませんが、主に支払いプロセス全体といくつかの詳細に焦点を当てます。したがって、他のバックエンド言語を使用している友人は、必要に応じて見てみることができます。多くの場合、開発ニーズとそれに対応する問題解決策は、実際には言語構文レベルを超えて、システムとプロセスの観点から検討する必要があります。タイトルに入ります。

1. 支払い

支払いは主にいくつかのステップに分かれています:

フロントエンドは支払いリクエストを開始するために支払いに必要なデータ(商品ID、購入数量など)を運びます
その後支払いリクエストを受信し、バックエンドが支払いデータを処理し、処理されたデータを送信して WeChat サーバーの支払い統合注文インターフェイスをリクエストします
バックエンドは、WeChat サーバーをリクエストする前のステップからの戻りデータを受け取ります、再度処理し、フロントエンドが支払いを開始できるようにフロントエンドに戻ります。
フロントエンドが支払いアクションを実行します
フロントエンドの支払いが完了すると、WeChatサーバーはバックエンドに支払い通知を送信します(つまり、WeChatは、顧客が支払いました)、バックエンドはこの完了通知に基づいて支払いを決定し、支払い完了後に対応するアクション (注文ステータスの変更、トランザクションログの追加など) を実行します。

これらの手順から、バックエンドの主な機能は、支払いに必要なデータを WeChat サーバーに送信し、WeChat サーバーの応答に基づいて支払いが完了したかどうかを判断することであることがわかります。

このプロセスは非常に理解しやすいです。比喩的に言えば、フロントエンドは顧客、バックエンドは店舗、そして WeChat サーバーの統合注文インターフェイスはレジのようなものです。顧客は店に、私は誰ですか、そして今、私はあなたにこれこれを買いたいのと同じだけの金額を支払わなければなりません、と伝えます。店主はレジ係に「誰々はいくら払わなければなりませんか？お金を集める準備をしてください。」と言いました。レジ係はお金を受け取ると、私がお金を受け取ったので何か渡してもいいよと店に伝えに行きました。

各ステップの具体的な実装については、以下で詳しく説明します。

1. 支払いのフロントエンドリクエスト

支払いのフロントエンドリクエストは、ユーザーID、支払い金額、支払い注文IDなどの支払いに必要なデータを運ぶだけです。ビジネスロジック** または次のステップへ WeChat サーバー支払い統合注文インターフェイスに必要な ** に関連するデータを要求するには、WeChat アプレットの wx.request() を使用してバックエンド支払いインターフェイスを要求します。

2. バックエンドは WeChat サーバーをリクエストします

バックエンドは、フロントエンドから送信された支払いリクエストを受信した後、ユーザーに問題があるかどうか、支払い金額が正しいかどうかの判断など、関連する検証を実行できます。等

問題がなく、WeChat サーバーに支払いを申請できることを確認した後、バックエンドは WeChat によって指定されたデータ形式を使用して、WeChat の統合支払い注文インターフェイスをリクエストする必要があります。

WeChat で指定されたデータをリクエストします:

これを実装するにはさらに多くのコードが必要です。必要なデータ量が大きいため、XML形式で暗号化して送信する必要もあります。

まず第一に、以下のデータは、ミニプログラムを使用して支払うときにWeChatサーバーに提供する必要があるパラメーターです。

ミニプログラムアプリ。小さなプログラムを書く人でこれを知らない人はいないでしょう。。。
ユーザーID openid。これは、前回のブログで取得方法を説明したユーザーのミニプログラム ID です。
販売者番号 mch_id。 WeChat 支払い加盟店認定の申請に成功すると、WeChat から送信される電子メールには加盟店注文番号 out_trade_no が含まれます。この支払いに対して販売者によって生成された注文番号
合計金額 total_fee。注文の合計金額は、単位がセントであることが非常に重要なポイントですので、特に注意してください。
WeChatサーバーのコールバック通知インターフェイスのアドレスnotify_url。 WeChat がお金の到着を確認すると、このアドレスに複数のメッセージが送信され、顧客が支払いを行ったことを通知します。通知を受け取ったことを示すメッセージを WeChat に返信する必要があります。。このアドレスにはポート番号を含めることはできず、POST メソッド要求を直接受け入れることができる必要があります。
トランザクションタイプ trade_type 。 WeChatアプレットの支払い額はJSAPI
商品情報本文として統一されています。「Tencent-Game」
端末のIPアドレスspbill_create_ipの形式に似ています。端末アドレス IP。支払いを要求する IP アドレスです。
ランダムな文字列 nonce_str 。データのセキュリティを確保するには、バックエンドによってランダムに生成された文字列が必要です。 WeChat は 32 ビット以下を必要とします。
署名サイン。上記のすべてのパラメータを使用して暗号化を処理し、それに応じて署名を生成します。 (具体的な処理方法は以下のコードで確認でき、直接再利用できます。)
上記のデータをすべて処理した後、データを XML 形式で整理し、 POSTメソッドhttps://api.mch.weixin.qq.com/pay/unifiedorder。
3. バックエンドは WeChat サーバーから返されたデータを受け取ります

WeChat サーバーが支払いデータを受信した後、データに問題がなければ、支払いに対応するデータが返されます。非常に重要なのは、prepay_id という名前のデータフィールドです。このデータはフロントエンドに返される必要があります。フロントエンドが支払いを継続できること。

したがって、バックエンドは WeChat サーバーから戻りデータを受信した後、対応する処理を実行し、最終的に次のデータをフロントエンドに返す必要があります:

appid 言うまでもなく
timeStamp 現在のタイムスタンプ
nonceStr ランダム文字列
package は上記の prepay_id ですが、形式は "prepay_id= prepay_id_item" のようなものであることに注意してください。そうしないとエラーが発生します。
signType暗号化方式、通常はMD5である必要があります
paySignは、それに応じて上記のデータを処理し、暗号化します。

この時点で、バックエンド支払いインターフェースは、フロントエンド支払いリクエストを受信し、フロントエンド支払いに必要なデータを返す機能を完了しています。

4. フロントエンドが支払いを開始します

戻りデータを受信した後、フロントエンドは wx.requestPayment() を使用して支払いをリクエストします。この API で必要なオブジェクトパラメーターの値は、前のステップで返されたデータです。

5. バックエンドは WeChat サーバーのコールバックを受け入れます

フロントエンドが支払いを完了すると、WeChat サーバーは支払いが完了したことを確認します。最初の手順で設定したコールバックアドレスに通知が送信されます。通知を受信した後、バックエンド受信コールバックインターフェイスは、支払いが完了したかどうかを判断し、その後のアクションを決定できます。

なお、WeChatサーバーからコールバック通知を受信した後、通知のresult_codeフィールドに基づいて決済が成功したかどうかが判断されます。成功通知を受信した後、バックエンドは成功データを WeChat サーバーに返し、コールバック通知を受信したことを WeChat サーバーに通知する必要があります。そうしないと、WeChat サーバーはバックエンドにメッセージを送信し続けます。また、WeChat 通知は XML 形式で送信されるため、受信して処理する際には注意が必要です。

WeChatでの一般的な支払いプロセスは次のとおりです。以下は PHP 構文の WeChat 支払いクラスです。上記の手順を参照して理解を深めてください。支払う必要がある場合は、パラメータを直接渡してこのクラスをインスタンス化し、クラスの pay メソッドを呼び出すことができます。

//微信支付类
class WeiXinPay{
  //=======【基本信息设置】=====================================
  //微信公众号身份的唯一标识
  protected $APPID = appid;//填写您的appid。微信公众平台里的
  protected $APPSECRET = secret;
  //受理商ID，身份标识
  protected $MCHID = '11111111';//商户id
  //商户支付密钥Key
  protected $KEY = '192006250b4c09247ec02edce69f6a2d';
  //回调通知接口
  protected $APPURL =   'https://smart.afei.com/receivesuc';
  //交易类型
  protected $TRADETYPE = 'JSAPI';
  //商品类型信息
  protected $BODY = 'wx/book';
  //微信支付类的构造函数
  function __construct($openid,$outTradeNo,$totalFee){
    $this->openid = $openid; //用户唯一标识
    $this->outTradeNo = $outTradeNo; //商品编号
    $this->totalFee = $totalFee; //总价
  }
  //微信支付类向外暴露的支付接口
  public function pay(){
    $result = $this->weixinapp();
    return $result;
  }
   //对微信统一下单接口返回的支付相关数据进行处理
   private function weixinapp(){
     $unifiedorder=$this->unifiedorder();
     $parameters=array(
     'appId'=>$this->APPID,//小程序ID
     'timeStamp'=>''.time().'',//时间戳
     'nonceStr'=>$this->createNoncestr(),//随机串
     'package'=>'prepay_id='.$unifiedorder['prepay_id'],//数据包
     'signType'=>'MD5'//签名方式
       );
     $parameters['paySign']=$this->getSign($parameters);
     return $parameters;
   }
  /*
   *请求微信统一下单接口
   */
  private function unifiedorder(){
    $parameters = array(
      'appid' => $this->APPID,//小程序id
      'mch_id'=> $this->MCHID,//商户id
      'spbill_create_ip'=>$_SERVER['REMOTE_ADDR'],//终端ip
      'notify_url'=>$this->APPURL, //通知地址
      'nonce_str'=> $this->createNoncestr(),//随机字符串
      'out_trade_no'=>$this->outTradeNo,//商户订单编号
      'total_fee'=>floatval($this->totalFee), //总金额
      'open_id'=>$this->openid,//用户openid
      'trade_type'=>$this->TRADETYPE,//交易类型
      'body' =>$this->BODY, //商品信息
    );
    $parameters['sign'] = $this->getSign($parameters);
    $xmlData = $this->arrayToXml($parameters);
    $xml_result = $this->postXmlCurl($xmlData,'https://api.mch.weixin.qq.com/pay/unifiedorder',60);
    $result = $this->xmlToArray($xml_result);
    return $result;
  }
  //数组转字符串方法
  protected function arrayToXml($arr){
    $xml = "<xml>";
    foreach ($arr as $key=>$val)
    {
      if (is_numeric($val)){
        $xml.="<".$key.">".$val."</".$key.">";
      }else{
         $xml.="<".$key."><![CDATA[".$val."]]></".$key.">";
      }
    }
    $xml.="</xml>";
    return $xml;
  }
  protected function xmlToArray($xml){
    $array_data = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
    return $array_data;
  }
  //发送xml请求方法
  private static function postXmlCurl($xml, $url, $second = 30)
  {
    $ch = curl_init();
    //设置超时
    curl_setopt($ch, CURLOPT_TIMEOUT, $second);
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); //严格校验
    //设置header
    curl_setopt($ch, CURLOPT_HEADER, FALSE);
    //要求结果为字符串且输出到屏幕上
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
    //post提交方式
    curl_setopt($ch, CURLOPT_POST, TRUE);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 20);
    curl_setopt($ch, CURLOPT_TIMEOUT, 40);
    set_time_limit(0);
    //运行curl
    $data = curl_exec($ch);
    //返回结果
    if ($data) {
      curl_close($ch);
      return $data;
    } else {
      $error = curl_errno($ch);
      curl_close($ch);
      throw new WxPayException("curl出错，错误码:$error");
    }
  }
  /*
   * 对要发送到微信统一下单接口的数据进行签名
   */
  protected function getSign($Obj){
     foreach ($Obj as $k => $v){
     $Parameters[$k] = $v;
     }
     //签名步骤一：按字典序排序参数
     ksort($Parameters);
     $String = $this->formatBizQueryParaMap($Parameters, false);
     //签名步骤二：在string后加入KEY
     $String = $String."&key=".$this->KEY;
     //签名步骤三：MD5加密
     $String = md5($String);
     //签名步骤四：所有字符转为大写
     $result_ = strtoupper($String);
     return $result_;
   }
  /*
   *排序并格式化参数方法，签名时需要使用
   */
  protected function formatBizQueryParaMap($paraMap, $urlencode)
  {
    $buff = "";
    ksort($paraMap);
    foreach ($paraMap as $k => $v)
    {
      if($urlencode)
      {
        $v = urlencode($v);
      }
      //$buff .= strtolower($k) . "=" . $v . "&";
      $buff .= $k . "=" . $v . "&";
    }
    $reqPar;
    if (strlen($buff) > 0)
    {
      $reqPar = substr($buff, 0, strlen($buff)-1);
    }
    return $reqPar;
  }
  /*
   * 生成随机字符串方法
   */
  protected function createNoncestr($length = 32 ){
     $chars = "abcdefghijklmnopqrstuvwxyz0123456789";
     $str ="";
     for ( $i = 0; $i < $length; $i++ ) {
     $str.= substr($chars, mt_rand(0, strlen($chars)-1), 1);
     }
     return $str;
     }
}

上記はWeChat支払いの関連プロセスです。アイデアを明確にした後のプロセスは比較的明確でシンプルです。重要なのは、データ形式や暗号化方法など、いくつかの詳細に注意する必要があることです。

WeChat ミニプログラムの返金の具体的な実装について説明します

2. 返金

ミニプログラムの返金プロセスは支払いと似ていますが、詳細にはいくつかの違いがあります。

返金の最初のステップは通常次のとおりです:

ユーザーがフロントエンドの返金ボタンをクリックした後、バックエンドはユーザーの返金リクエストを受け取り、モールのバックエンドを通じて販売者に提示します。販売者が返金が許可されていることを確認すると、バックエンドは販売者に対して WeChat 返金インターフェイス要求を開始して返金を要求します。
バックエンドは WeChat 返金インターフェイスにリクエストを送信した後、応答情報を取得して返金が完了したかどうかを判断し、返金が完了したかどうかに基づいて注文ステータスやその他のビジネスロジックを変更します。

WeChat決済に比べて返金手順は比較的簡単です。

次の 2 つの点に注意してください:

1. WeChat 返金インターフェースから返金をリクエストした後、受け取った応答に基づいて返金が完了したかどうかを直接判断できます。 WeChat 通知を待つために特別なコールバックインターフェイスを設定する必要はありません。もちろん、必要に応じて、WeChat マーチャントプラットフォームにコールバックインターフェイスを設定して WeChat コールバックを受け入れることもできますが、これは必須ではありません。

2. 返金リクエストでは、WeChat が提供するセキュリティ証明書がリクエスト側のサーバーにインストールされている必要があります。つまり、支払いリクエストと比較して返金リクエストを開始する場合、リクエスト時にリクエストメソッドを再利用することはできません。なぜなら、WeChat の払い戻しには証明書リクエストが含まれる必要があるためです。この証明書は、WeChat 販売者アカウントの申請に成功した後に、WeChat 販売者プラットフォームからダウンロードできます。Linux での PHP 開発環境の証明書は、次の cert フォルダーに配置するだけで済みます。 Web サイトのルートディレクトリ。他の開発環境ではインポート操作が必要になる場合があります。

返金の具体的な手順は以下で説明します

1. ユーザーが返金リクエストを開始します

ユーザーがフロントエンドで返金リクエストを開始し、バックエンドが返金リクエストを受信し、対応する注文を返金申請としてマークします。販売者がそれを確認した後、返金に同意した場合、実際の返金プロセスが開始されます

2. その後、販売者は返金リクエストを開始します。販売者が返金に同意すると、バックエンドは WeChat リクエストによって提供される返金 API を開始します。

は、WeChat 支払い API をリクエストすることと同じです。また、返金リクエストは、必要なパラメータに署名し、XML で WeChat の返金 API に送信する必要があります。 https://api.mch.weixin.qq.com/pay/refund](https://api.mch.weixin.qq.com/pay/refund)

返金リクエストに必要なパラメータは次のとおりです(複数パラメータは支払い API リクエストでも使用されます):

总金额 total_fee 。订单总金额，单位为分。
退款金额 refund_fee 需要退款的金额,单位同样为分
操作员 op_user_id .与商户号相同即可
随机字符串 nonce_str 。同支付请求
签名 sign 。使用上面的所有参数进行相应处理加密生成签名。（具体处理方式与支付相同，可直接复用。）

三. 退款完成

在发起退款请求后，就可以直接根据请求的响应XML中的 result_code字段来判断退款是否成功，从而对订单状态进行处理和后续操作。不需要像支付那样等待另一个接口的通知来确定请求状态。当然如上文所说，如果需要微信服务器发送通知到后端的话，可以到微信商户平台进行设置。

退款因为流程与支付大同小异，因此退款的PHP类我选择了直接继承支付类，

代码如下，注意区分退款请求方法postXmlSSLCurl和支付请求方法postXmlCurl的区别，这也就是上文提到的退款需要的双向证书的使用。

"`
 class WinXinRefund extends WeiXinPay{
  protected \$SSLCERT_PATH = &#39;cert/apiclient_cert.pem&#39;;//证书路径
  protected \$SSLKEY_PATH = &#39;cert/apiclient_key.pem&#39;;//证书路径
  protected \$opUserId = &#39;1234567899&#39;;//商户号
function __construct($openid,$outTradeNo,$totalFee,$outRefundNo,$refundFee){
  //初始化退款类需要的变量
  $this->openid = $openid;
  $this->outTradeNo = $outTradeNo;
  $this->totalFee = $totalFee;
  $this->outRefundNo = $outRefundNo;
  $this->refundFee = $refundFee;
} 
public function refund(){
  //对外暴露的退款接口
  $result = $this->wxrefundapi();
  return $result;
}
private function wxrefundapi(){
  //通过微信api进行退款流程
  $parma = array(
    'appid'=> $this->APPID,
    'mch_id'=> $this->MCHID,
    'nonce_str'=> $this->createNoncestr(),
    'out_refund_no'=> $this->outRefundNo,
    'out_trade_no'=> $this->outTradeNo,
    'total_fee'=> $this->totalFee,
    'refund_fee'=> $this->refundFee,
    'op_user_id' => $this->opUserId,
  );
  $parma['sign'] = $this->getSign($parma);
  $xmldata = $this->arrayToXml($parma);
  $xmlresult = $this->postXmlSSLCurl($xmldata,'https://api.mch.weixin.qq.com/secapi/pay/refund');
  $result = $this->xmlToArray($xmlresult);
  return $result;
}
//需要使用证书的请求
function postXmlSSLCurl($xml,$url,$second=30)
{
  $ch = curl_init();
  //超时时间
  curl_setopt($ch,CURLOPT_TIMEOUT,$second);
  //这里设置代理，如果有的话
  //curl_setopt($ch,CURLOPT_PROXY, '8.8.8.8');
  //curl_setopt($ch,CURLOPT_PROXYPORT, 8080);
  curl_setopt($ch,CURLOPT_URL, $url);
  curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE);
  curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE);
  //设置header
  curl_setopt($ch,CURLOPT_HEADER,FALSE);
  //要求结果为字符串且输出到屏幕上
  curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE);
  //设置证书
  //使用证书：cert 与 key 分别属于两个.pem文件
  //默认格式为PEM，可以注释
  curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM');
  curl_setopt($ch,CURLOPT_SSLCERT, $this->SSLCERT_PATH);
  //默认格式为PEM，可以注释
  curl_setopt($ch,CURLOPT_SSLKEYTYPE,'PEM');
  curl_setopt($ch,CURLOPT_SSLKEY, $this->SSLKEY_PATH);
  //post提交方式
  curl_setopt($ch,CURLOPT_POST, true);
  curl_setopt($ch,CURLOPT_POSTFIELDS,$xml);
  $data = curl_exec($ch);
  //返回结果
  if($data){
    curl_close($ch);
    return $data;
  }
  else {
    $error = curl_errno($ch);
    echo "curl出错，错误码:$error"."<br>";
    curl_close($ch);
    return false;
  }
}}

三. 总结

以上就是关于微信支付和退款的流程及相关知识的介绍。文中的 PHP类均封装直接可用。

因为微信支付和退款涉及的东西较为繁杂，很多人直接看官方文档可能会一头雾水，所以看过此文了解流程和要点后，再去看微信官方文档。一方面可以更清晰的了解小程序的支付和退款流程。另一方面，本文因为篇幅有限及作者能力有限，肯定有无暇顾及或有所纰漏之处。为求稳妥，还是需要多看看官方开发文档。毕竟事涉支付，出个BUG可不是小事。
最后扯点闲话吧。这篇博客本来应该在三个月前就发表的，也算当时我从一无所知到独立完成微信小程序商城前后端的总结系列的第一篇。但是公司突然出现人员和项目的变动，导致管理和项目上都混乱不堪，再加上个人的惰性，导致此篇博客一直拖到三个月后的今天才断断续续写完。这三个月我的心态因为各种事起起伏伏，也颇有一番风味。

WeChat ミニ プログラムの支払いと返金のプロセス例の共有

関連記事

WeChat ミニプログラムの支払いと返金のプロセス例の共有