最近WeChatミニプログラムに取り組んでいたときに、ミニプログラムの支払いと返金のプロセスが含まれていたので、この点について簡単に読んでこの記事にまとめました
まず最初に、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 メソッドを使用して WeChat 支払い統合注文インターフェイス https://api.mch.weixin.qq.com/pay/unifiedorder に送信します。
3. バックエンドは WeChat サーバーから返されたデータを受け取ります
WeChat サーバーが支払いデータを受信した後、データに問題がなければ、対応する支払いデータを返します。 1 つは 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. ユーザーが返金リクエストを開始します
ユーザーはフロントエンドで返金リクエストを開始し、バックエンドは返金リクエストを受信してマークを付けます対応する注文が返金申請としてバックグラウンドで表示され、販売者が返金に同意した場合のみ、実際の返金プロセスが開始されます。販売者が返金リクエストを開始します
販売者が返金に同意した後、バックエンドは WeChat が提供する返金 API へのリクエストを開始します。
同请求微信支付API一样.退款请求也需要将需要的参数进行签名后以XML发送到微信的退款API [https://api.mch.weixin.qq.com/pay/refund](https://api.mch.weixin.qq.com/pay/refund)
退款请求需要的参数如下(多个参数在支付API请求时也有使用):
小程序 appid。
商户号 mch_id 。申请开通微信支付商户认证成功后微信发给你的邮件里有
商户订单号 out_trade_no 。退款订单在支付时生成的订单号
退款订单号 out_refund_no 。由后端生成的退款单号，需要保证唯一，因为多个同样的退款单号只会退款一次。
总金额 total_fee 。订单总金额，单位为分。
退款金额 refund_fee 需要退款的金额,单位同样为分
操作员 op_user_id .与商户号相同即可
随机字符串 nonce_str 。同支付请求
签名 sign 。使用上面的所有参数进行相应处理加密生成签名。（具体处理方式与支付相同，可直接复用。）
三. 退款完成
在发起退款请求后，就可以直接根据请求的响应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可不是小事。
最后扯点闲话吧。这篇博客本来应该在三个月前就发表的，也算当时我从一无所知到独立完成微信小程序商城前后端的总结系列的第一篇。但是公司突然出现人员和项目的变动，导致管理和项目上都混乱不堪，再加上个人的惰性，导致此篇博客一直拖到三个月后的今天才断断续续写完。这三个月我的心态因为各种事起起伏伏，也颇有一番风味。
上面是我整理给大家的，希望今后会对大家有帮助。
相关文章：
以上がWeChatミニプログラムでの支払いと返金の実装方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。
![[Web フロントエンド] Node.js クイック スタート](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
