WeChat 支払いと返金プロセスの PHP 実装の例
WeChat ミニ プログラム支払いのメイン ロジックが集中していますバックエンドでは、フロントエンドは支払いに必要なデータを送信してバックエンド インターフェイスをリクエストし、返された結果に基づいて対応する成功または失敗を処理するだけで済みます。この記事のバックエンドでは PHP が使用されており、支払いプロセス全体といくつかの詳細に焦点を当てています。したがって、他のバックエンド言語を使用している友人は、必要に応じて見てみることができます。多くの場合、開発ニーズとそれに対応する問題解決策は、実際には言語構文レベルを超えて、システムとプロセスの観点から検討する必要があります。
1. WeChat 支払い
支払いは主にいくつかのステップに分かれています:
フロントエンドは支払いに必要なデータ (製品 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 形式で整理し、次を使用して WeChat 支払いの統合注文インターフェイスに送信します。 POST メソッド3. バックエンドは WeChat サーバーから返されたデータを受け取ります WeChat サーバーが支払いデータを受信した後、データに問題がなければ、対応するデータを返します支払い用のデータ。最も重要なのは prepay_id という名前です。フロント エンドが支払いを続行するには、データ フィールドをフロント エンドに返す必要があります。 したがって、バックエンドは WeChat サーバーから戻りデータを受信した後、対応する処理を実行し、最終的に次のデータをフロントエンドに返す必要があります: appid 不要さらに詳しく言うには タイムスタンプ 現在のタイムスタンプ
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 メソッドを呼び出すことができます。
//WeChat 支払いクラス
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 返金インターフェイスにリクエストを送信した後、応答情報を取得し、返金が完了したかどうかを判断し、返金が完了したかどうかに基づいて注文ステータスやその他のビジネス ロジックを変更します。
返金手順はWeChat決済に比べて比較的簡単です。
次の 2 つの点に注意してください:
1. WeChat 返金インターフェースから返金をリクエストした後、受け取った応答に基づいて返金が完了したかどうかを直接判断できます。 WeChat 通知を待つために特別なコールバック インターフェイスを設定する必要はありません。もちろん、必要に応じて、WeChat マーチャント プラットフォームにコールバック インターフェイスを設定して WeChat コールバックを受け入れることもできますが、これは必須ではありません。
2. 返金リクエストには、WeChat が提供するセキュリティ証明書がリクエスト側のサーバーにインストールされている必要があります。つまり、支払いリクエストと比較して返金リクエストを開始する場合、リクエスト メソッドは実行中に再利用できません。 WeChat の払い戻しには証明書が必要なため、要求に応じて、WeChat 販売アカウントの申請に成功した後、この証明書を WeChat 販売プラットフォームからダウンロードできます。Linux での PHP 開発環境の証明書は、証明書に配置するだけで済みます。 Web サイトのルート ディレクトリにあるフォルダー。他の開発環境ではインポート操作が必要になる場合があります。
以下では、返金の具体的な手順について説明します
1. ユーザーが返金リクエストを開始します
ユーザーがフロントエンドで返金リクエストを開始し、バックエンドがそれを受け取ります。返金リクエストと対応する注文は返金申請中としてマークされ、バックグラウンドで表示されます。加盟店がそれを確認した後、返金に同意した場合は、対応する操作が続行されます。その後、実際の返金プロセスに入ります。 .
2. 販売者は返金リクエストを開始します
販売者が返金に同意した後、バックエンドは WeChat が提供する返金 API へのリクエストを開始します。 WeChat 支払い API のリクエストと同じです。返金リクエストでは、必要なパラメータに署名し、XML 返金 API で WeChat に送信する必要もあります。
返金リクエストに必要なパラメータは次のとおりです (複数のパラメータも必要です)支払い API リクエストで使用されます):
パラメータ:
appid
mch_id 販売者番号。 WeChat 支払い加盟店認定の申請に成功すると、WeChat から送信される電子メールには、
out_trade_no 加盟店注文番号が含まれます。返金注文の支払い時に生成される注文番号
out_refund_no 返金注文番号。複数の同一の返金注文番号は 1 回しか返金しないため、バックエンドによって生成される返金注文番号は一意である必要があります。
total_fee 合計金額。注文の合計金額 (セント単位)。
refund_fee 返金金額。返金される金額。単位も分です。
op_user_id 演算子。販売者番号
nonce_str ランダム文字列と同じにすることもできます。支払いリクエストの
署名と同じ。上記のすべてのパラメータを使用して暗号化を処理し、それに応じて署名を生成します。 (具体的な処理方法は支払いと同じで、直接再利用できます。)
注: インスタンス化中にキー (秘密キー) パラメーターを渡さなかったため、署名エラーが発生し続けました。
三. 退款完成
在发起退款请求后,就可以直接根据请求的响应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视频教程》
以上がWeChatの決済・返金処理をPHPで実装した事例を詳しく解説の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。