PHP로 WeChat 결제 및 환불 프로세스를 구현한 사례에 대한 자세한 설명

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에서 지정한 데이터 요청:

이를 구현하려면 더 많은 코드가 필요합니다. 필요한 데이터의 양이 많기 때문에 암호화하여 XML 형식으로 전송해야 합니다.

먼저 다음 데이터는 미니 프로그램을 사용하여 결제할 때 위챗 서버에 제공해야 하는 매개변수입니다.

미니 프로그램 앱입니다. 아마 작은 프로그램을 작성하는 사람 중에 이것을 모르는 사람은 없을 것입니다. . .

사용자 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 형식으로 구성하고 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 서버는 결제가 완료되었음을 확인합니다. 첫 번째 단계에서 설정한 콜백 주소로 알림이 전송됩니다. 알림을 받은 후 백엔드 수신 콜백 인터페이스는 결제 완료 여부를 확인하고 후속 조치를 결정할 수 있습니다.

위챗 서버로부터 콜백 알림을 받은 후 알림의 result_code 필드를 기준으로 결제 성공 여부를 판단한다는 점에 유의하세요. 성공적인 알림을 받은 후 백엔드는 WeChat 서버에 성공 데이터를 반환하여 콜백 알림이 수신되었음을 WeChat 서버에 알려야 합니다. 그렇지 않으면 WeChat 서버가 백엔드로 계속 메시지를 보냅니다. 또한, WeChat 알림은 XML 형식으로 전송되므로 이를 수락하고 처리할 때 주의가 필요합니다.

위챗의 일반적인 결제 과정은 이렇습니다. 다음은 PHP 구문의 WeChat 결제 클래스입니다. 위의 단계를 참조하여 이해를 심화할 수 있습니다. 비용을 지불해야 하는 경우 매개변수를 직접 전달하여 이 클래스를 인스턴스화한 다음 클래스의 지불 메서드를 호출할 수 있습니다.

//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, &#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 환불

미니 프로그램 환불 절차는 결제와 유사하지만, 세부적으로 약간의 차이가 있습니다.

환불의 첫 번째 단계는 일반적으로 다음과 같습니다.

사용자가 프런트엔드에서 환불 버튼을 클릭한 후 백엔드는 사용자의 환불 요청을 수신하고 판매자가 이를 확인한 후 쇼핑몰 백엔드를 통해 판매자에게 전달합니다. 환불이 허용되면 백엔드는 환불을 요청하기 위해 WeChat API 요청에 환불을 시작합니다.

백엔드가 WeChat 환불 인터페이스에 요청을 보낸 후 응답 정보를 얻고 환불 완료 여부를 확인한 다음 환불 완료 여부에 따라 주문 상태 및 기타 비즈니스 로직을 변경합니다.

환불 절차는 위챗 결제에 비해 상대적으로 간단합니다.

다음 두 가지 사항에 주목할 필요가 있습니다.

1. WeChat 환불 인터페이스에서 환불을 요청한 후 받은 응답을 바탕으로 환불이 완료되었는지 직접 확인할 수 있습니다. WeChat 알림을 기다리기 위해 특별한 콜백 인터페이스를 설정할 필요가 없습니다. 물론 필요한 경우 WeChat 판매자 플랫폼에 콜백 인터페이스를 설정하여 WeChat 콜백을 수락할 수도 있지만 반드시 그럴 필요는 없습니다.

2. 환불 요청에는 요청 서버에 WeChat에서 제공한 보안 인증서가 설치되어 있어야 합니다. 즉, 결제 요청과 비교하여 환불 요청을 시작할 때 요청 시 요청 방법을 재사용할 수 없습니다. WeChat 환불에는 인증서 요청이 필요하기 때문입니다. Linux에서 PHP 개발 환경에 대한 인증서는 WeChat 판매자 계정을 성공적으로 신청한 후 WeChat 판매자 플랫폼에서 다운로드할 수 있습니다. 웹사이트의 루트 디렉토리. 다른 개발 환경에서는 가져오기 작업이 필요할 수 있습니다.

다음은 환불의 구체적인 단계를 설명합니다

1. 사용자가 환불 요청을 시작합니다

사용자가 프런트 엔드에서 환불 요청을 시작하고 백엔드가 환불 요청을 수신하고 해당 주문을 환불 신청으로 표시합니다. 확인 후, 판매자가 환불에 동의하면 해당 작업을 진행합니다. 그래야만 실제 환불 프로세스가 시작됩니다.

2. 판매자가 환불 요청을 시작합니다.

환불을 위해 백엔드는 WeChat 요청에서 제공하는 환불 API를 시작합니다.

WeChat 결제 API를 요청하는 것과 동일합니다. 환불 요청도 필수 매개변수에 서명하고 이를 XML로 WeChat 환불 API에 보내야 합니다.

매개변수 환불 요청에 필요한 매개변수는 다음과 같습니다(결제 API 요청 시 여러 매개변수가 필요합니다. 또한 사용됨):

매개변수:

appid

mch_id 판매자 번호. WeChat 결제 가맹점 인증을 성공적으로 신청하면 WeChat에서 보낸 이메일에

out_trade_no 가맹점 주문 번호가 포함됩니다. 환불주문 결제시 생성되는 주문번호

out_refund_no 환불주문번호. 동일한 환불 주문 번호가 여러 개 있으면 한 번만 환불되므로 백엔드에서 생성된 환불 주문 번호는 고유해야 합니다.

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视频教程》

위 내용은 PHP로 WeChat 결제 및 환불 프로세스를 구현한 사례에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!