通道与支付方式
以下编码均取自开源版真实枚举类,以代码为准。
概念辨析(支付渠道 / 支付方式 / 支付通道 / 支付产品 / 支付能力)见 业务术语。
支付通道 ChannelEnum
字典: channel。共定义 17 个通道枚举(按源码声明顺序)。
- 已实现 — 主应用
daxpay-channel/下有完整策略实现(支付 / 关闭 / 同步 / 退款),其中部分通过通道子应用独立部署承载 SDK 调用。 - 预留 — 仅枚举定义,暂无实现代码,可按需扩展。
| code | 通道 | 状态 | 说明 |
|---|---|---|---|
alipay | 支付宝 | 已实现 ✅ | 支持直连 + 服务商(ISV) |
wechat | 微信支付 | 已实现 ✅ | 支持直连 + 服务商(ISV) |
union_pay | 云闪付 | 预留 | — |
leshua_pay | 乐刷 | 已实现 ✅ | — |
vbill_pay | 随行付 | 已实现 ✅ | — |
huifu | 汇付天下 | 已实现 ✅ | 下挂 ada_pay / dougong_pay 两个产品(见产品表) |
hkrt_pay | 海科融通 | 已实现 ✅ | — |
lakala_pay | 拉卡拉 | 已实现 ✅ | — |
fuyou_pay | 富友 | 已实现 ✅ | — |
sheng_pay | 盛付通 | 预留 | — |
ysep_pay | 银盛 | 预留 | — |
quick_pay | 快钱 | 预留 | — |
sand_pay | 杉德 | 已实现 ✅ | 通过河马付(hm_pay 产品)间接对接(见产品表) |
yee_pay | 易宝 | 已实现 ✅ | 通道子应用 channel-two 已实现,启动模块暂未启用 |
ums_pay | 银联商务 | 已实现 ✅ | — |
douyin | 抖音支付 | 已实现 ✅ | 直连品牌无 _pay 后缀 |
命名约定
直连品牌通道一般无 _pay 后缀(wechat / alipay / douyin);间连 / 聚合通道可带 xxx_pay(lakala_pay / huifu 除外,详见 业务术语 的「编码约定」小节)。
支付产品 ProductEnum
字典: pay_product。共定义 24 个支付产品(按源码声明顺序)。每个产品绑定一个支付通道(通过 ProductEnum.getChannel() 映射),通道路由的真实锚点是产品而非通道(详见 业务术语)。
- 已实现 — 有对应的
daxpay-channel-*策略实现(支付 / 关闭 / 同步 / 退款),共 20 个。 - 预留 — 仅枚举定义,暂无实现代码,共 4 个。
支付宝
| code | 含义 | 通道 |
|---|---|---|
alipay | 支付宝(直连) | alipay |
alipay_isv | 支付宝(服务商) | alipay |
微信支付
| code | 含义 | 通道 |
|---|---|---|
wechat_pay | 微信支付(直连) | wechat |
wechat_isv | 微信支付(服务商) | wechat |
抖音支付
| code | 含义 | 通道 |
|---|---|---|
douyin_pay | 抖音支付 | douyin |
银联商务
| code | 含义 | 通道 |
|---|---|---|
ums_qrcode | 银联商务(C扫B) | ums_pay |
ums_jsapi | 银联商务(公众号) | ums_pay |
ums_app | 银联商务(APP) | ums_pay |
ums_mini | 银联商务(小程序) | ums_pay |
ums_h5 | 银联商务(H5) | ums_pay |
ums_barcode | 银联商务(B扫C) | ums_pay |
第三方聚合通道
| code | 含义 | 通道 | 状态 |
|---|---|---|---|
lakala_pay | 拉卡拉 | lakala_pay | 已实现 ✅ |
leshua_pay | 乐刷 | leshua_pay | 已实现 ✅ |
ada_pay | Adapay | huifu | 已实现 ✅ |
dougong_pay | 斗拱 | huifu | 已实现 ✅ |
hkrt_pay | 海科融通 | hkrt_pay | 已实现 ✅ |
vbill_pay | 随行付 | vbill_pay | 已实现 ✅ |
fuyou_pay | 富友 | fuyou_pay | 已实现 ✅ |
hm_pay | 河马付(杉德旗下) | sand_pay | 已实现 ✅ |
yee_pay | 易宝 | yee_pay | 已实现 ✅ |
sheng_pay | 盛付通 | sheng_pay | 预留 |
ysep_pay | 银盛 | ysep_pay | 预留 |
quick_pay | 快钱 | quick_pay | 预留 |
一通道多产品
部分通道下挂多个产品,是通道路由的关键设计:
huifu(汇付天下)→ada_pay+dougong_pay— 两个产品共用一条汇付通道ums_pay(银联商务)→ 6 个产品 — C扫B / 公众号 / APP / 小程序 / H5 / B扫C 分别独立进件sand_pay(杉德)→hm_pay— 河马付底层走杉德通道alipay/wechat→ 各 2 个产品 — 直连 + 服务商(ISV)
支付方式 PayMethodEnum
字典: pay_method。code 全局唯一,每个支付方式绑定一个支付渠道(provider)。
付款码不再提供聚合
aggregate_pay_barcode。被扫时由平台按authCode前缀识别后映射为wechat_barcode/alipay_barcode/union_barcode,再走通道路由。
规则:微信10–15、支付宝25–30、银联62。商户可只传authCode、不传method。
聚合支付
| code | 含义 | 说明 |
|---|---|---|
aggregate_pay_qrcode | 聚合扫码支付 | 通道原生通扫码 |
微信支付
| code | 含义 |
|---|---|
wechat_cashier | 微信小程序收银台 |
wechat_qr | 微信扫码(Native) |
wechat_jsapi | 微信 JSAPI |
wechat_mini | 微信小程序 |
wechat_h5 | 微信 H5 |
wechat_app | 微信应用支付 |
wechat_barcode | 微信付款码 |
支付宝
| code | 含义 |
|---|---|
alipay_qr | 支付宝扫码 |
alipay_jsapi | 支付宝 JSAPI(含小程序,官方产品码 JSAPI_PAY) |
alipay_pc | 支付宝电脑支付 |
alipay_h5 | 支付宝 H5 |
alipay_app | 支付宝应用支付 |
alipay_barcode | 支付宝付款码 |
银联
| code | 含义 |
|---|---|
union_qr | 银联扫码 |
union_jsapi | 银联 JSAPI |
union_h5 | 银联 H5 |
union_barcode | 银联付款码 |
抖音
| code | 含义 |
|---|---|
douyin_qr | 抖音扫码支付 |
douyin_jsapi | 抖音 JSAPI 支付 |
douyin_h5 | 抖音 H5 支付 |
douyin_app | 抖音 APP 支付 |
卡组 (Visa / MasterCard)
| code | 含义 |
|---|---|
visa_card_gateway | Visa 网关支付 |
visa_card_present | Visa 刷卡支付 |
mastercard_card_gateway | 万事达网关支付 |
mastercard_card_present | 万事达刷卡支付 |
其他
| code | 含义 | 说明 |
|---|---|---|
other | 其他支付方式 | 无固定渠道归属,provider 为 null |
通道实现架构
主应用通过 HTTP 调用独立部署的通道子应用,隔离第三方 SDK 依赖、支持独立升级与弹性伸缩。通道与子应用的对应关系、端口、SDK 版本等详见 应用介绍。
- 通道策略层 — 统一在主应用
daxpay-channel/下(支付 / 关闭 / 同步 / 退款策略编排,不含 SDK) - 通道子应用 —
dax-pay-channel-one(支付宝/微信/抖音/银联商务,端口 20100)、dax-pay-channel-two(拉卡拉/海科融通/斗拱/乐刷/随行付/河马付/Adapay/富友,端口 20200)
新增通道可参照 dax-pay-channel-one / dax-pay-channel-two 创建独立子应用。