支付产品配置
支付产品是「商户能用哪种支付方式」的聚合载体:商户开通通道商户时选择产品,产品的能力决定他能发起哪些支付。平台以服务商身份对接通道时,产品级的密钥、证书、应用也在本页维护。菜单:支付管理 → 接入配置 → 支付产品配置。
三层模型:通道 → 产品 → 能力
| 层 | 例子 | 说明 |
|---|---|---|
| 支付通道 | 微信、支付宝、拉卡拉 | 对接的支付机构 |
| 支付产品 | 微信支付(服务商)、微信支付(直连)、拉卡拉 | 同一通道可拆多个产品,服务商与直连是不同产品 |
| 支付能力 | JSAPI、小程序、付款码、H5、扫码 | 产品在每种支付方式下可用的收银能力 |
产品清单是系统内置的,不能新增或删除;想了解系统支持哪些产品、各产品挂了哪些能力,去支付管理 → 支付主数据 → 支付产品页只读查看。
产品配置页
配置页是产品卡片网格,每张卡片展示产品图标、名称、启用状态(绿点/灰点),以及底部两个入口:
- 生产配置:进入该产品的生产环境配置详情;
- 沙箱配置:仅当产品支持沙箱且平台沙箱开关开启时出现。
卡片右上角的环境单选(生产/沙箱)用于切换产品当前生效的环境,切换会弹二次确认。沙箱开关由部署配置决定:生产环境部署必须关闭沙箱,此时整个界面不会出现任何沙箱入口(详见配置说明)。
配置详情页
从卡片进入详情页后:
- 右上角是产品启停开关。停用后无法发起新的支付,但存量订单的退款、同步、回调不受影响;重新启用即恢复。
- 页面按产品分发到对应的配置子页。需要平台级配置的产品(基本都是服务商/聚合模式)才有子页,例如:
| 产品 | 配置内容 |
|---|---|
| 支付宝(服务商) | 服务商应用管理:应用 ID、密钥(公钥/证书两种模式)、子商户授权 |
| 微信(服务商) | 服务商商户号与 API 证书密钥、微信支付应用管理、产品级默认支付应用 |
| 拉卡拉 | 服务商密钥(应用号、机构代码、证书序列号、公私钥)、微信应用关联 |
| 汇付/斗拱、乐刷、富友、盛付通等 | 结构类似:服务商密钥/证书 + 微信应用绑定 |
直连类产品(支付宝直连、微信直连、云闪付、抖音、Stripe、银联商务系列等)没有产品级配置页——它们的密钥在各个通道商户侧配置,详情页会提示暂不支持。
配置完整性徽标
子页卡片右上角有检查徽标:绿色对勾表示该产品的必配项(如服务商密钥、默认应用)已配齐,橙色感叹号表示有缺项。配置完以徽标转绿为准,缺项时依赖它的支付可能失败。
环境与沙箱
产品的环境机制围绕「沙箱联调」设计,三个要点:
- 全局总开关:部署配置
daxpay.platform.config.sandbox-enabled。生产部署必须为false(关闭时系统启动还会把遗留的沙箱产品强制重置回生产);测试环境可开启用于联调。 - 切换不回写存量:把产品从沙箱切回生产,只影响之后新建通道商户的默认环境和路由目标,已有的沙箱通道商户标识不变——同一产品下可以同时存在沙箱商户和生产商户。
- 路由会校验环境一致:沙箱通道商户只能被沙箱环境的产品命中,反之亦然;不一致时下单会被路由拒绝并明确报出是哪个通道商户与产品不匹配。
因此联调结束切换环境后,需要为生产环境另建通道商户并更新路由,而不是复用沙箱时期建的。
与通道商户、路由的关系
支付产品(本页配置密钥/应用、启停、环境)
└── 通道商户(创建时选定产品,固化环境标识)
└── 通道路由(按渠道/支付方式映射到通道商户)产品停用或环境不匹配,都会在路由环节拦下新的支付;所以「下单失败」排查时,先看产品状态与环境,再看通道商户与路由。