付款管道
後台位置: Finance › Payment channels (
/payments)。開關與手續費:Finance › Payment channels › Fees & limits (/payments/fees)。
NexCMP 使用預付 USD 錢包。客戶透過付款管道將資金存入錢包;此後所有服務皆從錢包扣款。管道必須同時處於已啟用和已設定狀態才會對客戶顯示。
功能
付款管道將您的付款帳戶(Stripe、PayPal、Binance、越南銀行)連接至客戶錢包。已確認的付款會精確轉換為一筆錢包點數 — 每一筆點數均以閘道付款 ID 作為金鑰,因此重複的 Webhook 絕不會重複加值。您可以使用此頁面查看哪些管道已就緒、過去 30 天的效能表現,以及哪些管道需要處理。
需求
| 項目 | 需求 |
|---|---|
| 公開 HTTPS 地址 | 閘道會將 Webhook 傳送至 https://<domain>/v1/billing/...,因此您的面板必須能夠透過有效 TLS 從網際網路存取(請參閱 DNS and Cloudflare)。 |
| 帳戶 | 您要使用的每個提供者的專屬帳戶。憑證會在後台輸入且絕不會再次顯示(僅顯示最後 4 個字元)。 |
| 管理員角色 | 管理員帳戶。 |
| 相依項目 | 無。越南銀行管道另需設定一個匯率。 |
支付管道
| 管道 | 客戶看到的畫面 | 設定位置 | 文章 |
|---|---|---|---|
| 信用卡(Stripe) | 信用卡表單、已儲存的信用卡 | Payment channels › Stripe | Stripe |
| Apple Pay、Google Pay、Link | 錢包按鈕(Stripe Express Checkout) | Stripe 與網域註冊 | Stripe |
| Alipay | 重新導向至 Alipay(由 Stripe 以 JPY 計費) | Stripe 與手續費和額度 | Stripe |
| PayPal | PayPal 按鈕、已儲存的 PayPal 帳號 | Payment channels › PayPal | PayPal |
| USDT | 存款地址與確切金額 | Payment channels › USDT | USDT |
| 越南銀行轉帳 | QR 碼與轉帳明細(僅限越南語介面) | Payment channels › VN bank transfer | Bank transfer (Vietnam) |
準備基礎設施
不需要。所有設定皆於管理後台完成,伺服器端無需安裝任何東西。
在 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 取得密鑰前會保持隱藏。 |
| Apple Pay、Google Pay、Link | 開啟 | 錢包按鈕。僅會在網域於 Stripe 完成驗證後顯示。 |
| Alipay | 關閉 | 需要在 Stripe Dashboard 中啟用 Alipay。 |
| PayPal | 關閉 | 僅在設定好 PayPal 時顯示。 |
| USDT (Binance) | 關閉 | 此開關會保持鎖定,直到存款地址透過 Binance 完成驗證為止。 |
| Stripe 手續費 % / 固定金額(分) | 3.6 % 與 0 | 用於向客戶顯示手續費並計算入帳金額。請設為您實際的 Stripe 費率。 |
| PayPal 手續費 % / 固定金額 | 4.4 % 與 30 分 | 同上,適用於 PayPal。 |
| USDT 手續費 % | 1 % | 同上,適用於 USDT。 |
| 客戶支付加值手續費 | 關閉 | On:客戶支付金額加手續費,錢包收到完整金額。Off:扣除手續費後,錢包收到的金額為扣除手續費後的金額。 |
客戶在付款前隨時都能看到手續費與最終的錢包額度。關閉通道會隱藏按鈕,且伺服器會拒絕新的付款並回應 method_disabled(HTTP 403)。
加值限制
每筆加值的最低與最高金額在同一頁面上 — 請參閱 Minimum top-up。
驗證
- 在總覽表中,該通道會顯示 Enabled 與 Configured;Last test 欄位會在您點擊該通道分頁上的 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 與通道分頁;請參閱 Bank transfer (Vietnam)。 |
| KPI Faulty channels 大於 0 | 通道已啟用但沒有憑證,或付款暫挂超過 24 小時 | 開啟該資料列並點擊 Configure;若遇到卡住的付款,請開啟 Gateway events 並重新發送。 |
| 客戶已付款但餘額未變更 | Webhook 未送達 | 檢查通道分頁上的 Webhook URL,然後在 Gateway events 中重新發送事件。 |
伺服器回應 method_disabled | 開關已關閉 | 在 Fees & limits 中將其開啟並儲存。 |
| USDT 開關呈灰色停用狀態 | 存款地址未驗證 | 點擊 USDT 分頁上的 Test & verify address。 |