主题
支付通道总览
DaxPay 将各类支付通道封装为统一接口,业务系统对接一次即可使用全部通道。通道按接入形态分两层:直连通道(5 条,商户直连通道侧开通)与聚合通道(11 条,一次进件受理微信、支付宝、银联等多渠道收款)。
通道、产品与支付方式
三个词的完整辨析见业务术语,这里只说和选型相关的两点:
- 一条通道可以下挂多个支付产品。产品决定接入身份与模式,例如汇付天下通道下挂 Adapay 与斗拱两个产品,银联商务按收款场景拆分 6 个产品。创建通道商户时先选产品,再填通道侧信息。
- 每个产品支持若干支付方式(扫码、JSAPI、APP、H5、小程序、付款码等),方式级清单见各通道页的「支持的支付方式」。
直连通道
| 通道 | 通道编码 | 支付产品 | 接入模式 | 说明 |
|---|---|---|---|---|
| 支付宝 | alipay | alipay / alipay_isv | 直连 / 服务商 | 方式覆盖最全,支持分账接收方绑定 |
| 微信支付 | wechat | wechat_pay / wechat_isv | 直连 / 服务商 | API v3 证书模式,服务商线平台即服务商 |
| 抖音支付 | douyin | douyin_pay | 直连 | 抖音小程序与 APP 场景 |
| 银联支付 | union_pay | union_pay | 银联网关直连 ACP | 云闪付扫码 / H5 / 付款码,RSA2 三证书 |
| 银联商务 | ums_pay | 6 个产品(C扫B / 公众号 / APP / 小程序 / H5 / B扫C) | 直连 | 银联旗下全渠道收单,无证书签名 |
聚合通道
均为聚合收单机构通道,一次进件可受理微信、支付宝、银联等多种付款渠道:
| 通道 | 通道编码 | 支付产品 | 接入模式 | 说明 |
|---|---|---|---|---|
| 汇付天下(Adapay) | huifu | ada_pay | 直连(进件直连型) | 一个应用 ID 覆盖微信 / 支付宝 / 银联全场景 |
| 斗拱支付 | huifu | dougong_pay | 服务商 | 汇付旗下独立进件线,机构二级型 |
| 富友支付 | fuyou_pay | fuyou_pay | 服务商 | 聚合接口,商户号 + 终端号 |
| 海科融通 | hkrt_pay | hkrt_pay | 服务商 | MD5 签名、无需证书,支持在线进件 |
| 河马付 | sand_pay | hm_pay | 服务商 | 杉德旗下产品,底层走杉德通道 |
| 拉卡拉 | lakala_pay | lakala_pay | 服务商 | V3 接口,扫码与付款码 |
| 乐刷支付 | leshua_pay | leshua_pay | 服务商 | 扫码与付款码,MD5 / SM3 签名 |
| 盛付通 | sheng_pay | sheng_pay(sheng_isv 规划中) | 直连 | 普通商户自有密钥对接 |
| 随行付 | vbill_pay | vbill_pay | 服务商 | 天阙接口,含小程序收银台 |
| 易宝支付 | yee_pay | yee_isv | 服务商 | YOP 平台,密钥挂服务商配置 |
| 易支付(通道) | easy_pay | easy_pay | 直连 | 易支付协议通道化接入,开通快、门槛低 |
规划中通道
以下通道的产品主数据已预留、对接尚未实现,正式发布后会陆续开放:
| 通道 | 通道编码 | 支付产品 | 说明 |
|---|---|---|---|
| 星驿付 | xingyi_pay | xingyi_pay | 新大陆旗下国通星驿 |
| 通联支付 | allin_pay | 云商通 / 收银宝 / 收付通 | 三个产品线共用一条通道 |
| 收钱吧 | shouqianba | shouqianba | 门店聚合扫码收单 |
| 建行龙支付 | long_pay | long_pay | 建设银行聚合支付 |
| 银盛支付 | ysep_pay | ysep_pay | 银盛支付服务 |
| 快钱支付 | quick_pay | quick_pay | 快钱清算旗下 |
| Jeepay | jee_pay | jee_pay | 聚合支付平台 |
通用对接流程
所有通道的配置链路同构:开通 / 进件 → 创建通道商户 → 配置通道密钥 → 支付调试验证。
- 通道配置的三段式模型(服务商参数 → 商户进件 / 通道商户创建 → 通道商户管理)与各通道差异速查见通道配置通用操作;
- 支付宝与微信的完整对接教程(含通道侧准备、密钥配置、沙箱联调)见支付通道对接,其他通道流程相同、参数见各通道页;
- 服务商线通道的商户开通走进件体系,申请审核通过后自动生成通道商户绑定;
- 对接完成后用开发者调试发起支付验证链路。
先切环境再建商户
通道商户创建时会按支付产品当时的环境固化沙箱 / 生产快照,此后不随产品切换改变,环境不匹配的通道商户会被路由排除。先在「支付管理 → 通道与产品配置 → 支付和进件产品」切好环境,再创建通道商户,沙箱与生产各建一套。详见从部署到第一笔支付。
通道子应用
通道的实际 SDK 调用运行在独立部署的通道子应用中(子应用一 10100、子应用二 10200),与主应用经加密 HTTP 通信、互不影响;通信不通的排查见 FAQ。
编码字典
以下编码取自系统真实枚举(字典 channel / pay_product / pay_method),以代码为准。通道编码与产品编码见上方两张表,这里补充命名约定与支付方式全表。
编码命名约定
直连品牌通道一般无 _pay 后缀(alipay / wechat / douyin);间连 / 聚合通道多带 xxx_pay 后缀(lakala_pay 等,huifu 除外)。
支付产品
通道路由的真实锚点是产品而非通道:每笔交易先选产品,再由产品定位通道与接入模式。一通道多产品的关键设计:
huifu(汇付天下)→ada_pay+dougong_pay,两个产品共用一条汇付通道;ums_pay(银联商务)→ 6 个产品,按收款场景分别开通;alipay/wechat→ 各 2 个产品,直连 + 服务商(ISV);sand_pay(杉德)→hm_pay,河马付底层走杉德通道。
支付方式
code 全局唯一,每个支付方式绑定一个支付渠道:
| 渠道 | 支付方式 | code |
|---|---|---|
| 聚合 | 聚合扫码 | aggregate_pay_qrcode |
| 微信 | 微信小程序收银台 | wechat_cashier |
| 微信 | 微信扫码(Native) | wechat_qr |
| 微信 | 微信 JSAPI | wechat_jsapi |
| 微信 | 微信小程序 | wechat_mini |
| 微信 | 微信 H5 | wechat_h5 |
| 微信 | 微信 APP | wechat_app |
| 微信 | 微信付款码 | wechat_barcode |
| 支付宝 | 支付宝扫码 | alipay_qr |
| 支付宝 | 支付宝 JSAPI(含小程序) | alipay_jsapi |
| 支付宝 | 支付宝电脑支付 | alipay_pc |
| 支付宝 | 支付宝 H5 | alipay_h5 |
| 支付宝 | 支付宝 APP | alipay_app |
| 支付宝 | 支付宝付款码 | alipay_barcode |
| 银联 | 银联扫码 | union_qr |
| 银联 | 银联 JSAPI | union_jsapi |
| 银联 | 银联 H5 | union_h5 |
| 银联 | 银联付款码 | union_barcode |
| 抖音 | 抖音扫码 / JSAPI / H5 / APP | douyin_qr / douyin_jsapi / douyin_h5 / douyin_app |
| 其他 | 其他支付方式 | other(无固定渠道归属) |
付款码的识别规则
被扫收款不提供聚合付款码方式:商户只需传 authCode、不传 method,平台按付款码前缀识别所属渠道后映射为 wechat_barcode / alipay_barcode / union_barcode 再走路由。前缀规则:微信 10–15、支付宝 25–30、银联 62。
选型建议
- 只需国内主流收款:直连通道即可覆盖,支付宝 + 微信是绝大多数场景的标配;
- 需要一码多渠道收款或线下门店聚合:选择聚合通道,一次进件受理多渠道,具体机构按费率与当地服务能力选择;
- 服务商(帮子商户收款)模式:支付宝 / 微信支持 ISV 模式,聚合通道多数为服务商模式;代理商以服务商身份代管商户通道配置的玩法见代理商体系;
- 通道相关的排查问题(回调验签失败、IP 白名单、子应用通信等)见 FAQ。