异常转付处理结果回调(ABNORMAL_FUND_PROCESSING.TRANSFER.SUCCESS)通知(JSON)

商户有在途异常资金时，可以发起在途异常资金付款，转付给符合条件的接收方。当转付成功时，微信支付会通过POST的请求方式，向商户预先设置的回调地址发送回调通知，让商户知晓异常资金已付款给接收方。

注意：

若商户应答回调接收成功，微信支付将不再重复发送该回调通知。若因网络或其他原因，商户收到了重复的回调通知，请按正常业务流程进行处理并应答。
若商户应答回调接收失败，或超时(5s)未应答时，微信支付会重复发送回调通知，直至微信支付接收到商户应答成功，或达到最大发送次数（16次）

请求参数	类型	描述
headers	object	通知的头参数
Content-Type	string	`application/json`
Request-ID	string	通知的唯一标识
Wechatpay-Nonce	string	数据签名使用的随机串
Wechatpay-Serial	string	微信支付公钥ID/平台证书序列号
Wechatpay-Signature	string	签名串
Wechatpay-Signature-Type	string	签名算法 `WECHATPAY2-SHA256-RSA2048` 枚举值
Wechatpay-Timestamp	string	时间戳
body	object	通知的`JSON`数据结构
id	string	通知的唯一ID
create_time	string	通知创建的时间
event_type	string	通知的类型 `ABNORMAL_FUND_PROCESSING.TRANSFER.SUCCESS` 枚举值
resource_type	string	通知的资源数据类型
summary	string	回调摘要
resource	object	通知资源数据
original_type	string	原始回调类型
algorithm	string	对数据进行加密的加密算法 `AEAD_AES_256_GCM` 枚举值
associated_data	string	数据加密的附加数据
nonce	string	加密使用的随机串
ciphertext	string	加密后的密文数据

product_name	string	产品名称 `C2C` 枚举值
receipt_id	string	微信支付在途异常资金付款单号
transfer_amount	object	付款金额信息
total	integer	总金额
currency	string	货币类型 `CNY` 枚举值
receipt_state	string	在途异常资金付款状态 `RECEIPT_STATE_PENDING` \| `RECEIPT_STATE_PROGRESS` \| `RECEIPT_STATE_COMPLETED` 枚举值之一
create_time	string	在途异常资金付款单据创建时间
last_update_time	string	在途异常资金付款单据更新时间
instruction	object	在途异常资金付款指令信息
out_instruction_no	string	商户侧指令编号
commander	object	在途异常资金付款指令的发起方
operator	string	发起在途异常资金付款请求的角色 `MERCHANT` 枚举值
mchid	string	微信支付商户号
transfer_mode	string	付款方式 `TRANSFER_TO_ORIGINAL_RECEIVE_USER` 枚举值
success_time	string	入账成功时间
appid	string[]	商户AppID

处理程序

php

// 使用Psr标准规范，示例如何处理(取值、验签、解密)「回调通知」事件，WebServer不同，用法略有差异，供参考实现。
function webhookProcessor(\Psr\Http\Message\RequestInterface $request,
  array $platformPublicKeyMap, string $apiv3Key): array {
  if (!\count($platformPublicKeyMap)) {
    throw new \WeChatPay\Exception\InvalidArgumentException('平台证书或者平台公钥数组不能为空');
  }

  if (\strlen($apiv3Key) !== 32) {
    throw new \WeChatPay\Exception\InvalidArgumentException('APIV3密钥为32字节，长度不对');
  }

  if (!($request->hasHeader(\WeChatPay\WechatpayNonce)
    && $request->hasHeader(\WeChatPay\WechatpaySerial)
    && $request->hasHeader(\WeChatPay\WechatpaySignature)
    && $request->hasHeader(\WeChatPay\WechatpayTimestamp))) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知的头参数缺失必要参数');
  }

  // 检查通知的时间偏移量，允许5分钟之内的偏移
  [$inWechatpayTimestamp] = $request->getHeader(\WeChatPay\WechatpayTimestamp);
  if (\WeChatPay\MAXIMUM_CLOCK_OFFSET < \abs(
    \WeChatPay\Formatter::timestamp() - (int)$inWechatpayTimestamp)) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知头参数的时间偏移量超过可信阈值');
  }

  // 检查通知的平台证书/平台公钥实例是否存在
  [$inWechatpaySerial] = $request->getHeader(\WeChatPay\WechatpaySerial);
  if (!\array_key_exists($inWechatpaySerial, $platformPublicKeyMap)) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知头参数的证书序列号/公钥ID本地不存在');
  }

  // 验证通知的数据签名
  [$inWechatpaySignature] = $request->getHeader(\WeChatPay\WechatpaySignature);
  [$inWechatpayNonce] = $request->getHeader(\WeChatPay\WechatpayNonce);
  $inBody = (string)$request->getBody();
  if (!\WeChatPay\Crypto\Rsa::verify(
    \WeChatPay\Formatter::joinedByLineFeed($inWechatpayTimestamp, $inWechatpayNonce, $inBody),
    $inWechatpaySignature, $platformPublicKeyMap[$inWechatpaySerial]
  )) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知头参数的数据签名校验未通过');
  }

  // 转换通知的JSON文本消息为PHP Array数组
  $inBodyArray = (array)\json_decode($inBody, true);
  // 使用PHP7+的数据解构语法，从Array中解构并赋值变量
  ['resource' => [
    'ciphertext'      => $ciphertext,
    'nonce'           => $nonce,
    'associated_data' => $aad
  ]] = $inBodyArray;
  // 加密文本消息解密，有可能解密异常(eg: 平台探测流量)会抛 \UnexpectedValueException
  $inBodyResource = \WeChatPay\Crypto\AesGcm::decrypt($ciphertext, $apiv3Key, $nonce, $aad);
  // 把解密后的文本转换为PHP Array数组
  $inBodyResourceArray = (array)\json_decode($inBodyResource, true);
  // 把解密后的数组定义为'original_data'函数返回
  $inBodyArray['resource']['original_data'] = $inBodyResourceArray;

  return [
    'headers' => $request->getHeaders(),
    'body' => $inBodyArray
  ];
}

// do your business
// ...
// ...
$json = \json_encode([
  'code' => 'SUCCESS',
  'message' => 'OK'
]);

应答规范	类型	描述
status	number	`HTTP`状态码 `20X` `4XX` `5XX` 枚举值之一
body	object	应答的`JSON`数据结构
code	string	业务处理状态码 `SUCCESS` \| `FAIL` 枚举值之一
message	string	业务处理附加信息

参阅官方文档

异常转付处理结果回调(ABNORMAL_FUND_PROCESSING.TRANSFER.SUCCESS)通知(JSON) ​

异常转付处理结果回调(ABNORMAL_FUND_PROCESSING.TRANSFER.SUCCESS)通知(JSON)