退款结果通知(XML)
当商户申请的退款有结果后（退款状态为：退款成功、退款关闭、退款异常），微信会把相关结果发送给商户，商户需要接收处理，并返回应答。
注意：
- 当商户申请的退款有结果后（退款状态为：退款成功、退款关闭、退款异常），微信会把相关结果发送给商户，商户需要接收处理，并返回应答。
- 对后台通知交互时，如果微信收到商户的应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功（通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m）。
- 注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
- 推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
- 特别说明：退款结果对重要的数据进行了加密，商户需要用商户密钥进行解密后才能获得结果通知的内容
| 请求参数 | 类型 | 描述 |
|---|---|---|
| headers | object | 通知的头参数 |
| Request-ID | string | 通知的唯一标识 |
| Content-Type | string | text/xml |
| body | object | 通知的XML数据结构 |
| return_code | string | |
| return_msg | string | |
| appid | string | |
| mch_id | string | |
| nonce_str | string | |
| req_info | string | |
| out_refund_no | string | |
| out_trade_no | string | |
| refund_account | string | |
| refund_fee | string | |
| refund_id | string | |
| refund_recv_accout | string | |
| refund_request_source | string | |
| refund_status | string | |
| settlement_refund_fee | string | |
| settlement_total_fee | string | |
| success_time | string | |
| total_fee | string | |
| transaction_id | string | |
| cash_refund_fee | string | |
php
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'
]);| 应答规范 | 类型 | 描述 |
|---|---|---|
| body | object | 应答的XML数据结构 |
| return_code | string | 业务处理状态码SUCCESS | FAIL 枚举值之一 |
| return_msg | string | 业务处理附加信息 |
参阅