wechatpay.im

主题模式

退款结果通知(XML) ​

当商户申请的退款有结果后（退款状态为：退款成功、退款关闭、退款异常），微信会把相关结果发送给商户，商户需要接收处理，并返回应答。

注意：

  • 当商户申请的退款有结果后（退款状态为：退款成功、退款关闭、退款异常），微信会把相关结果发送给商户，商户需要接收处理，并返回应答。
  • 对后台通知交互时，如果微信收到商户的应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功（通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m）。
  • 注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
  • 推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
  • 特别说明：退款结果对重要的数据进行了加密，商户需要用商户密钥进行解密后才能获得结果通知的内容
请求参数类型描述
headersobject通知的头参数
Request-IDstring通知的唯一标识
Content-Typestringtext/xml
bodyobject通知的XML数据结构
return_codestring返回状态码
return_msgstring返回信息
appidstring公众平台APPID
mch_idstring商户号
sub_mch_idstring子商户号
sub_appidstring子商户应用ID
nonce_strstring随机字符串
req_infostring加密的XML信息
out_refund_nostring商户退款单号
out_trade_nostring商户订单号
refund_accountstring退款资金来源
refund_feestring申请退款金额
refund_idstring微信退款单号
refund_recv_accoutstring退款入账账户
refund_request_sourcestring退款发起来源
API | VENDOR_PLATFORM 枚举值之一
refund_statusstring退款状态
SUCCESS | CHANGE | REFUNDCLOSE 枚举值之一
settlement_refund_feestring退款金额
settlement_total_feestring应结订单金额
success_timestring退款成功时间
total_feestring订单金额
transaction_idstring微信支付订单号
cash_refund_feestring用户退款金额
  1. 服务商支付成功会带上(sub_appid及sub_mch_id)字段
php
// 使用Psr标准规范，示例如何处理(取值、转换、解密)「回调通知」事件，WebServer不同，用法略有差异，供参考实现。
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 (!\array_key_exists('req_info', $inBodyArray)) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知的XML数据异常');
  }

  $cipherKey = \WeChatPay\Crypto\Hash::md5($apiv2Key);

  $plaintext = \WeChatPay\Crypto\AesEcb::decrypt($inBodyArray['req_info'], $cipherKey);

  $inBodyArray['refund'] = \WeChatPay\Transformer::toArray($plaintext);

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

// do your business
// ...
// ...
$xml = \WeChatPay\Transformer::toXml([
  'return_code' => 'SUCCESS',
  'return_msg' => 'OK'
]);
应答规范类型描述
bodyobject应答的XML数据结构
return_codestring业务处理状态码
SUCCESS | FAIL 枚举值之一
return_msgstring业务处理附加信息

参阅

Published on the GitHub by TheNorthMemory