2.2 KiB
2.2 KiB
会会微信小程序虚拟支付回调（待双方确认）
本项目为会会服务端预留固定回调地址：
POST https://digital.99hui.com/api/token/payment/huihui/virtual/notify
回调报文及签名协议尚未与会会确认。以下是本项目实现的拟议对接契约，双方确认并安全交换密钥后才能进行测试支付。接口代码部署与会会联调通过是两个独立状态。它不替代现有微信直连回调 /api/token/payment/wechat/virtual/notify。
请求体为 JSON，成功支付示例：
{
"orderNo": "AV202610150000000000000001",
"paymentNo": "会会侧唯一支付流水号",
"status": "SUCCESS",
"amountCents": 1000,
"productId": "points_plan_1",
"openId": "微信小程序用户 OpenID",
"env": 1
}
amountCents 单位为分，env 为微信虚拟支付环境（0 正式、1 沙箱）。非成功结果可发送 status: "FAILED"，但不会入账。订单号、支付流水号和状态必填；成功结果还必须提供金额、商品 ID、OpenID、环境。仅在订单属于微信虚拟支付，且上述信息与本地订单、套餐、用户一致时入账。重复成功通知不会重复发放积分；同一支付流水号不能用于其他订单。
请求头：
X-Huihui-Timestamp：Unix 秒级时间戳，允许与本服务时间相差不超过 300 秒。X-Huihui-Signature：小写十六进制 HMAC-SHA256，密钥为双方线下安全交换、服务端配置的HUIHUI_VIRTUAL_CALLBACK_SECRET（至少 32 字符），待签名数据为时间戳 + 换行符 + 原始请求体字节。不要重排 JSON 后签名，也不要把密钥发给前端。
成功接收返回 HTTP 200，{"code":200,"message":"success","data":{"received":true,"paid":true}}。重复通知返回 duplicate: true。验签、字段、订单或金额不符返回 HTTP 4xx，会会可按其重试策略处理。服务端未配置密钥时返回 HTTP 503。
上线前需由会会确认：其服务端是否能按此格式签名并发送通知、支付成功状态与支付流水号字段的正式定义、失败通知及重试/超时策略。小程序支付发起和退款仍需独立对接和验收；仅完成此回调不代表虚拟支付全流程已可用。