10.PHP接入微信退款接口

Myth丶恋晨 2022-09-25 07:16 216阅读 0赞

[payment 项目2.0版本][payment _2.0]

微信的退款操作，通过封装与前面[支付宝退款][Link 1]除了配置文件，基本一样。

退款代码如下：

use Payment\RefundContext;
    use Payment\Common\PayException;
    use Payment\Config;
    
    // 生成退款单号 便于测试
    function createPayid() { 
        return date('Ymdhis', time()).substr(floor(microtime()*1000),0,1).rand(0,9);
    }
    
    $config = [
        'app_id'    => 'wxa244db59a34996fc',  // 公众账号ID
        'mch_id'    => '1331302101',// 商户id
        'md5_key'   => 'adslkfjiKQJLAIQLJ393201482333333',// md5 秘钥
    
        'notify_url'    => 'http://test.helei.com/pay-notify.html',
        'time_expire'   => '14',
    
        // 涉及资金流动时 退款 转款，需要提供该文件
        'cert_path' => dirname(__FILE__) . DIRECTORY_SEPARATOR . 'wx' . DIRECTORY_SEPARATOR . 'apiclient_cert.pem',
        'key_path'  => dirname(__FILE__) . DIRECTORY_SEPARATOR . 'wx' . DIRECTORY_SEPARATOR . 'apiclient_key.pem',
    ];
    
    // 退款数据
    $reundData = [
        'refund_no' => createPayid(),
        'refund_data'   => [
            ['transaction_id' => '4007572001201607098672633287', 'amount'   => '5', 'refund_fee' => '5', 'reason' => '微信测试金额退款'],
        ],
    ];
    
    $refund = new RefundContext();
    try {
        // 微信退款
        $type = Config::WEIXIN;
        $refund->initRefund(Config::WEIXIN, $wxconfig);
    
        $ret = $refund->refund($reundData);
    } catch (PayException $e) {
        echo $e->errorMessage();exit;
    }
    
    var_dump($ret);

当前sdk支付宝可一次退款多笔数据。微信仅能每次退款1笔（如果想要实现一次退订多笔订单，可在客户端通过循环来处理。）

接下来解释下相关的配置信息

微信的配置文件解释参考 [微信的三种支付方式接入：APP支付、公众号支付、扫码支付][APP] 中的微信配置信息。

# 请求参数 #

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>transaction_id</td> 
   <td>微信交易号</td> 
   <td>微信系统中的交易流水号，可用于查询订单状态</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>amount</td> 
   <td>总金额</td> 
   <td>微信交易对应的交易总金额</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>refund_fee</td> 
   <td>退款金额</td> 
   <td>本次申请的退款金额，退款金额不能大于总金额</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>reason</td> 
   <td>退款理由</td> 
   <td>退款的理由，可在用户端查看到</td> 
   <td>是</td> 
  </tr> 
 </tbody> 
</table>

# 响应数据 #

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>is_success</td> 
   <td>成功标识</td> 
   <td>请求是否成功，T:成功，F:失败</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>error</td> 
   <td>错误提示</td> 
   <td>只有is_success=F时才返回</td> 
   <td>否</td> 
  </tr> 
  <tr> 
   <td>response</td> 
   <td>响应数据</td> 
   <td>查询成功后返回的数据，一个数组，is_success=T时返回</td> 
   <td>否</td> 
  </tr> 
 </tbody> 
</table>

**response** 数据描述

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>transaction_id</td> 
   <td>微信订单号</td> 
   <td>微信订单号，下单成功后，微信返回</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>order_no</td> 
   <td>商户订单号</td> 
   <td>商户系统内部的订单号</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>refund_no</td> 
   <td>商户退款单号</td> 
   <td>商户退款单号</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>refund_id</td> 
   <td>微信退款单号</td> 
   <td>微信退款单号</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>refund_fee</td> 
   <td>申请退款金额</td> 
   <td>退款总金额,单位为元(已被我处理),可以做部分退款</td> 
   <td>否</td> 
  </tr> 
  <tr> 
   <td>amount</td> 
   <td>订单金额</td> 
   <td>订单总金额，单位为元，最多两位小数</td> 
   <td>否</td> 
  </tr> 
 </tbody> 
</table>

[payment _2.0]: https://github.com/helei112g/payment
[Link 1]: https://helei112g.github.io/2016/08/03/PHP%E6%8E%A5%E5%85%A5%E6%94%AF%E4%BB%98%E5%AE%9D%E6%9C%89%E5%AF%86%E9%80%80%E6%AC%BE%E6%8E%A5%E5%8F%A3/
[APP]: https://helei112g.github.io/2016/08/10/%E5%BE%AE%E4%BF%A1%E7%9A%84%E4%B8%89%E7%A7%8D%E6%94%AF%E4%BB%98%E6%96%B9%E5%BC%8F%E6%8E%A5%E5%85%A5%EF%BC%9AAPP%E6%94%AF%E4%BB%98%E3%80%81%E5%85%AC%E4%BC%97%E5%8F%B7%E6%94%AF%E4%BB%98%E3%80%81%E6%89%AB%E7%A0%81%E6%94%AF%E4%BB%98/