D3-04网关与适配层1 分钟更新于 2026-11
协议差异
一句话
签名、编码、字段名、金额单位、时间格式、错误码——六个地方每家都不一样,全靠适配器翻译。
协议差异
它解决什么
渠道协议有六处差异:签名(RSA/HMAC)、编码(表单/JSON/XML)、字段名、金额单位(分/元)、时间格式、错误码。适配器的职责就是把这些翻译成统一语义,业务层不该知道任何渠道字段名。任何一处翻译错了,都会在某个渠道上以奇怪的方式失败。
怎么用
- 业务字段映射
- 单位统一为分
- 时间统一 UTC
- 错误码映射
一个判断
某系统把元当分传给渠道,一笔 100 元变成 1 元,当天 200 笔全部金额错。
边界
协议的边界是「金额单位」:分与元差 100 倍,且不会报错,只会金额错。
一个反例
某系统把元当分传给渠道,一笔 100 元变成 1 元,当天 200 笔全部金额错。现在统一用最小单位,适配器做单位转换测试。
常见误判
- 把渠道响应透传给业务层(改字段名就崩)
- 金额单位混用(分/元错一位就是 100 倍)
- 时间按本地时区解析(跨时区差错)
自查清单
- 知道这个模块的边界在哪
- 知道它的状态机有哪几个状态
- 知道它出错时的兜底路径
- 知道它的数据存在哪张表
依据
- 渠道协议的主要差异点
相关:通道管理系统设计
相关阅读