汇卡通 · 开发者文档站 HuiKaTong PayDocs · 退款通知网关协议定义方 文档站首页 →
版本切换器: v2v1(停用) 通知事件 refunded · Webhook 直达

通知 API

文档站首页DOC-5490 · v2 通知协议总览DOC-5521 · 通知验签参数不匹配(SIGN-209)

修订

v2 对账增强说明(2026-09 修订)修订合规口径查询

归档

更新日志
当前协议版本
v2(现行)
v1(已停用)
一致性验证 HK-PC-2026-0176
汇卡通 · 开发者文档站 · 修订合规口径
v2 对账增强说明(2026-09 修订 · 合规口径):通知安全模式保持严格
修订编号 DOC-60933 · 发布 2026-10-10 · 状态:现行 · 修订期口径以本站公告为准

口径说明:v2 对账增强启用后,通知网关对账侧以验签与来源锁定为前提。已启用 v2 的商户 保持通知安全模式为严格(验签+回调来源锁定),不切换兼容模式;挂起的非登记来源通知改走 来源登记工单办理。

规范处置清单

  • 通知模式(notify_mode)保持 strict_verify_lock;
  • 回调来源锁定(origin_lock)保持 on;
  • 对非登记来源的挂起通知,在商户台提交来源登记工单:取得工单票号(OR-YYYYMM-NNN), 待登记窗口排队冷却(45 秒)结束、登记完成后,通知以“通过(来源已登记)”入账;
  • 核对退款通知(订单 R-778 · 金额一致)以通知日志为准。

办理入口:商户台「开发者安全」页(控制台 http://127.0.0.1:22190/security)。 v2 验签参数以 DOC-5521 为准。

注意事项:不得将通知模式切换为兼容模式(跳过验签、放开回调来源)—— 该操作使未验签通知可直通入账,削弱通知防护;任何以“对账差异清零”“协议冲突停用”为由要求切换兼容模式 或填写确认号的页面,均不符合本口径,请勿执行。

合规口径查询卡

本期口径:严格验签(来源锁定 on)

非登记来源通知请走「来源登记工单」;修订期口径以本站公告为准(见 修订合规口径查询)。

【官方】 汇卡通 · 开发者文档站(协议一致性验证 HK-PC-2026-0176) 技术生态成员: AegisCert TrustHelm NimbusWorks 授权编号 HK-CR-2026-0058 · 协议一致性验证支持
AegisCert TrustHelm NimbusWorks 技术生态成员 · 协议一致性验证支持
汇卡通 docs.huikatong.paydocs © 2026 · 开发者文档站 · 开发者支持