支付渠道
**管理后台位置：**Finance › Payment channels（
/payments）。开关与手续费：Finance › Payment channels › Fees & limits（/payments/fees）。
NexCMP采用USD预付费钱包机制。客户通过支付渠道向钱包充值；所有服务费用均从钱包中扣除。支付渠道仅在同时处于已启用且已配置状态时，才会向客户展示。
功能说明
支付渠道将您的支付账户（Stripe、PayPal、Binance、越南本地银行）与客户钱包关联。确认支付后将精准生成一笔钱包入账——每笔入账均以网关支付ID为唯一键，因此重复发送的webhook绝不会重复入账。您可通过本页面查看哪些渠道已就绪、过去30天的运行表现，以及哪些渠道需要关注。
前提条件
| 项目 | 要求 |
|---|---|
| 公网HTTPS地址 | 网关会向https://<domain>/v1/billing/...发送webhook，因此您的面板必须支持通过有效的TLS从公网访问（参见DNS和Cloudflare）。 |
| 账户 | 您在拟使用的各渠道服务商处开设的自有账户。凭据在管理后台录入后将不再完整显示（仅显示后4位字符）。 |
| 管理员角色 | 管理员账户。 |
| 依赖项 | 无。VN bank渠道额外需要汇率。 |
支付渠道
| 渠道 | 客户所见内容 | 配置位置 | 文档 |
|---|---|---|---|
| 银行卡（Stripe） | 银行卡表单、已保存的银行卡 | Payment channels › Stripe | Stripe |
| Apple Pay、Google Pay、Link | 钱包按钮（Stripe Express Checkout） | Stripe，外加域名注册 | Stripe |
| Alipay | 重定向至Alipay（由Stripe以JPY计费） | Stripe，外加Fees & limits | Stripe |
| PayPal | PayPal按钮、已保存的PayPal账户 | Payment channels › PayPal | PayPal |
| USDT | 充值地址与准确金额 | Payment channels › USDT | USDT |
| VN bank transfer | 二维码和转账明细（仅限越南语界面） | Payment channels › VN bank transfer | 银行转账（越南） |
准备基础设施
无需准备。所有内容均在管理后台配置，服务器上无需安装任何组件。
在NexCMP中连接
- 打开Finance › Payment channels（
/payments）。概览表格列出了每个渠道及其状态。 - 打开对应渠道的标签页（Stripe、PayPal、USDT、VN bank transfer）并按照对应文档操作。每个标签页底部都有Save按钮，在支持的渠道下还会有Test按钮。
- 打开Fees & limits（
/payments/fees），找到Payment gateways & fees (wallet top-up)卡片，通过开关启用该渠道，然后点击Save channels & fees。
开关与费率（Fees & limits）
| 设置 | 默认值 | 说明 |
|---|---|---|
| 银行卡（Stripe） | 开启 | 充值界面的银行卡表单。在Stripe配置secret key前保持隐藏。 |
| Apple Pay、Google Pay、Link | 开启 | 钱包按钮。仅在域名通过Stripe验证后才会显示。 |
| Alipay | 关闭 | 需要在Stripe Dashboard中激活Alipay。 |
| PayPal | 关闭 | 仅在配置PayPal后显示。 |
| USDT (Binance) | 关闭 | 该开关处于锁定状态，直到充值地址已通过Binance验证。 |
| Stripe 手续费 % / 固定（美分） | 3.6 %和0 | 用于向客户显示手续费并计算入账金额。请将其设置为您的实际Stripe费率。 |
| PayPal 手续费 % / 固定 | 4.4 %和30 cents | 同上，适用于PayPal。 |
| USDT fee % | 1 % | 同上，适用于USDT。 |
| 客户承担充值手续费 | 关闭 | On：客户支付金额+手续费，钱包到账全额。Off：手续费从中扣除，钱包到账扣除手续费后的金额。 |
客户在付款前始终能看到手续费和最终钱包入账金额。关闭渠道会隐藏按钮，且服务器会以method_disabled拒绝新付款（HTTP 403）。
充值限额
单笔充值的最低和最高限额在同一页面——参见最低充值金额。
验证
- 在总览表格中，渠道显示为Enabled和Configured；在渠道选项卡中点击Test后，Last test列将被填充。
- 作为测试客户登录门户并打开Billing › Deposit。该渠道按钮已显示。
- 进行一笔小额支付（测试卡或沙盒账户请参见对应渠道的文档）。余额增加，出现Top-up received通知，并且该笔付款会列在Finance › Billing › Top-ups（
/billing/deposits）中。
限制与注意事项
- **总览列：30 days（支付笔数、成功数、失败数及交易额）、Stuck 24h（超过一天仍处于待处理状态的支付）以及Unmatched（已到账但未匹配任何订单的USDT或银行转账）。KPI行汇总了30天交易额、异常渠道数量（已启用但未配置，或存在卡住的支付）以及未匹配总额。
- Webhook事件列在Payment channels › Gateway events（
/payments/events）下。Stripe拥有独立选项卡；PayPal和USDT共用一个选项卡。失败的事件可以重放——钱包账本具备幂等性，因此重放绝不会重复入账。 - Resellers可以拥有自己的Stripe、PayPal、USDT和银行渠道。他们的条目也会显示在此处，顶部的站点选择器可对其进行筛选。参见Resellers。
- **退款：**Stripe和PayPal付款可直接在支付列表中退款；USDT付款无法原路退回（服务器会返回
usdt_no_refund）。 - 维护模式下仍会接收网关Webhook，因此在维护开始前刚刚完成的付款不会丢失。
故障排查
| 症状 | 原因 | 解决办法 |
|---|---|---|
| 客户充值界面缺少该渠道 | 未开启、未配置，或（越南银行）界面语言不是越南语 | 检查Fees & limits和渠道选项卡；参见银行转账（越南）。 |
| KPI Faulty channels大于0 | 渠道已启用但未配置凭据，或存在待处理超过24小时的支付 | 打开该行并点击Configure；对于卡住的支付，打开Gateway events并重放。 |
| 客户已付款但余额未变动 | Webhook未送达 | 检查渠道选项卡中的Webhook URL，然后在Gateway events中重放该事件。 |
服务器返回method_disabled | 开关处于关闭状态 | 在Fees & limits中将其开启并保存。 |
| USDT开关呈灰色不可用 | 充值地址未验证 | 在USDT选项卡中点击Test & verify address。 |