99Agent 文档

主题

支付配置 ​

扩展包

本页功能由商业扩展包提供（服务端 COMMERCE_PACK_ENABLED，管理端 VITE_COMMERCE_ENABLED）。关闭或删除该包后，本页菜单与接口一并消失。开关说明见 扩展包开关与裁剪。

用户付款前看到哪些入口、这些入口按什么顺序展示，都在支付配置里设置。具体商户号、密钥和证书仍在 支付参数 中填写。

后台入口 ​

  • 菜单路径：支付财务 → 支付配置
  • 后台地址：/payment/payment

支付方式 ​

支付方式可选渠道适用场景
微信支付微信官方、易支付国内用户、微信公众号或微信环境支付
支付宝支付宝官方、易支付国内用户、网页或移动端支付宝支付
PayPalPayPal 官方、易支付海外用户、美元收款
StripeStripe 官方海外银行卡、信用卡等支付方式

每个支付方式都包含三个配置项：启用状态、支付渠道、优先级。

系统只按本页面当前保存的支付方式配置决定用户端展示入口，不会再根据旧版支付开关自动推断或迁移渠道。新部署或未上线环境请直接在本页逐项开启，并在 支付参数 中补齐对应渠道资料。

配置项怎么填 ​

配置项作用从哪里判断填写建议
启用状态控制用户端是否展示该支付方式支付财务 → 支付配置 → 对应支付方式卡片对应渠道在 支付参数 中显示“已配置”，并完成支付测试后再开启
支付渠道决定后台实际调用哪一套收款参数支付方式卡片中的“支付渠道”下拉框微信、支付宝、PayPal 可选择官方或易支付；Stripe 当前固定为 Stripe 官方
优先级控制用户端收银台展示顺序支付方式卡片中的“优先级”数字输入框数字越小越靠前，建议使用 1、2、3、4 这种不重复的顺序

启用状态 ​

开启后，用户端才会看到对应支付方式。建议在对应渠道显示“已配置”并跑通测试后再开启。否则用户可能能看到支付入口，但实际下单会失败。

支付渠道 ​

用户端展示的支付方式和后台实际调用的渠道可以不同：例如用户端显示“支付宝”，后台可以走“支付宝官方”，也可以走“易支付”。切换渠道不改变用户端展示，可按运营需要调整。

用户端支付方式可选渠道渠道参数在哪里填说明
微信支付微信官方、易支付支付参数 → 微信官方支付或易支付微信官方适合企业微信支付商户；易支付适合接入聚合服务商
支付宝支付宝官方、易支付支付参数 → 支付宝官方支付或易支付支付宝官方需要支付宝开放平台应用；易支付字段以服务商后台为准
PayPalPayPal 官方、易支付支付参数 → PayPal 官方或易支付PayPal 官方使用美元收款；部分易支付服务商也可能代理海外支付
StripeStripe 官方支付参数 → Stripe 官方当前只支持 Stripe 官方渠道

优先级 ​

  • 数字越小，展示越靠前。
  • 常见顺序：微信支付 1、支付宝 2、PayPal 3、Stripe 4。
  • 如果某个渠道更稳定或手续费更低，可以把它放到更靠前的位置。

渠道状态 ​

支付渠道下拉项会显示“已配置”或“未配置”。

状态含义
已配置当前渠道的必填参数已填写完整，例如商户号、密钥、证书、公钥、Webhook Secret 等
未配置当前渠道缺少必要参数，或者当前验签/API 版本对应的条件字段未补齐

“已配置”只代表字段完整，不代表第三方平台审核、产品开通、域名回调和真实支付都已经通过。正式开放前仍要使用 支付参数 的“支付测试”跑完整链路。

推荐开启方式 ​

只面向国内用户 ​

  • 开启微信支付和支付宝。
  • 优先使用官方渠道；如果资质暂时不满足，可先使用易支付。
  • PayPal 和 Stripe 可暂时关闭。

同时面向海外用户 ​

  • 保留微信支付和支付宝。
  • 额外开启 PayPal 或 Stripe。
  • 套餐设置中同步维护美元价格。

刚部署测试 ​

  • 先只开启一个渠道，跑通完整支付测试。
  • 确认订单状态、账户明细、用户余额都正常后，再逐步开启其他支付方式。

常见问题 ​

开启后用户端不显示支付入口？ ​

先确认该支付方式已启用，再确认选择的渠道是否已配置。如果渠道仍显示“未配置”，请回到 支付参数 补齐参数。

为什么 Stripe 的支付渠道不能切换？ ​

当前 Stripe 只支持 Stripe 官方渠道，因此后台固定为 Stripe官方。

修改后需要手动保存吗？ ​

不需要。页面会在切换开关、选择渠道或修改优先级时自动保存，看到“保存成功”提示后即生效。

相关文档 ​