支付设置

📅 2026-11-21 👁️ 0

支付设置

支付设置用于维护商城支付方式的收款账户,配置渠道凭证、限额与健康状态。

入口路径

后台顶部菜单 →「设置」→「支付设置」。实际地址:/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 倍,造成严重限额错误。

操作步骤

  1. 进入「设置 → 支付设置」。
  2. 点击「添加支付方式」,选择支付方式。
  3. 填写账户名称、状态及对应渠道的凭证。
  4. 展开「显示更多」设置权重、限额与健康分。
  5. 先开启沙盒测试,验证通过后关闭沙盒并启用账户。

适用场景与建议

  • 多收款账户时用账号权重控制优先顺序。
  • 新渠道接入后先小额测试,再放开金额限制。

注意事项

  • 支付密钥、证书、商户号等敏感信息不要写进公开文档或截图。
  • 修改配置会影响正在进行的交易,建议在低峰期操作。
  • 商城模式需要在「全局设置 → 运行与 SEO 状态」中开启。

相关文档