交易结果通知
支付、代付、退款等交易结果的异步通知约定
在交易到达终态后会向商户系统发送异步通知，用于同步支付、代付、退款等交易结果。
通知时机
以下场景通常会触发交易结果通知：
- 支付成功
通知仅表示平台已收到渠道结果，商户仍应通过查询接口做最终对账。
通知方式
- 协议：
HTTPS - 请求方式：
POST Content-Type：application/json- 编码：
UTF-8 - 通知地址：商户在接入时配置或每次请求时上送
通知报文
通知报文遵循统一请求报文结构，公共字段请参考请求报文。
{
"clientId": "60e55819aa99a10d42916bf3",
"trk": "传输秘钥 Base64",
"timestamp": 1788968481518,
"randomString": "e8fd19b3b67a4b60aae61243c69aa602",
"payload": "加密后的业务报文 Base64",
"charset": "UTF-8",
"signType": "RSA",
"sign": "平台签名 Base64"
}解密后的payload内容与下单时返回的数据结构一致，包含交易号、商户订单号、金额、币种、交易状态等字段。
签名与验签
商户收到通知后，应按签名计算规则校验 sign。
验签步骤：
- 使用平台公钥校验通知签名。
- 校验
timestamp、randomString、payload是否完整。 - 解密
payload，获取业务结果。 - 校验商户订单号、交易号是否与本地记录一致。
- 校验金额、币种和交易状态。
验签失败时不要更新订单状态，应记录告警并拒绝处理。
响应约定
商户处理完成后，应返回 HTTP 状态码 200
重试与幂等
- 平台在未收到成功响应时会按策略重试。
- 商户必须保证通知处理具备幂等性，同一交易号重复通知不能重复入账。
- 建议按
auditNumber+ status` 建立幂等键。
安全建议
- 通知地址必须使用
HTTPS。 - 验签前不要信任任何业务字段。
- 不要将密钥、敏感信息打印到日志。
- 回调处理超时时，应先记录待处理状态，再通过查询接口确认最终结果。