异步通知

订单状态变化后，系统会向商户配置的回调地址主动发送通知。

POST商户异步回调地址

商户收到回调后需返回 HTTP 200 和纯文本 OK，系统才会停止重试。

回调说明

• 订单状态变更后，系统会向商户回调地址发送通知。
• 商户需返回 HTTP 200，且响应体为纯文本 OK（大写、无引号、无额外 JSON 包装）。
• 如果商户对接收请求有 IP 限制，请提前告知。

回调验签

• 回调中的 signature 为通知签名，验签规则与请求签名一致。
• 对回调 JSON body 中除 signature 外的所有非空字段按参数名 a-z 排序后，以 key=value 用 & 拼接，末尾追加商户密钥，再使用 SHA256 计算并转为小写十六进制字符串。
• 将计算结果与回调中的 signature 比较，并校验 timestamp 是否在有效时间窗口内；验签失败或业务处理失败时，请返回非 OK 响应。

重试策略

如果未收到符合要求的回执（HTTP 200 且响应体为 OK），系统将自动重试：

• 最大重试次数：24 小时内最多 8 次
• 重试间隔：2s → 5s → 10s → 30s → 1h → 3h → 3h → 3h

请求方式

• POST
• JSON

请求参数

platformOrderNostring必选

唯一平台订单号

merchantOrderNostring必选

商户订单号

orderAmountstring必选

实际支付金额

orderStatusstring必选

订单状态：SUCCESS、PENDING、FAILED、EXPIRED、CANCELLED、REFUNDED

messagestring必选

状态描述消息

completedAtstring可选

交易成功时间（YYYY-MM-DD HH:mm:ss），交易成功时返回

timestampstring必选

毫秒级时间戳

signaturestring必选

回调签名

payMethodstring可选

支付方式（KBZPAY、WAVEPAY）