您现于de位置乃:亚博 > APP类库

亚博 2019-04-27 APP类库 803

APP实现微信支付及退款流程实例

原生app支付de主要逻辑集中于后端 前端只需携带支付所需de数据请求后端接口然后根据返回结果做相应成功失败处理即可.本篇文章后端使用de乃app 侧重于整个支付de流程和1些细节方面de东西.所以使用其他后端语言de朋友有需要也乃可以看1下de.很多时候开发de需求和相应问题de解决真de要跳出语言语法层面 去从系统和流程de角度考虑.


1 微信支付


支付主要分为几个步骤:

前端携带支付需要de数据(商品id 购买数量等)发起支付请求

后端于接收到支付请求后 处理支付数据 然后携带处理后de数据请求 微信服务器 de 支付统1下单接口

后端接收到上1步请求微信服务器de返回数据 再次处理 然后返回前端让前端可以开始支付.


前端进行支付动作

前端支付完成后 微信服务器会向后端发送支付通知(也就乃微信要告诉您客户已经付过钱了) 后端根据这个通知确定支付完成 然后就去做支付完成后de相应动作 比如修改订单状态 添加交易日志啊等等.

从这几个步骤可以看出 后端主要de作用就乃将支付需要de数据传给微信服务器 再根据微信服务器de响应确定支付乃否完成.


这个流程还乃蛮容易理解de.形象de说 前端就乃个顾客 后端就乃店家 微信服务器de统1下单接口就像收银员.顾客跟店家说 我乃谁谁谁 现于我要付多少多少钱给您买什么什么.店家就跟收银员说 那个谁谁谁要付多少钱 您准备收钱吧.收银员收到钱后 就去告诉店家 我已经收到钱了 您给他东西吧.

下面就详细de说明1下各个步骤de具体实现.


1. 前端请求支付

前端请求支付 就乃简单de携带支付需要de数据 例如用户标识 支付金额 支付订单 ID 等等跟 **您de业务逻辑有关** 或者跟 **下1步请求微信服务器支付统1下单接口需要de数据有关** de相关数据 使用原生appde wx.request( ) 去请求后端de支付接口.


2. 后端请求微信服务器

后端接收到前端发送de支付请求后 可以进行1下相关验证 例如判断1下用户有没有问题 支付金额对不对等等.

于验证没什么问题 可以向微信服务器申请支付之后 后端需要使用 微信规定de数据格式 去请求微信de支付统1下单接口.


微信规定de请求数据:

这需要较多代码实现.因为需要de数据个数较多 而1剐枰用懿⒁ XML 格式发送.

首先 有以下数据乃使用小程序支付必须提供给微信服务器de参数.


小程序 appid.写小程序de大概没有不知道这个de...

用户标识 openid.也就乃用户de小程序标识 于我上篇亚博中说明了如何获取.

商户号 mch_id .申请开通微信支付商户认证成功后微信发给您de邮件里有

商户订单号 out_trade_no .商户为这次支付生成de订单号

总金额 total_fee .订单总金额 很重要de1点乃单位乃分 要特别注意.

微信服务器回调通知接口地址 notify_url.微信确认钱已经到账后 会往这个地址多次发送消息 告诉您顾客已经付完钱了 您需要返回消息给微信表示您已经收到了通知..这个地址不能有端口号 同时要能直接接受POST方法请求.


交易类型 trade_type .原生app支付此值统1为 JSAPI

商品信息 Body.类似"腾讯-游戏"这种格式

终端IP地址 spbill_create_ip .终端地址IP 也就乃请求支付de IP 地址.

随机字符串 nonce_str .需要后端随机生成de字符串用于保证数据安全.微信要求不长于32位.

签名 sign .使用上面de所有参数进行相应处理加密生成签名.(具体处理方式可见下文代码 可直接复用.)

于处理好以上所有数据后 将这些数据以 XML 格式整理并以 POST 方法发送到 微信支付统1下单接口


3.后端接受微信服务器返回数据


微信服务器于接收到支付数据之后 如果数据没有问题 其会返回用于支付de相应数据 其中非常重要de乃 名称为 prepay_id de数据字段 需要将此数据返回前端 前端才能继续支付.


因此 于后端接收到微信服务器de返回数据后 需要进行相应de处理 最终返回到前端如下数据:


appid 不需多说

timeStamp 当前时间戳

nonceStr 随机字符串

package 就乃上面提到de prepay_id 不过切记格式如 "prepay_id= prepay_id_item".否则会导致错误.

signType 加密方式 1般应该乃 MD5

paySign 对以上数据进行相应处理并加密.


到这里 后端de支付接口已经完成了接收前端支付请求 并返回了前端支付所需数据de功能.


4. 前端发起支付

前端于接收到返回数据后 使用 wx.requestPayment() 来请求发起支付.此 API 需要de对象参数各项值就乃我们上1步返回de各个数据.


5.后端接受微信服务器回调

前端完成支付后 微信服务器确认支付已经完成.就会向第1步中设置de回调地址发送通知.后端de接收回调接口于接收到通知后 就可以判断支付乃否完成 从而决定后续动作.

需要注意de乃 于接收到微信服务器de回调通知后 根据通知deresult_code字段判断支付乃否成功.于接受到成功de通知后 后端需要返回success数据向微信服务器告知已得到回调通知.否则微信服务器会不停de向后端发送消息.另外微信de通知乃以XML格式发送de 于接受处理时需要注意.


微信de大概支付流程就乃这样.以下乃APP语法de微信支付类 可以比照上面de步骤介绍 加深理解.于需要支付时 直接传入参数实例化此类再调用类de pay 方法即可.

//微信支付类
class WeiXinPay{
  //=======【基本信息设置】=====================================
  //APP应用身份de唯1标识
  protected $APPID = appid;//填写您deappid.微信公众平台里de
  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';
  //微信支付类de构造函数
  function __construct($openid,$outTradeNo,$totalFee){
    $this->openid = $openid; //用户唯1标识
    $this->outTradeNo = $outTradeNo; //商品编号
    $this->totalFee = $totalFee; //总价
  }
  //微信支付类向外暴露de支付接口
  public function pay(){
    $result = $this->weixinapp();
    return $result;
  }
   //对微信统1下单接口返回de支付相关数据进行处理
   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;
   }
  /*
   *请求微信统1下单接口
   */
  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");
    }
  }
  /*
   * 对要发送到微信统1下单接口de数据进行签名
   */
  protected function getSign($Obj){
     foreach ($Obj as $k => $v){
     $Parameters[$k] = $v;
     }
     //签名步骤1:按字典序排序参数
     ksort($Parameters);
     $String = $this->formatBizQueryParaMap($Parameters, false);
     //签名步骤2:于string后加入KEY
     $String = $String."&key=".$this->KEY;
     //签名步骤3:MD5加密
     $String = md5($String);
     //签名步骤4:所有字符转为大写
     $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;
     }
}


以上就乃微信支付de相关流程.于理清思路后 流程还乃比较清晰和简单de.重点于于需要注意1些细节问题 例如数据格式 加密方法等.


下面说1下原生app退款de具体实现


2 微信退款


小程序退款de流程和付款相似 但有1些细节上de不同.


首先退款de步骤通常如下:

用户前端点击退款按钮后 后端接收到用户de退款请求通过商城后台呈现给商户 商户确定允许退款后 后端再发起向微信退款接口de请求来请求退款.

后端向微信退款接口发送请求后 得到响应信息 确定退款乃否完成 根据退款乃否完成再去进行改变订单状态等业务逻辑.

退款de步骤相对微信支付来说比较简单.


值得注意de有以下两点:


1.向微信退款接口请求退款后 根据得到de响应乃可以直接确定退款乃否完成de.不再需要设置专门de回调接口等待微信通知.当然如果需要也乃可以于微信商户平台设置回调接口接受从而接受微信回调de 但并不乃必须de.

2.退款请求需要于请求服务器安装微信提供de安全证书 也就乃说,发起退款请求相比较支付请求于请求时请求方法不能复用,因为微信退款需要携带证书de请求,此证书可于申请微信商户号成功后从微信商户平台自行下载 Linux下deAPP开发环境de证书只需要放于网站根目录decert文件夹中即可.其他开发环境可能需要导入操作.


下面讲解1下退款de具体步骤


1. 用户发起退款请求

用户于前端发起退款请求,后端接收到退款请求,将相应订单标记为申请退款,展示于后台.商户查看后,如果同意退款再进行相应操作.此后才进入真正de退款流程.


2. 商户发起退款请求

商户同意退款后,后端即向微信提供de退款 API 发起请求.


同请求微信支付API1样.退款请求也需要将需要de参数进行签名后以XML发送到微信de退款API 

退款请求需要de参数如下(多个参数于支付API请求时也有使用):


参数:

appid 

mch_id 商户号.申请开通微信支付商户认证成功后微信发给您de邮件里有

out_trade_no 商户订单号.退款订单于支付时生成de订单号

out_refund_no 退款订单号.由后端生成de退款单号 需要保证唯1 因为多个同样de退款单号只会退款1次.

total_fee 总金额.订单总金额 单位为分.

refund_fee 退款金额. 需要退款de金额,单位同样为分

op_user_id 操作员.与商户号相同即可

nonce_str 随机字符串.同支付请求


签名 sign .使用上面de所有参数进行相应处理加密生成签名.(具体处理方式与支付相同 可直接复用.)

注:我就乃因为于实例化de时候没有传入key(秘钥)参数 1直报错签名错误.


3. 退款完成

于发起退款请求后 就可以直接根据请求de响应XML中de result_code字段来判断退款乃否成功 从而对订单状态进行处理和后续操作.不需要像支付那样等待另1个接口de通知来确定请求状态.当然如上文所说 如果需要微信服务器发送通知到后端de话 可以到微信商户平台进行设置.


退款因为流程与支付大同小异 因此退款deAPP类我选择了直接继承支付类


代码如下 注意区分退款请求方法postXmlSSLCurl和支付请求方法postXmlCurlde区别 这也就乃上文提到de退款需要de双向证书de使用.

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){
  //初始化退款类需要de变量
  $this->openid = $openid;
  $this->outTradeNo = $outTradeNo;
  $this->totalFee = $totalFee;
  $this->outRefundNo = $outRefundNo;
  $this->refundFee = $refundFee;
} 
public function refund(){
  //对外暴露de退款接口
  $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;
}
//需要使用证书de请求
function postXmlSSLCurl($xml,$url,$second=30)
{
  $ch = curl_init();
  //超时时间
  curl_setopt($ch,CURLOPT_TIMEOUT,$second);
  //这里设置代理 如果有de话
  //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;
  }
}}


3. 总结


以上就乃关于微信支付和退款de流程及相关知识de介绍.文中de APP类 均封装直接可用.


因为微信支付和退款涉及de东西较为繁杂 很多人直接看官方文档可能会1头雾水 所以看过此文了解流程和要点后 再去看微信官方文档.1方面可以更清晰de了解小程序de支付和退款流程.另1方面 本文因为篇幅有限及作者能力有限 肯定有无暇顾及或有所纰漏之处.为求稳妥 还乃需要多看看官方开发文档.毕竟事涉支付 出个BUG可不乃小事.


评论