4. 支付渠道接入
支付网关的核心价值之一，是把外部多样、异构、协议各异的支付渠道统一封装成内部稳定的标准接口。渠道接入不是“调通一个接口”那么简单，它涉及渠道类型划分、接入流程、协议适配、签名验签、证书管理、参数配置与灰度策略等一整套工程化能力。本节围绕这条主线，讲清每一步的关键原理与落地方法。
4.1 渠道类型与接入形态
从网关视角看，支付渠道可按业务能力与接入方式两个维度分类。业务能力上分为：收单渠道（微信、支付宝、银联）、代付渠道（银行代付、第三方代付）、退款渠道、对账渠道。接入方式上分为：直连渠道（网关直接对接渠道API）、间连渠道（通过聚合服务商）、文件渠道（对账文件、批量代付文件）。不同形态决定了协议适配与签名策略的差异。
| 渠道类型 | 典型协议 | 签名方式 | 接入要点 |
|---|---|---|---|
| 微信支付 | HTTPS + JSON/XML | MD5 / RSA / 国密 | 证书双向认证、平台证书轮换 |
| 支付宝 | HTTPS + 表单/JSON | RSA2 | 应用私钥签名、支付宝公钥验签 |
| 银联全渠道 | HTTPS + 表单 | RSA + 证书 | 签名证书与验签证书分离 |
| 银行代付 | HTTPS / SFTP | RSA / 对称密钥 | 文件加解密、批量回执 |
4.2 接入流程：从申请到上线
一个渠道从零到上线，通常经历六个阶段：渠道调研与选型、商户号与密钥申请、协议适配开发、联调测试、参数配置、灰度上线。每个阶段都有明确的交付物，缺一不可。
- 渠道调研：确认费率、限额、结算周期、退款规则、对账方式。
- 资质申请：提交商户资料，获取商户号、AppID、密钥、证书。
- 协议适配：将渠道报文映射为内部统一模型，处理字段差异。
- 联调测试：在沙箱环境验证下单、支付、退款、查询、对账全链路。
- 参数配置：将渠道参数写入配置中心，支持动态生效。
- 灰度上线：按流量比例或商户白名单逐步放量，观察成功率与耗时。
4.3 协议适配与签名验签
协议适配的本质是“翻译层”：对外适配渠道的报文格式与传输方式，对内输出统一的支付请求与响应模型。常见差异包括字段命名、金额单位（分/元）、编码格式、时间格式、成功标识。适配层应做到渠道差异不外泄，业务层只感知标准接口。
签名验签是渠道接入的安全基石。请求时用商户私钥对报文签名，渠道用商户公钥验签；响应或回调时渠道用其私钥签名，网关用渠道公钥验签。核心原则：签名前必须按渠道规则拼接或规范化报文，任何字段顺序、空值处理、编码差异都会导致验签失败。
// 签名示例（伪代码）
String signContent = buildSignContent(params); // 按渠道规则排序拼接
String sign = RSA.sign(signContent, merchantPrivateKey, "SHA256withRSA");
params.put("sign", sign);
// 验签示例
boolean ok = RSA.verify(buildSignContent(callbackParams),
callbackParams.get("sign"),
channelPublicKey, "SHA256withRSA");
if (!ok) { throw new SignatureException("渠道回调验签失败"); }4.4 证书管理与参数配置
证书管理要解决三个问题：存储安全、轮换平滑、过期告警。私钥必须加密存储，禁止硬编码在代码或明文配置中；平台证书存在有效期，需支持双证书并行与自动轮换；到期前应提前告警，避免线上验签突然失败。
渠道参数配置建议集中到配置中心，按渠道维度管理：商户号、AppID、密钥引用、回调地址、限额、费率、开关。配置变更应支持热更新与版本回滚，避免重启发布。敏感字段只存引用，不落明文。
4.5 灰度策略与上线复盘
灰度是控制渠道接入风险的关键手段。可按商户白名单、流量比例、金额阈值、渠道优先级四个维度组合放量。灰度期间重点观察：支付成功率、平均耗时、验签失败率、回调延迟、对账差异。一旦指标异常，立即回滚配置或切回备用渠道。
复盘时建议形成渠道接入检查清单：密钥是否加密存储、证书有效期是否监控、签名规则是否覆盖空值与编码、回调是否幂等、对账是否自动核对、灰度指标是否可观测。把每次接入的经验沉淀为模板，下一个渠道的接入成本会显著下降。