3.支付的回调统一处理

系统管理员 2022-09-24 11:25 754阅读 0赞

[Payment项目地址github地址][Payment_github]

经过这一段时间，终于把支付宝支付相关接口完成了。文档将陆续更新。这里先把回调的文档补充完成。这样结合之前 提供的 [支付宝即时到帐接口][Link 1] 才能形成一个闭环。完成一次完整的支付流程。

# 回调接口介绍 #

> 支付服务商(支付宝、微信、PayPal等)处理完支付数据后。会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。

简单来说，就是支付成功后，支付服务商告诉你，钱已经到账了，你应该把别个买的东西给别个了。

由于本次发布的接口主要都是与支付宝相关，因此本次回调的部分代码也主要先上支付宝的。微信等后期开发完成将更新相关文档。

针对不同的回调，我提供了统一的调用方式，让客户端专注自己的业务。不在处理支付相关的签名验证、来源验证的问题。下面代码是统一的回调处理代码

// 支付宝配置文件
    $aliconfig = [
        'partner'   => '2088xxxxx',// 请填写自己的支付宝账号信息
        'md5_key'   => 'xxxxxxx',// 此密码无效，请填写自己对应设置的值
        'rsa_private_key'   => dirname(__FILE__) . DIRECTORY_SEPARATOR . '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',
    
        // 转款接口，必须配置以下两项
        'account'   => 'xxxxxxx@126.com',
        'account_name' => 'xxxxxxxxxxxx',
    ];
    
    // 微信配置文件
    $wxconfig = [
        'app_id'    => 'wxxxx',  // 公众账号ID
        'mch_id'    => 'xxxx',// 商户id
        'md5_key'   => 'xxxxxx',// 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',
    ];
    
    // 获取异步通知上下文
    $notify = new NotifyContext();
    
    // 客户端的业务逻辑类。处理如：订单更新
    $callback = new TestNotify();
    
    try {
        // 支付宝回调
        //$notify->initNotify(Config::ALI, $aliconfig);
    
        // 微信回调
        $notify->initNotify(Config::WEIXIN, $wxconfig);
        $notify->notify($callback);
    } catch (PayException $e) {
        echo $e->errorMessage();exit;
    }

客户端类 `TestNotify` 的注意事项 ，一定要继承 `PayNotifyInterface` 这个类

use Payment\Notify\PayNotifyInterface;
    
    class TestNotify implements PayNotifyInterface { 
        /** * 客户端的业务逻辑， * @param array $data * @return bool 返回值一定是bool值 * @author helei */
        public function notifyProcess(array $data) { 
            // 一般支付的处理业务
            1. 检查订单是否存在
            2. 检查金额是否正确
            3. 检查订单是否已经处理过（防止重复通知）
            4. 更新订单
    
    
            return true;
        }
    
    }

在 `TestNotify::notifyProcess()` 方法中，我注释了常规的订单处理流程。这个地方客户端可根据自己的情况进行适当调整。只是返回结果一定需要 **布尔值**

现在的重点是 `TestNotify::notifyProcess()` 方法中的参数 $data 中具体包含的值。根据不同的回调业务，返回的值也不一样。具体请往下看。

# 支付宝回调通知类型 #

支付宝的回调，与支付相关的对应三种类型。

*  trade\_status\_sync 支付行为相关的异步通知
 *  batch\_refund\_notify 有密批量退款的异步通知
 *  batch\_trans\_notify 有密批量付款到支付宝账号的通知

## trade\_status\_sync 异步通知返回数据 ##

该回调发生在：移动支付、即时到帐、手机网站支付接口调用后，如果支付成功，支付宝会发起回调接口。

返回的对应数据如下表

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>subject</td> 
   <td>商品名称</td> 
   <td>订单的关键字</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>body</td> 
   <td>商品描述</td> 
   <td>提交订单时的body值</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>amount</td> 
   <td>交易金额</td> 
   <td>本次订单总金额</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>channel</td> 
   <td>支付渠道</td> 
   <td>本处取值： ali</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>order_no</td> 
   <td>商户网站唯一订单号</td> 
   <td>商户生成的订单号，必须确保在系统中唯一</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>buyer_id</td> 
   <td>买家支付宝账户号</td> 
   <td>可以是Email或手机号码。</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>trade_state</td> 
   <td>交易状态</td> 
   <td>支付成功与否，可取值：success not_pay</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>transaction_id</td> 
   <td>支付宝交易号</td> 
   <td>支付宝系统中的交易流水号，可用于查询订单状态</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>time_end</td> 
   <td>交易付款时间</td> 
   <td>格式为2016-07-28 16:01:01</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>notify_time</td> 
   <td>通知时间</td> 
   <td>格式为2016-07-28 16:01:01</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>notify_type</td> 
   <td>通知类型</td> 
   <td>此处为：trade 表示交易</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>extra_param</td> 
   <td>商户自定义参数</td> 
   <td>仅即时到帐支持</td> 
   <td>否</td> 
  </tr> 
 </tbody> 
</table>

传入到 `TestNotify::notifyProcess()` 中的数组，包括以上key。可根据以上内容进行业务处理。

## batch\_refund\_notify 异步通知返回数据 ##

本类回调发生在操作退款后，支付宝会通知服务器是否退款成功。退款的界面，如下图：

![image][]

输入支付密码后，就可完成退款。退款后支付宝会向商户服务器进行异步通知。他返回的数据如下：

## batch\_trans\_notify 异步通知返回数据 ##

该回调发生在批量付款后。返回的数据如下：

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>channel</td> 
   <td>渠道</td> 
   <td>本处取值： ali</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>trans_no</td> 
   <td>商户网站唯一转账单号</td> 
   <td>商户生成的转账单号，必须确保在系统中唯一</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>pay_name</td> 
   <td>付款账号姓名</td> 
   <td>如果是个人为昵称，公司则为公司名称</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>pay_account</td> 
   <td>付款账号</td> 
   <td>邮箱或者手机号码</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>notify_time</td> 
   <td>通知时间</td> 
   <td>格式为2016-07-28 16:01:01</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>notify_type</td> 
   <td>通知类型</td> 
   <td>此处为：trade 表示交易</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>success</td> 
   <td>转账成功的详细信息</td> 
   <td>返回的是一个数组</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>fail</td> 
   <td>转账失败的详细信息</td> 
   <td>返回的是一个数组</td> 
   <td>是</td> 
  </tr> 
 </tbody> 
</table>

**备注：**

*  success返回的数组中，单条记录格式如下：

> 流水号^收款方账号^收款账号姓名^付款金额^成功标识(S)^成功原因(null)^支付宝内部流水号^完成时间。

*  fail返回数据中的单条记录格式如下：

> 流水号^收款方账号^收款账号姓名^付款金额^失败标识(F)^失败原因^支付宝内部流水号^完成时间。

OK。到此支付宝相关的回调通知数据，已经全部处理完成。这里需要大家注意一个问题，上面的数据并不是完整的支付宝返回数据。大部分经过了我的简化，如果有需要的参数，没有返回可执行修改源码或者联系我。

# 微信支付回调 #

微信的回调代码部分与支付宝相同。不同的主要是返回值

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>amount</td> 
   <td>订单金额</td> 
   <td>微信默认为分，此处以处理为元，两位小数</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>channel</td> 
   <td>支付渠道</td> 
   <td>可取之为：ali wx 此处为wx</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>order_no</td> 
   <td>商户订单号</td> 
   <td>商户系统的订单号，与请求一致。</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>buyer_id</td> 
   <td>用户标识</td> 
   <td>用户在商户appid下的唯一标识</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>trade_state</td> 
   <td>交易状态</td> 
   <td>表示交易成功，返回值：success</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>transaction_id</td> 
   <td>微信支付订单号</td> 
   <td>微信支付订单号</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>time_end</td> 
   <td>支付完成时间</td> 
   <td>支付完成时间，格式为yyyy-MM-dd HH:mm:ss</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>notify_time</td> 
   <td>异步通知发生时间</td> 
   <td>支付完成时间，格式为yyyy-MM-dd HH:mm:ss</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>notify_type</td> 
   <td>通知类型</td> 
   <td>此处为：trade 表示交易</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>extra_param</td> 
   <td>商户自定义参数</td> 
   <td>仅即时到帐支持</td> 
   <td>否</td> 
  </tr> 
 </tbody> 
</table>

大家可以对比支付宝中异步通知的返回数据。对相关数据均做了命令统一、数据单位格式统一。方便再业务中进行统一处理。

[Payment_github]: https://github.com/helei112g/payment
[Link 1]: https://helei112g.github.io/2016/07/18/%E6%94%AF%E4%BB%98%E5%AE%9D%EF%BC%9A%E5%8D%B3%E6%97%B6%E5%88%B0%E8%B4%A6%E6%8E%A5%E5%8F%A3%E6%8E%A5%E5%85%A5/
[image]: /images/20220719/50fdb74f79964122bfb06441cac3f458.png