6. PHP接入支付宝有密退款接口

叁歲伎倆 2022-09-25 00:24 214阅读 0赞

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

这个接口主要用于退款操作。之前没有接入该功能时，商城用户如果想要退款，我们需要先查到对应用户的支付流水号，然后写退款申请给财务，财务到支付宝进行查询。完了之后原路退回。然后告诉程序，程序再去修改订单状态。

这样的流程不仅麻烦。而且充满不安全性。如果程序误操作（或者是心情太差了），操作为其他人员，那么这将会为企业带来很大的风险。

# SDK调用 #

支付宝支持多笔退款。

// 支付宝配置信息
    $aliconfig = [
        'partner'   => '2088xxxxx',
        'md5_key'   => 'xxxxxxxxxxxx',
        'rsa_private_key'   => dirname(__FILE__) . '/rsa_private_key.pem',
        "notify_url"    => 'http://test.helei.com/pay-notify.html',
        "return_url"    => 'http://test.helei.com/return-url.html',
        "time_expire"   => '14',
    ];
    
    // 生成退款单号 便于测试
    function createPayid() { 
        return date('Ymdhis', time()).substr(floor(microtime()*1000),0,1).rand(0,9);
    }
    
    
    // 退款数据
    $reundData = [
        'refund_no' => createPayid(),
        'refund_data'   => [
            ['transaction_id' => '2016011421001004330041239366', 'amount'   => '0.01', 'refund_fee' => '0.01', 'reason' => '测试退款1'],
            ['transaction_id' => '2016031521001004330271745693', 'amount'   => '0.01', 'refund_fee' => '0.01', 'reason' => '测试退款2'],
        ],
    ];
    
    
    $refund = new RefundContext();
    try {
        $refund->initRefund(Config::ALI, $aliconfig);
        $ret = $refund->refund($reundData);
    } catch (PayException $e) {
        echo $e->errorMessage();exit;
    }
    
    // 跳转支付宝
    header("Location:{$ret}");

以上请求发送完毕后，会跳转到生成的url。界面如下：

![image][]

这时候，只需要要输入支付密码。就可完成退款。确认完毕后会自动完成异步通知。异步通知数据内容在 [支付的回调统一处理][Link 1] 已经说明。

备注：支付宝支持一次退款多笔。也可单次退款一笔，请自行根据情况进行设置。

# 请求参数 #

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>refund_no</td> 
   <td>退款单号</td> 
   <td>由商家自定义生成，可由字母、数字组成</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>refund_data</td> 
   <td>退款数据</td> 
   <td>详细内容见后表，它是一个数组</td> 
   <td>是</td> 
  </tr> 
 </tbody> 
</table>

**refund\_data数据**

<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>

一笔订单，可分多次进行退款处理。比如：一笔支付100元的订单。可分为10次，每次退款10元。该思路可扩展一下，就可实现提现功能（原路返回），想要具体了解提现功能，可咨询我！

[payment _2.0]: https://github.com/helei112g/payment/tree/paymentv2
[image]: https://helei112g.github.io/images/4.png
[Link 1]: https://helei112g.github.io/2016/07/29/%E6%94%AF%E4%BB%98%E7%9A%84%E5%9B%9E%E8%B0%83%E7%BB%9F%E4%B8%80%E5%A4%84%E7%90%86/