fix: acknowledge signed payment notice before querying provider

This commit is contained in:
stefanfeng
2026-10-20 14:37:02 +08:00
parent 5c992729c4
commit 721f8b990d
5 changed files with 21 additions and 25 deletions
@@ -28,6 +28,6 @@
- `X-Huihui-Timestamp`:Unix 秒级时间戳,允许与本服务时间相差不超过 300 秒。
- `X-Huihui-Signature`:小写十六进制 HMAC-SHA256,待签名数据为 `时间戳 + 换行符 + 原始请求体字节`。组织充值订单使用服务端配置的 `HUIHUI_ORG_CALLBACK_SECRET`(至少 16 字符),微信直连虚拟支付订单使用独立的 `HUIHUI_VIRTUAL_CALLBACK_SECRET`(至少 32 字符)。不要重排 JSON 后签名,也不要把密钥发给前端。
成功接收并查单确认已支付时返回 HTTP 200,`{"code":200,"message":"success","data":{"received":true,"paid":true}}`。如果成功通知先于会会查单状态更新到达,会保存已验签通知并返回 HTTP 200、`{"received":true,"paid":false,"awaitingProvider":true}`;此时**不发放积分**,后台仅对这类通知做有上限的延迟复核,查单确认已支付后才入账。重复通知返回 `duplicate: true`,同一订单及支付流水不会重复入账。验签、字段、订单或金额不符返回 HTTP 4xx。服务端未配置密钥时返回 HTTP 503。
成功通知经签名及本地订单信息核对后,先持久保存并立即返回 HTTP 200、`{"received":true,"paid":false,"awaitingProvider":true}`;回调入口**不等待会会查单**,也**不立即发放积分**。后台仅针对已保存的通知做有上限的延迟复核,待会会查单确认已支付、订单号与支付流水等字段一致后才入账。已入账订单的重复通知返回 `duplicate: true`,不会重复发放积分。验签、字段、订单或金额不符返回 HTTP 4xx。服务端未配置密钥时返回 HTTP 503。
上线前需由会会确认:其服务端是否能按此格式签名并发送通知、支付成功状态与支付流水号字段的正式定义、失败通知及重试/超时策略。小程序支付发起和退款仍需独立对接和验收;仅完成此回调不代表虚拟支付全流程已可用。