위챗 미니 프로그램 결제 및 환불 처리 예시 공유
- 小云云원래의
- 2018-01-05 13:15:353220검색
먼저 WeChat 미니 프로그램 결제의 주요 로직이 백엔드에 집중되어 있다는 점을 설명하겠습니다. 프런트엔드는 결제에 필요한 데이터만 가지고 백엔드 인터페이스를 요청한 후 이에 따라 해당 성공 또는 실패를 처리하면 됩니다. 결과를 반환했습니다. 저는 백엔드에서 PHP를 사용합니다. 물론 이 블로그에서는 특정 결제 구현을 설명하기 위해 많은 코드를 게시하지 않고 주로 전체 결제 프로세스와 일부 세부 사항에 중점을 둘 것입니다. 따라서 다른 백엔드 언어를 사용하는 친구들은 필요하다면 살펴볼 수 있습니다. 많은 경우, 개발 요구 사항과 그에 따른 문제 해결 방법은 실제로 언어 문법 수준을 넘어 시스템과 프로세스의 관점에서 고려되어야 합니다. 요점을 파악하세요.
1. 결제
결제는 주로 여러 단계로 나뉩니다.
프런트엔드는 결제 요청을 시작하기 위해 결제에 필요한 데이터(상품 ID, 구매 수량 등)를 전달합니다. 결제 요청을 받은 백엔드는 결제 데이터를 처리한 후 처리된 데이터를 운반하여 위챗 서버의 결제 통합 주문 인터페이스를 요청합니다
백엔드는 위챗 서버를 요청한 이전 단계의 반환 데이터를 받습니다. , 다시 처리한 후 프런트엔드에서 결제를 시작할 수 있도록 프런트엔드로 돌아갑니다.
프런트엔드에서 결제 작업을 수행합니다
프런트엔드 결제가 완료된 후 WeChat 서버가 백엔드에 결제 알림을 보냅니다. 고객이 결제함), 백엔드는 이 완료 알림을 기반으로 결제를 결정하고, 결제가 완료된 후 주문 상태 수정, 거래 로그 추가 등 해당 조치를 취합니다.
-
이 단계를 보면 백엔드의 주요 기능은 결제에 필요한 데이터를 위챗 서버로 전송하고, 위챗 서버의 응답에 따라 결제 완료 여부를 판단하는 것임을 알 수 있습니다.
이 과정은 이해하기 매우 쉽습니다. 비유적으로 말하면 프런트 엔드는 고객이고 백엔드는 매장이며 WeChat 서버의 통합 주문 인터페이스는 계산원과 같습니다. 고객은 내가 누구인지 매장에 알려주고 이제 나는 당신에게 이것저것 사주고 싶은 만큼 돈을 지불해야 합니다. 가게 주인은 계산원에게 “누구누구는 얼마를 내야 합니까? 돈을 받을 준비를 하세요”라고 말했다. 계산원은 돈을 받은 뒤 매장으로 가서 "돈 받았으니 뭐 좀 주세요"라고 말했다. 각 단계의 구체적인 구현 방법은 아래에서 자세히 설명하겠습니다.
1. 프론트엔드 결제 요청
프론트엔드 결제 요청은 단순히 사용자 ID, 결제 금액, 결제 주문 ID 등 결제에 필요한 데이터를 전달합니다. **귀하의 비즈니스 로직과 관련됩니다. ** 또는 다음 단계로 WeChat 서버 결제 통합 주문 인터페이스에서 요구하는 ** 관련 데이터를 요청하려면 WeChat 애플릿의 wx.request()를 사용하여 백엔드 결제 인터페이스를 요청하세요.
2. 백엔드는 위챗 서버에 요청합니다
백엔드는 프런트엔드에서 보낸 결제 요청을 받은 후 사용자에게 문제가 있는지, 결제 금액이 맞는지 확인하는 등 관련 확인을 수행할 수 있습니다. 등.
WeChat에서 지정한 요청 데이터:
이를 구현하려면 더 많은 코드가 필요합니다. 필요한 데이터의 양이 많기 때문에 암호화하여 XML 형식으로 전송해야 합니다.
미니 프로그램 앱ID. 아마 작은 프로그램을 작성하는 사람 중에 이것을 모르는 사람은 없을 것입니다. . .
- 사용자 ID openid. 그것이 사용자의 미니 프로그램 ID입니다. 얻는 방법은 지난 블로그에서 설명했습니다.
- 판매자 번호 mch_id. WeChat 결제 판매자 인증을 성공적으로 신청하면 WeChat에서 보낸 이메일에 판매자 주문 번호 out_trade_no가 포함됩니다. 이 결제에 대해 판매자가 생성한 주문 번호
- 총액 total_fee. 주문 총액, 매우 중요한 점은 단위가 센트이므로 특히 주의하시기 바랍니다.
- WeChat 서버 콜백 알림 인터페이스 주소 inform_url. WeChat에서 금액이 도착했음을 확인한 후 고객이 지불했음을 알리는 여러 메시지를 이 주소로 보냅니다. 알림을 받았음을 알리는 메시지를 WeChat에 반환해야 합니다. . 이 주소는 포트 번호를 가질 수 없으며 POST 메서드 요청을 직접 수락할 수 있어야 합니다.
- 거래 유형 trade_type . WeChat 애플릿 결제 값은 JSAPI
- 상품 정보 본문으로 통일됩니다. "Tencent-Game"
- 단말기 IP 주소 spbill_create_ip 형식과 유사합니다. 단말기 주소 IP, 결제를 요청하는 IP 주소입니다.
- 임의 문자열 nonce_str . 데이터 보안을 보장하려면 백엔드에서 무작위로 생성된 문자열이 필요합니다. WeChat에는 32비트 이상이 필요하지 않습니다.
- 서명. 위의 모든 매개변수를 사용하여 암호화를 처리하고 그에 따라 서명을 생성합니다. (구체적인 처리 방법은 아래 코드에서 확인할 수 있으며 직접 재사용할 수 있습니다.)
위의 데이터를 모두 처리한 후 데이터를 XML 형식으로 구성하고 WeChat 결제 통합 주문 인터페이스 https: // api.mch.weixin.qq.com/pay/unifiedorder를 사용합니다.
3. 백엔드는 WeChat 서버에서 반환된 데이터를 받아들입니다-
WeChat 서버는 결제 데이터를 수신한 후 데이터에 문제가 없으면 결제를 위해 해당 데이터를 반환합니다. 매우 중요한 것은 prepay_id라는 데이터 필드입니다. 프런트 엔드에서 계속 비용을 지불할 수 있습니다.
따라서 백엔드는 WeChat 서버로부터 반환 데이터를 받은 후 해당 처리를 수행하고 마지막으로 다음 데이터를 프런트엔드에 반환해야 합니다.
- nonceStr 무작위 문자열
- package는 위에서 언급한 prepay_id이지만 형식은 "prepay_id= prepay_id_item"과 같다는 것을 기억하세요. 그렇지 않으면 오류가 발생합니다.
- signType 암호화 방법은 일반적으로 MD5
- paySign에서 위 데이터를 그에 따라 처리하고 암호화해야 합니다.
- 이 시점에서 백엔드 결제 인터페이스에서는 선불 결제 요청을 수신하고 선불 결제에 필요한 데이터를 반환하는 기능이 완료되었습니다. 4. 프런트 엔드가 결제를 시작합니다
- 반환 데이터를 받은 후 프런트 엔드는 wx.requestPayment()를 사용하여 결제를 요청합니다. 이 API에 필요한 객체 매개변수의 값은 이전 단계에서 반환된 데이터입니다.
5. 백엔드는 WeChat 서버 콜백을 허용합니다 프런트엔드가 결제를 완료한 후 WeChat 서버는 결제가 완료되었음을 확인합니다. 첫 번째 단계에서 설정한 콜백 주소로 알림이 전송됩니다. 알림을 받은 후 백엔드 수신 콜백 인터페이스는 결제 완료 여부를 확인하고 후속 조치를 결정할 수 있습니다.
위챗 서버로부터 콜백 알림을 받은 후 알림의 result_code 필드를 기준으로 결제 성공 여부를 판단한다는 점에 유의하세요. 성공적인 알림을 받은 후 백엔드는 WeChat 서버에 성공 데이터를 반환하여 콜백 알림이 수신되었음을 WeChat 서버에 알려야 합니다. 그렇지 않으면 WeChat 서버가 백엔드로 계속 메시지를 보냅니다. 또한, WeChat 알림은 XML 형식으로 전송되므로 이를 수락하고 처리할 때 주의가 필요합니다.
위챗의 일반적인 결제 과정은 이렇습니다. 다음은 PHP 구문의 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 미니 프로그램 환불의 구체적인 구현에 대해 이야기해보겠습니다
2. Refund
미니 프로그램 환불 과정은 결제 과정과 유사하지만 세부 사항에 약간의 차이가 있습니다.
환불의 첫 번째 단계는 일반적으로 다음과 같습니다.
사용자가 프런트엔드에서 환불 버튼을 클릭한 후 백엔드는 사용자의 환불 요청을 수신하고 이를 쇼핑몰 백엔드를 통해 판매자에게 전달합니다. 판매자는 환불이 허용됨을 확인하고 백엔드는 판매자에게 환불을 요청하는 WeChat 환불 인터페이스 요청을 시작합니다.
백엔드가 WeChat 환불 인터페이스에 요청을 보낸 후 응답 정보를 받아 환불 완료 여부를 확인한 다음, 환불 완료 여부에 따라 주문 상태 및 기타 비즈니스 로직을 변경합니다.
- 환불 절차는 위챗 결제에 비해 상대적으로 간단합니다. 다음 두 가지 사항에 주목할 필요가 있습니다.
- 1. WeChat 환불 인터페이스에서 환불을 요청한 후 받은 응답을 바탕으로 환불이 완료되었는지 직접 확인할 수 있습니다. WeChat 알림을 기다리기 위해 특별한 콜백 인터페이스를 설정할 필요가 없습니다. 물론 필요한 경우 WeChat 판매자 플랫폼에 콜백 인터페이스를 설정하여 WeChat 콜백을 수락할 수도 있지만 반드시 그럴 필요는 없습니다.
2. 환불 요청을 하려면 요청 서버에 WeChat에서 제공한 보안 인증서가 설치되어 있어야 합니다. 즉, 결제 요청과 비교하여 환불 요청을 시작할 때는 요청 시 요청 방법을 재사용할 수 없습니다. , WeChat 환불에는 인증서 요청이 필요하기 때문입니다. 이 인증서는 WeChat 판매자 계정을 성공적으로 신청한 후 WeChat 판매자 플랫폼에서 다운로드할 수 있습니다. Linux에서 PHP 개발 환경에 대한 인증서는 다음의 cert 폴더에 있어야 합니다. 웹사이트의 루트 디렉토리. 다른 개발 환경에서는 가져오기 작업이 필요할 수 있습니다.
는 WeChat 결제 API를 요청하는 것과 동일합니다. 환불 요청도 필수 매개변수에 서명하여 XML로 WeChat 환불 API로 보내야 합니다. /api.mch.weixin.qq.com/pay/refund](https://api.mch.weixin.qq.com/pay/refund)
2. 판매자가 동의한 후 환불이 진행됩니다. 환불을 위해 백엔드는 WeChat 요청에서 제공하는 환불 API를 시작합니다.환불 요청에 필요한 매개변수는 다음과 같습니다. (여러 매개변수도 결제 API 요청에 사용됨):
Mini 프로그램 appid.
판매자 번호 mch_id. WeChat 결제 판매자 인증을 성공적으로 신청하면 WeChat에서 보낸 이메일에 판매자 주문 번호 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可不是小事。
最后扯点闲话吧。这篇博客本来应该在三个月前就发表的，也算当时我从一无所知到独立完成微信小程序商城前后端的总结系列的第一篇。但是公司突然出现人员和项目的变动，导致管理和项目上都混乱不堪，再加上个人的惰性，导致此篇博客一直拖到三个月后的今天才断断续续写完。这三个月我的心态因为各种事起起伏伏，也颇有一番风味。
相关推荐：
위 내용은 위챗 미니 프로그램 결제 및 환불 처리 예시 공유의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!