支付设置
支付设置
支付设置用于维护商城支付方式的收款账户,配置渠道凭证、限额与健康状态。
入口路径
后台顶部菜单 →「设置」→「支付设置」。实际地址:/system/setting/pay(组件位于 plugin/pay),需要管理员权限(canAdmin)。
功能说明
页面展示已配置的支付账户列表,支持添加支付方式。主体数据在支付账户表,支付方式枚举来自源码常量。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 账户名称 | 后台识别用的名称 | 文本,无默认 [源码] | 如「微信主账户」 | 列表展示,可标记为默认 |
| 状态 | 账户是否可用 | radio:1正常 / 0停用 / 2风控暂停 [源码] | 新账户先设「正常」;异常时设「风控暂停」 | 2 为风控暂停,不是普通停用 |
| 默认 | 是否默认收款账户 | checkbox,默认否 [源码] | 多账户时勾选一个默认 | 影响未指定渠道时的收款选择 |
| 健康分 | 账户健康度评分 | 数字 0–100 [源码] | 按账户实际状态填写或由系统评估 | 低分可能触发风控提示 |
| 账号权重 | 多账户优先级 | 数字,默认 0 [源码] | weight 越高越优先 | — |
| 最小金额 / **金额 | 该账户可处理金额范围 | 数字(元),默认 0 [源码] | 按渠道限额填写 | 提交时金额 ×100 转为分存储 [源码] |
| 日笔数限制 | 每日最多交易笔数 | 数字,默认 0 [源码] | 按渠道能力设置 | — |
| 日限额 / 月限额 | 每日/每月金额上限 | 数字(元),默认 0 [源码] | 0 通常表示不限 | 同金额 ×100 存储 |
| 支付方式 | 收款渠道 | 必选 radio,见下方详解 | 按已开通的渠道选择 | 决定下方凭证表单 |
| 网关凭证 | 渠道认证参数 | 随支付方式变化,见下方详解 | 按渠道后台获取 | 敏感信息,不要公开 |
| 沙盒 | 是否启用测试模式 | radio:开启 / 关闭 [源码] | 接入测试阶段开启,上线前关闭 | 虎皮椒支付无此选项 [源码] |
配置项详解
支付方式
出现条件:新增/编辑支付账户弹窗中必填 [源码]。
可选渠道(config/constant.go:91-99):
| 值 | 渠道 |
|---|---|
wechat |
微信支付(服务号) |
weapp |
微信小程序支付 |
alipay |
支付宝支付 |
paypal |
PayPal |
stripe |
Stripe |
xunhupay |
虎皮椒支付 |
nowpayment |
NOWPayments 加密货币 |
balance |
余额支付 |
offline |
线下支付 |
选择建议:国内站常用微信/支付宝;外贸站用 PayPal/Stripe;balance 与 offline 通常不需要外部凭证。
填错后果:支付方式选错会导致整组凭证字段不匹配,支付无法完成。
网关凭证(按渠道联动)
出现条件:源码中 payWay !== '' && payWay !== 'offline' 时显示整组凭证字段 [源码]。各渠道字段不同:
- 微信支付/小程序支付:AppID、AppSecret、商户ID、APIKey、商户证书 Cert/Key 上传。
- 支付宝:AppID、PrivateKey、应用公钥证书、支付宝公钥证书、根证书。
- PayPal:Client ID、Client Secret。
- Stripe:Private Key、Public Key、Webhook Secret。
- 虎皮椒:AppID、AppSecret、网关地址(默认
https://api.xunhupay.com)。 - NOWPayments:API Key、IPN Secret、计价币种(留空按
usd)、网关地址(默认https://api.nowpayments.io)。
推荐值:沙盒模式先在渠道测试环境验证,再切换生产。
填错后果:凭证错误会直接导致支付失败;证书类文件需匹配渠道要求的格式(.crt/.pem)。
金额单位
出现条件:填写最小/**金额、日限额、月限额时 [源码]。
界面输入单位为「元」,源码提交时乘以 100 转为「分」存储;列表展示时除以 100 还原 [源码]。
填错后果:若按「分」填写会放大 100 倍,造成严重限额错误。
操作步骤
- 进入「设置 → 支付设置」。
- 点击「添加支付方式」,选择支付方式。
- 填写账户名称、状态及对应渠道的凭证。
- 展开「显示更多」设置权重、限额与健康分。
- 先开启沙盒测试,验证通过后关闭沙盒并启用账户。
适用场景与建议
- 多收款账户时用账号权重控制优先顺序。
- 新渠道接入后先小额测试,再放开金额限制。
注意事项
- 支付密钥、证书、商户号等敏感信息不要写进公开文档或截图。
- 修改配置会影响正在进行的交易,建议在低峰期操作。
- 商城模式需要在「全局设置 → 运行与 SEO 状态」中开启。