合单支付通知(XML)

合单支付的支付结果将只通知给合单支付发起方（即combine_appid一方），支付完成后，微信会把相关支付结果和用户信息发送给商户，商户需要接收处理，并返回应答。

注意：

• 合单支付的支付结果将只通知给合单支付发起方（即combine_appid一方）。
• 支付完成后，微信会把相关支付结果和用户信息发送给商户，商户需要接收处理，并返回应答。
• 对后台通知交互时，如果微信收到商户的应答不是成功或超时，微信认为通知失败，微信会通过一定的策略（如30分钟共8次）定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。（通知频率为15/15/30/180/1800/1800/1800/1800/3600，单位：秒）
• 注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
• 推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
• 特别提醒：商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致，防止数据泄露导致出现“假通知”，造成资金损失。

请求参数	类型	描述
headers	object	通知的头参数
Request-ID	string	通知的唯一标识
Content-Type	string	text/xml
body	object	通知的XML数据结构
return_code	string
return_msg	string
combine_appid	string
combine_mch_id	string
nonce_str	string
device_info	string
combine_openid	string
combine_out_trade_no	string
trade_type	string
bank_type	string
sign	string
sign_type	string
result_code	string
result_msg	string
err_code	string
err_code_des	string
sub_order_list	string
order_num	number
order_list	object[]
appid	string
mch_id	string
openid	string
total_fee	number
cash_fee	number
transaction_id	string
out_trade_no	string
attach	string
time_end	string

处理程序

function webhookProcessor(\Psr\Http\Message\RequestInterface $request,
  string $apiv2Key): array {
  if (\strlen($apiv2Key) !== 32) {
    throw new \WeChatPay\Exception\InvalidArgumentException('API密钥为32字节，长度不对');
  }

  $inBody = (string)$request->getBody();
  // 转换通知的XML文本消息为PHP Array数组
  $inBodyArray = \WeChatPay\Transformer::toArray($inBody);

  if (!\WeChatPay\Crypto\Hash::equals(\WeChatPay\Crypto\Hash::sign(
    $inBodyArray['sign_type'] ?? \WeChatPay\Crypto\ALGO_MD5,
    \WeChatPay\Formatter::queryStringLike(\WeChatPay\Formatter::ksort($inBodyArray)),
    $apiv2Key), $inBodyArray['sign'] ?? null
  )) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知的数据签名校验未通过');
  }

  // 子单JSON文本转换为Array数组
  $inBodyArray['sub_orders'] = \json_decode($inBodyArray['sub_order_list'], true);

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

// do your business
// ...
// ...
$xml = \WeChatPay\Transformer::toXml([
  'return_code' => 'SUCCESS',
  'return_msg' => 'OK'
]);

应答规范	类型	描述
body	object	应答的XML数据结构
return_code	string	业务处理状态码 SUCCESS | FAIL 枚举值之一
return_msg	string	业务处理附加信息

参阅

• 官方文档