집 >위챗 애플릿 >미니 프로그램 개발 >PHP로 WeChat 애플릿 결제 및 환불을 구현하는 방법
PHP로 WeChat 애플릿 결제 및 환불을 구현하는 방법
- 小云云원래의
- 2018-05-19 16:52:049986검색
WeChat 미니 프로그램 결제의 주요 로직은 백엔드에 집중되어 있습니다. 프런트엔드는 백엔드 인터페이스를 요청하기 위해 결제에 필요한 데이터만 갖고 반환된 내용에 따라 해당 성공 또는 실패를 처리하면 됩니다. 결과. 이 기사의 백엔드는 PHP를 사용하여 전체 결제 프로세스와 일부 세부 사항에 중점을 둡니다. 따라서 다른 백엔드 언어를 사용하는 친구들은 필요하다면 살펴볼 수 있습니다. 많은 경우, 개발 요구 사항과 그에 따른 문제 해결 방법은 실제로 언어 문법 수준을 넘어 시스템과 프로세스의 관점에서 고려되어야 합니다.
1. 결제
결제는 주로 여러 단계로 나뉩니다.
프런트엔드는 결제 요청을 시작하기 위해 결제에 필요한 데이터(상품 ID, 구매 수량 등)를 전달합니다.
백엔드는 결제 요청 시 결제 데이터를 처리한 후 처리된 데이터를 가지고 WeChat 서버의 결제 통합 주문 인터페이스를 요청합니다
백엔드는 이전 요청의 반환 데이터를 WeChat 서버로 수신하여 다시 처리합니다. 를 누른 후 프런트엔드로 돌아가서 프런트엔드에서 결제를 시작할 수 있도록 합니다.
프런트엔드가 결제 작업을 수행합니다
프런트엔드 결제가 완료된 후 WeChat 서버는 백엔드에 결제 알림을 보냅니다(즉, WeChat은 고객이 결제했음을 알리고 싶어합니다) ), 백엔드는 이 알림을 기반으로 결제가 완료된 것으로 판단하고, 결제가 완료된 후 주문 상태 수정, 거래 로그 추가 등 해당 조치를 취합니다.
위 단계를 보면 백엔드의 주요 기능은 결제에 필요한 데이터를 위챗 서버로 전송하고, 위챗 서버의 응답에 따라 결제 완료 여부를 판단하는 것임을 알 수 있습니다.
이 과정은 이해하기 매우 쉽습니다. 비유적으로 말하면 프런트 엔드는 고객이고 백엔드는 매장이며 WeChat 서버의 통합 주문 인터페이스는 계산원과 같습니다. 고객은 내가 누구인지 매장에 알려주고 이제 나는 당신에게 이것저것 사주고 싶은 만큼 돈을 지불해야 합니다. 가게 주인은 계산원에게 “누구누구는 얼마를 내야 합니까? 돈을 받을 준비를 하세요”라고 말했다. 계산원은 돈을 받은 뒤 매장으로 가서 "돈 받았으니 뭐 좀 주세요"라고 말했다.
각 단계의 구체적인 구현 방법은 아래에서 자세히 설명하겠습니다.
1. 프론트엔드 결제 요청
프론트엔드 결제 요청은 단순히 사용자 ID, 결제 금액, 결제 주문 ID 등 결제에 필요한 데이터를 전달합니다. **귀하의 비즈니스 로직과 관련됩니다. ** 또는
**다음 단계는 통합 주문 인터페이스에 필요한 데이터에 대한 비용을 지불하도록 WeChat 서버에 요청하는 것입니다**. WeChat 애플릿의 wx.request()를 사용하여 백엔드 결제 인터페이스를 요청합니다.
2. 백엔드는 위챗 서버에 요청합니다
백엔드는 프런트엔드에서 보낸 결제 요청을 받은 후 사용자에게 문제가 있는지, 결제 금액이 맞는지 확인하는 등 관련 확인을 수행할 수 있습니다. 등.
문제가 없고 WeChat 서버에 결제를 신청할 수 있음을 확인한 후 백엔드에서 WeChat에서 지정한 데이터 형식을 사용하여 WeChat의 통합 결제 주문 인터페이스를 요청해야 합니다.
WeChat에서 지정한 요청 데이터:
이를 구현하려면 더 많은 코드가 필요합니다. 필요한 데이터의 양이 많고 XML로 암호화하여 저장해야 하기 때문에
보낼 수 있는 형식입니다.
먼저 다음 데이터는 미니 프로그램을 사용하여 결제할 때 위챗 서버에 제공해야 하는 매개변수입니다.
미니 프로그램 앱입니다. 아마 작은 프로그램을 작성하는 사람 중에 이것을 모르는 사람은 없을 것입니다. . .
사용자 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 메서드를 사용하여 위챗 결제 통합 주문 인터페이스로 보냅니다.
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 서버는 결제가 완료되었음을 확인합니다. 첫 번째 단계에서 설정한 콜백 주소로 알림이 전송됩니다. 알림을 받은 후 백엔드 수신 콜백 인터페이스는 결제 완료 여부를 확인하고 후속 조치를 결정할 수 있습니다.
위챗 서버로부터 콜백 알림을 받은 후 알림의 result_code 필드를 기준으로 결제 성공 여부를 판단한다는 점에 유의하세요. 성공적인 알림을 받은 후 백엔드는 WeChat 서버에 성공 데이터를 반환하여 콜백 알림이 수신되었음을 WeChat 서버에 알려야 합니다. 그렇지 않으면 WeChat 서버가 백엔드로 계속 메시지를 보냅니다. 또한, WeChat 알림은 XML 형식으로 전송되므로 이를 수락하고 처리할 때 주의가 필요합니다.
위챗의 일반적인 결제 과정은 이렇습니다. 다음은 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;
}
}위는 위챗 결제 관련 과정입니다. 아이디어를 명확히 한 후의 과정은 비교적 명확하고 간단합니다. 요점은 데이터 형식, 암호화 방법 등과 같은 일부 세부 사항에 주의를 기울여야 한다는 것입니다.
위챗 미니 프로그램 환불의 구체적인 구현에 대해 이야기해보겠습니다
2. 환불
미니 프로그램 환불 과정은 결제 과정과 유사하지만, 세부적으로 약간의 차이가 있습니다.
환불의 첫 번째 단계는 일반적으로 다음과 같습니다.
사용자가 프런트엔드에서 환불 버튼을 클릭한 후 백엔드는 사용자의 환불 요청을 수신하고 판매자가 이를 확인한 후 쇼핑몰 백엔드를 통해 판매자에게 전달합니다. 환불이 허용되면 백엔드는 환불을 요청하기 위해 WeChat API 요청에 환불을 시작합니다.
백엔드가 WeChat 환불 인터페이스에 요청을 보낸 후 응답 정보를 얻고 환불 완료 여부를 확인한 다음 환불 완료 여부에 따라 주문 상태 및 기타 비즈니스 로직을 변경합니다.
환불 절차는 위챗 결제에 비해 상대적으로 간단합니다.
다음 두 가지 사항에 주목할 필요가 있습니다.
1. WeChat 환불 인터페이스에서 환불을 요청한 후 받은 응답을 바탕으로 환불이 완료되었는지 직접 확인할 수 있습니다. WeChat 알림을 기다리기 위해 특별한 콜백 인터페이스를 설정할 필요가 없습니다. 물론 필요한 경우 WeChat 판매자 플랫폼에 콜백 인터페이스를 설정하여 WeChat 콜백을 수락할 수도 있지만 반드시 그럴 필요는 없습니다.
2. 환불 요청을 하려면 요청 서버에 WeChat에서 제공한 보안 인증서가 설치되어 있어야 합니다. 즉, 결제 요청과 비교하여 환불 요청을 시작할 때는 요청 시 요청 방법을 재사용할 수 없습니다. , WeChat 환불에는 인증서 요청이 필요하기 때문입니다. 이 인증서는 WeChat 판매자 계정을 성공적으로 신청한 후 WeChat 판매자 플랫폼에서 다운로드할 수 있습니다. Linux에서 PHP 개발 환경에 대한 인증서는 다음의 cert 폴더에 있어야 합니다. 웹사이트의 루트 디렉토리. 다른 개발 환경에서는 가져오기 작업이 필요할 수 있습니다.
환불에 대한 구체적인 단계는 아래에 설명되어 있습니다
1. 사용자가 환불 요청을 시작합니다
사용자가 프런트엔드에서 환불 요청을 시작하면 백엔드에서 환불 요청을 받아 해당 주문을 환불 신청으로 표시하고 이를 확인한 후 판매자가 해당 주문을 수행합니다. 그래야만 실제 환불 프로세스가 시작됩니다.
2. 판매자가 환불 요청을 시작합니다
판매자가 환불에 동의한 후 백엔드는 제공된 환불 API에 요청을 시작합니다. by WeChat.
환불 요청에도 필수 매개변수가 필요합니다. 서명 후 XML로 WeChat 환불 API에 보냅니다.
환불 요청에 필요한 매개변수는 다음과 같습니다. 매개변수는 결제 API 요청에도 사용됩니다.):
Mini 프로그램 appid.
판매자 번호 mch_id. WeChat 결제 판매자 인증을 성공적으로 신청하면 WeChat에서 보낸 이메일에
판매자 주문 번호 out_trade_no가 포함됩니다. 환불주문 결제시 생성되는 주문번호
환불주문번호 out_refund_no. 동일한 환불 주문 번호가 여러 개 있으면 한 번만 환불되므로 백엔드에서 생성된 환불 주문 번호는 고유해야 합니다.
총액 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 중국어 웹사이트의 기타 관련 기사를 참조하세요!