微信api退款及退款查询

不念不忘少年蓝@ 2022-06-05 00:25 895阅读 0赞

相比支付宝的接口，微信的接口与实现都很简单其实，官方文档都有很详细的讲解。

官方文档地址：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9\_4

## 步骤： ##

1.下载 安全证书！！【关键】

2.按官方文档组织参数，生成URL

3.CURL等同步访问URL，获取XML返回值

4.自己系统的回调验证，完成自己系统退款的后续操作

一.证书的配置与下载

路径下载：微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->证书下载 。证书文件有四个，全部下载即可。

![Center][]

二.配置参数

\[php\] [view plain][] [copy][view plain]

1.  **array**( 
2.  'appid'=>'your\_appid',//应用ID，固定
3.  'mch\_id'=>'your\_mch\_id',//商户号，固定
4.  'nonce\_str'=>'123456',//随机字符串
5.  'op\_user\_id'=>'646131',//操作员
6.  'out\_refund\_no'=>'201608142308',//商户内部唯一退款单号
7.  'out\_trade\_no'=>'860524080535541654',//商户订单号,pay\_sn码 1.1二选一,微信生成的订单号，在支付通知中有返回
8.  // 'transaction\_id'=>'1',//微信订单号 1.2二选一,商户侧传给微信的订单号
9.  'refund\_fee'=>'3',//退款金额
10. 'total\_fee'=>'3',//总金额
11. 'sign'=>$ref//签名
12.  );

三.注意事项

常见问题：

1. 本接口是需要证书的，下载放上见上边

2. 微信的接口里，所有对金额的描述，都是以分为单位的

3.交易时间超过一年的订单无法提交退款；

4.微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。一笔退款失败后重新提交，要采用原来的退款单号。总退款金额不能超过用户实际支付金额。

5.在用下边demo做测试的时候，请先真实支付一次，获取相应的ID与参数，然后直接运行调试即可，仅供参考

6.注意下签名规则

![Center 1][]

7.CURL 返回值为58

答： 证书路径问题，证书路径应该为物理全路径，getcwd().'/apiclient\_cert.pem'这种写法 或者自己函数获取

8.CURL 返回值为77

答：证书问题，重新下载证书，按照配置对应放在生产路径，同上一条，用全的物理路径。

<err\_code><!\[CDATA\[TRADE\_STATE\_ERROR\]\]></err\_code>

<err\_code\_des><!\[CDATA\[订单状态错误\]\]></err\_code\_des>

原因：out\_trade\_no错误【out\_trade\_no为自己系统生产的支付码】

<err\_code><!\[CDATA\[ORDERNOTEXIST\]\]></err\_code>

<err\_code\_des><!\[CDATA\[订单不存在\]\]></err\_code\_des>

原因：out\_trade\_no不存在，也是就说没有这笔支付号

demo源码

<?php
    /*
    请确保您的libcurl版本是否支持双向认证，版本高于7.20.1
    */
    
    function Home_index(){
       $ref= strtoupper(md5("appid=your_appid&mch_id=your_mch_id&nonce_str=123456&op_user_id=646131"
          . "&out_refund_no=201608142308&out_trade_no=860524080535541654&refund_fee=3&total_fee=3"
          . "&key=suiji123"));//sign加密MD5
    
       $refund=array(
          'appid'=>'your_appid',//应用ID，固定
          'mch_id'=>'your_mch_id',//商户号，固定
          'nonce_str'=>'123456',//随机字符串
          'op_user_id'=>'646131',//操作员
          'out_refund_no'=>'201608142308',//商户内部唯一退款单号
          'out_trade_no'=>'860524080535541654',//商户订单号,pay_sn码 1.1二选一,微信生成的订单号，在支付通知中有返回
          // 'transaction_id'=>'1',//微信订单号 1.2二选一,商户侧传给微信的订单号
          'refund_fee'=>'3',//退款金额
          'total_fee'=>'3',//总金额
          'sign'=>$ref//签名
       );
    
       $url="https://api.mch.weixin.qq.com/secapi/pay/refund";;//微信退款地址，post请求
       $xml=arrayToXml($refund);
    
       $ch=curl_init();
       curl_setopt($ch,CURLOPT_URL,$url);
       curl_setopt($ch,CURLOPT_HEADER,1);
       curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
       curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,1);//证书检查
       curl_setopt($ch,CURLOPT_SSLCERTTYPE,'pem');
       curl_setopt($ch,CURLOPT_SSLCERT,dirname(__FILE__).'/cert/apiclient_cert.pem');
       curl_setopt($ch,CURLOPT_SSLCERTTYPE,'pem');
       curl_setopt($ch,CURLOPT_SSLKEY,dirname(__FILE__).'/cert/apiclient_key.pem');
       curl_setopt($ch,CURLOPT_SSLCERTTYPE,'pem');
       curl_setopt($ch,CURLOPT_CAINFO,dirname(__FILE__).'/cert/rootca.pem');
       curl_setopt($ch,CURLOPT_POST,1);
       curl_setopt($ch,CURLOPT_POSTFIELDS,$xml);
    
       $data=curl_exec($ch);
       if($data){ //返回来的是xml格式需要转换成数组再提取值，用来做更新
          curl_close($ch);
          var_dump($data);
       }else{
          $error=curl_errno($ch);
          echo "curl出错，错误代码：$error"."<br/>";
          echo "<a href='http://curl.haxx.se/libcurl/c/libcurs.html'>;错误原因查询</a><br/>";
          curl_close($ch);
          echo false;
       }
    }
    function arrayToXml($arr){
       $xml = "<root>";
       foreach ($arr as $key=>$val){
          if(is_array($val)){
             $xml.="<".$key.">".arrayToXml($val)."</".$key.">";
          }else{
             $xml.="<".$key.">".$val."</".$key.">";
          }
       }
       $xml.="</root>";
       return $xml ;
    }
    Home_index();

四.退款查询接口

如果上述退款调通了的话，那这个接口更简单了，只要把上述demo的参数换成退款查询的参数即可，这里就不赘述了

官方文档地址：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9\_5

\[php\] [view plain][] [copy][view plain]

1.  $url = https://api.mch.weixin.qq.com/pay/refundquery

### 请求参数 ###

<table> 
 <tbody> 
  <tr> 
   <th style="text-align:left;vertical-align:top;width:100px;">字段名</th> 
   <th style="text-align:left;vertical-align:top;width:100px;">变量名</th> 
   <th style="text-align:left;vertical-align:top;width:45px;">必填</th> 
   <th style="text-align:left;vertical-align:top;width:92px;">类型</th> 
   <th style="text-align:left;vertical-align:top;width:158px;">示例值</th> 
   <th style="text-align:left;vertical-align:top;">描述</th> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">公众账号ID</td> 
   <td style="vertical-align:top;">appid</td> 
   <td style="vertical-align:top;">是</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">wx8888888888888888</td> 
   <td style="vertical-align:top;">微信分配的公众账号ID（企业号corpid即为此appId）</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">商户号</td> 
   <td style="vertical-align:top;">mch_id</td> 
   <td style="vertical-align:top;">是</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">1900000109</td> 
   <td style="vertical-align:top;">微信支付分配的商户号</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">设备号</td> 
   <td style="vertical-align:top;">device_info</td> 
   <td style="vertical-align:top;">否</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">013467007045764</td> 
   <td style="vertical-align:top;">商户自定义的终端设备号，如门店编号、设备的ID等</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">随机字符串</td> 
   <td style="vertical-align:top;">nonce_str</td> 
   <td style="vertical-align:top;">是</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">5K8264ILTKCH16CQ2502SI8ZNMTM67VS</td> 
   <td style="vertical-align:top;">随机字符串，不长于32位。推荐<a href="https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3" rel="nofollow">随机数生成算法</a></td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">签名</td> 
   <td style="vertical-align:top;">sign</td> 
   <td style="vertical-align:top;">是</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">C380BEC2BFD727A4B6845133519F3AD6</td> 
   <td style="vertical-align:top;">签名，详见<a href="https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3" rel="nofollow">签名生成算法</a></td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">微信订单号</td> 
   <td style="vertical-align:top;">transaction_id</td> 
   <td style="vertical-align:top;">四选一</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">1217752501201407033233368018</td> 
   <td style="vertical-align:top;">微信订单号</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">商户订单号</td> 
   <td style="vertical-align:top;">out_trade_no</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">1217752501201407033233368018</td> 
   <td style="vertical-align:top;">商户系统内部的订单号</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">商户退款单号</td> 
   <td style="vertical-align:top;">out_refund_no</td> 
   <td style="vertical-align:top;">String(32)</td> 
   <td style="vertical-align:top;">1217752501201407033233368018</td> 
   <td style="vertical-align:top;">商户侧传给微信的退款单号</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">微信退款单号</td> 
   <td style="vertical-align:top;">refund_id</td> 
   <td style="vertical-align:top;">String(28)</td> 
   <td style="vertical-align:top;">1217752501201407033233368018</td> 
   <td style="vertical-align:top;"> <p>微信生成的退款单号，在申请退款接口有返回</p> </td> 
  </tr> 
 </tbody> 
</table>

举例如下：

[Center]: /images/20220605/6be9a9056db843cfa5df0b18ac9fd8ab.png
[view plain]: http://blog.csdn.net/ty_hf/article/details/52565321#
[Center 1]: /images/20220605/7bcd7ccb2ce44854a3027588297362d4.png