PHP で WeChat アプレットの支払いと返金を実装する方法

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

1. 支払い

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

フロントエンドは支払いリクエストを開始するために支払いに必要なデータを運びます

支払いリクエストが行われると、バックエンドは支払いデータを処理し、処理されたデータを 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サーバーコールバック通知インターフェースアドレス 通知URL。 WeChat がお金の到着を確認すると、このアドレスに複数のメッセージが送信され、顧客が支払いを行ったことを通知します。通知を受け取ったことを示すメッセージを WeChat に返信する必要があります。 。このアドレスにはポート番号を含めることはできず、POST メソッド要求を直接受け入れることができる必要があります。

取引タイプ trade_type 。 WeChatアプレットの支払い額はJSAPI

商品情報本文として統一されています。 「Tencent-Game」

端末のIPアドレスspbill_create_ipの形式に似ています。端末アドレス IP。支払いを要求する IP アドレスです。

ランダムな文字列 nonce_str 。データのセキュリティを確保するには、バックエンドによってランダムに生成された文字列が必要です。 WeChat には 32 ビット以下が必要です。

署名サイン。上記のすべてのパラメータを使用して暗号化を処理し、それに応じて署名を生成します。 (具体的な処理方法は以下のコードで確認でき、直接再利用できます。)

上記のデータをすべて処理した後、データを XML 形式に整理し、POST メソッドを使用して WeChat 決済の統合注文インターフェイスに送信します。

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, &#39;SimpleXMLElement&#39;, 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 API リクエストへの払い戻しを開始して払い戻しを要求します。

バックエンドが WeChat 返金インターフェイスにリクエストを送信した後、応答情報を取得し、返金が完了したかどうかを判断し、返金が完了したかどうかに基づいて注文ステータスやその他のビジネス ロジックを変更します。

返金の手順はWeChat支払いに比べて比較的簡単です。

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

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

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

返金の具体的な手順は以下で説明されています

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

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

2. 販売者は返金リクエストを開始します

販売者が返金に同意した後、バックエンドは返金リクエストを開始します。 WeChatが提供するAPI

WeChat決済APIのリクエストと同じです。返金リクエストにも必要なパラメータが必要です。署名後、WeChatの返金APIにXMLで送信します
返金リクエストに必要なパラメータは次のとおりです。 (支払い API リクエストでは複数のパラメーターも使用されます):

ミニ プログラム appid。

販売者番号 mch_id。 WeChat 支払い加盟店認定の申請が完了すると、WeChat から送信されるメールには

加盟店注文番号 out_trade_no が含まれます。払い戻し注文の支払い時に生成される注文番号

払い戻し注文番号 out_refund_no。複数の同一の返金注文番号は 1 回しか返金しないため、バックエンドによって生成される返金注文番号は一意である必要があります。

合計金額 total_fee.注文の合計金額 (セント単位)。

返金金額refund_fee 返金される金額、単位も分です

演算子op_user_idは販売者番号と同じにすることができます

ランダムな文字列nonce_str。支払いリクエスト

の署名と同じです。上記のすべてのパラメータを使用して暗号化を処理し、それに応じて署名を生成します。 (具体的な処理方法はお支払いと同じで、そのまま再利用可能です。)

3. 返金完了

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

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

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

````
 class WinXinRefund extends WeiXinPay{
  protected \$SSLCERT_PATH = 'cert/apiclient_cert.pem';//证书路径
  protected \$SSLKEY_PATH = 'cert/apiclient_key.pem';//证书路径
  protected \$opUserId = '1234567899';//商户号
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可不是小事。

以上内容就是关于php如何实现微信小程序支付和退款功能，相信php程序员也有了一定的思路，希望能帮助到大家。

相关推荐：

微信小程序机器人自动客服功能

微信小程序如何实现图片放大预览功能

微信小程序开发入门实例

微信小程序分享时可自定义配图新功能

最全的微信小程序项目实例

以上がPHP で WeChat アプレットの支払いと返金を実装する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。