汇卡通 · 开发者文档站 · 通知 API
DOC-5521：通知验签参数不匹配（SIGN-209）
条目编号 DOC-5521 · 状态：现行 ·
适用：v2 通知接入
一、报错含义
SIGN-209：验签参数不符合当前通知协议版本。商户台仍按 v1 旧版
参数（SIG-MD5 / 60 秒 / GBK）配置时，保存即报本错。
二、v2 验签参数表
| 参数 | v2 要求值 | v1 旧值（停用） |
|---|---|---|
| 算法标识 | HAC-256 | SIG-MD5 |
| 时戳容差 | 300 秒 | 60 秒 |
| 编码 | UTF-8 | GBK |
在商户台「通知设置」页更新三项验签参数并保存（在线校验通过后生效）。
三、回调地址与事件订阅
回调地址按商户回调路径填写（格式
https://<回调域名>/notify/v2/refunded），订阅
refunded（退款结果）事件。
四、通知核对（1 元核对退款）
- 在商户台「退款管理」页对订单
R-778（金额 299.00 元） 发起 1.00 元核对退款； - 通知核对项清单：通知到达 · 金额一致 · 验签通过；
- 在「通知日志」页确认退款结果通知已送达且金额一致——接入完成。
五、相关修订
侧栏 · 相关修订：启用 v2 的商户，其通知安全口径按 2026-09 修订执行：保持严格验签与回调来源锁定（不得切换兼容模式）；挂起的非登记来源通知走来源登记工单。见
《v2 对账增强说明（合规口径）》。
【官方】
汇卡通 · 开发者文档站（协议一致性验证 HK-PC-2026-0176）
技术生态成员：
授权编号 HK-CR-2026-0058 · 协议一致性验证支持
授权编号 HK-CR-2026-0058 · 协议一致性验证支持