Skip to content

支付能力开通 ​

更新时间:2026/10/15 12:07:28

本篇是完整上线指南的第三阶段:让平台具备收款能力。主线是「产品环境 → 通道商户与密钥 → 支付应用 → 通道路由 → 验证」,各配置之间有严格的先后依赖,顺序错了会触发环境不匹配或路由解析失败两类错误。

通道侧(微信/支付宝商户平台)的材料申请不在本篇展开,见支付通道对接与支付通道各篇。

开通主线 ​

产品环境 ​

菜单路径:支付管理 → 接入配置 → 支付产品配置

两层环境控制(机制详解见支付产品配置):

层控制生产要求
全局开关部署配置 sandbox-enabledPROD 模式强制 false,启动时把遗留沙箱产品自动重置为生产
产品环境产品卡片环境单选上线前确认全部产品处于「生产」

环境快照规则(生产上线最容易踩的机制):通道商户创建时按产品当时的环境固化快照,此后不随产品切换改变;环境不一致的通道商户被路由排除、下单直接报错。因此:

  • 沙箱联调期建的通道商户不能复用为生产,生产必须另建一套通道商户与密钥;
  • 「支付主数据」各页只读(通道/产品/能力/渠道/方式),运营侧只做核对,无需关心创建顺序。

通道商户与密钥 ​

入口:商户工作台 → 支付配置 → 通道商户(全局列表在 商户管理 → 通道商户,创建仍须从工作台进入)

生产开通要点(创建与密钥详解见通道商户与支付通道对接):

  • 先切产品环境,再建通道商户(环境固化,见上节);
  • 商户要收款必须至少有一个启用状态的通道商户,后续路由、网关、分账全部挂其上;
  • 支付产品与系统通道商户号创建后不可改,只能改名称;
  • 密钥配置入口按模式分工:
    • 直连模式(微信直连/支付宝直连等):交易密钥在通道商户详情配置,微信在「基础管理 → 直连密钥配置」,支付宝在「应用管理 → 应用卡片 → 密钥配置」;
    • 服务商模式(微信/支付宝 ISV):平台级密钥在产品配置页的「服务商密钥」抽屉,按沙箱/生产各一套;进件只录「号」不录密钥;
  • 沙箱与生产各建一套是常态(沙箱仅支付宝直连支持,微信只能生产小额验证,见支付通道对接)。

支付应用 ​

菜单路径:支付管理 → 支付应用

微信/抖音收款前必须登记支付应用(AppId 所在),两条强规则(类型与绑定详解见支付应用):

  • 支付方式强绑应用类型:wechat_jsapi 只认公众号、wechat_mini 只认小程序、wechat_app 只认移动应用。做对应收款前先登记对应类型,否则路由无法解析;编辑时变更应用类型会清除不兼容的能力绑定;
  • 收银台小程序全平台共用一套凭证,且openId 与收款应用必须同源:平台小程序 AppId 需在所用通道侧完成绑定/报备(服务商模式通常服务商小程序 + 子商户号报备),并非所有通道开箱即用,接入前先与通道确认;这条直接影响网关收款上线。

通道路由 ​

入口:商户工作台 → 应用管理 → 应用工作台 → 通道路由

路由决定「每种支付方式走哪个通道商户」,生产要点(两种策略详解见通道路由):

  • 两种策略二选一:按渠道默认(基础模式,一渠道一通道商户)/ 按支付方式(场景模式,方式+能力成对配置);当前版本无轮询/权重/优先级,一个维度只对应一个通道商户;
  • 切换策略维度后必须点「设为当前生效」并确认,只切单选钮不生效,是「配了路由还是下单失败」的常见原因;
  • 首次打开会初始化默认策略但不配通道商户,需手动补全;
  • 配完用「路由命中预览」核对每个支付方式命中的通道商户与缺口。

域名验证 ​

微信/支付宝在配置域名与二维码规则时会抓取支付网关域名下的校验文件核对归属。两场景两入口,不要传错归属(机制详解见支付通道对接 - 域名校验文件):

场景校验文件上传入口何时需要
商户级MP_verify_*.txt商户端/商户工作台「域名校验文件」商户自己的公众号网页授权、小程序业务域名
平台级随机名 .txt / .html支付管理 → 接入配置 → 域名校验文件收银台/聚合小程序「扫普通链接二维码」规则、支付宝关联普通二维码

网关侧的文件应答反代已在基础设施预留,文件上传后无需改 nginx,但域名须先公网可达。

支付安全与风控 ​

菜单路径:支付管理 → 支付安全

风控是 IP 级防线(开源版),四页关系与全部开关详解见支付安全与风控。生产必须知道的默认值:

项默认生产建议
风控总开关开保持开;关闭则所有检查跳过且不产命中记录
黑名单拦截开保持开(名单全部手动维护,无自动拉黑)
海外 IP / 地区拦截关按业务范围决定;IPv6 匹配精度有限,谨慎开
命中阻断下单开上线初期建议先关(仅记录不拦截),观察无误判后再开
API 签名校验强制不可关
Nonce 防重放 / 时间窗口关与系统安全策略同款评估:要求商户请求带随机数与时间字段

注意:风控检查发生在下单时(普通/网关/码牌均覆盖),退款与转账不经过风控;命中拦截时商户侧只收到统一的「交易被限制」提示(刻意不暴露细节),排查看「风险命中记录」。

验证 ​

每个产品开通完成后,用商户端「开发调试 → 支付调试(普通)」走一遍(操作见从部署到第一笔支付 - 第八步):

  • 生产环境用小额真实支付(如 0.01 元)验证全链路(下单 → 付款 → 回调 → 订单成功);
  • 微信无沙箱,本就只能小额真实验证;
  • 验证失败按支付方式逐环排查:路由命中预览 → 支付应用类型 → 通道密钥 → 产品环境,常见错误对照见支付通道对接 - 常见问题。

本阶段核对清单 ​

  • [ ] 全部产品环境为「生产」,沙箱产品已被自动重置
  • [ ] 每个收款商户至少一个生产通道商户 + 密钥配置完成
  • [ ] 微信/抖音支付应用按收款方式登记齐(类型匹配)
  • [ ] 通道路由已「设为当前生效」,命中预览无缺口
  • [ ] 域名验证两场景按需完成
  • [ ] 风控默认值已复核,「命中阻断」按观察期策略设定
  • [ ] 每个通道产品小额真实支付验证通过

下一阶段:商户开通与对接就绪。