決済チャネル
管理画面の場所: Finance › Payment channels (
/payments)。スイッチと手数料: Finance › Payment channels › Fees & limits (/payments/fees)。
NexCMP はプリペイド式の USD ウォレットを使用します。お客様は決済チャネルを通じてウォレットに入金し、すべてのサービスはそのウォレットから支払われます。チャネルは、有効かつ設定済みの両方の条件を満たしている場合にのみ、お客様に表示されます。
動作内容
決済チャネルは、お客様の決済アカウント（Stripe、PayPal、Binance、ベトナムの銀行など）を顧客ウォレットに接続します。入金が確認されると、正確に1つのウォレットクレジットが作成されます。各クレジットにはゲートウェイの決済 ID が紐付けられているため、Webhook が重複して送信されても二重に入金されることはありません。このページでは、利用可能なチャネル、過去30日間の稼働状況、および対応が必要なチャネルを確認できます。
要件
| 項目 | 要件 |
|---|---|
| 公開 HTTPS アドレス | ゲートウェイは https://<domain>/v1/billing/... に Webhook を送信するため、パネルは有効な TLS を使用してインターネットからアクセスできる必要があります（DNS and Cloudflare を参照してください）。 |
| アカウント | 使用する各プロバイダーの独自のアカウント。資格情報は管理画面に入力され、再表示されることはありません（下4桁のみ表示されます）。 |
| 管理者ロール | 管理者アカウント。 |
| 依存関係 | なし。VN銀行チャネルには追加で為替レートが必要です。 |
チャネル
| チャネル | お客様の画面 | 設定場所 | 記事 |
|---|---|---|---|
| カード (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 |
| VN銀行振込 | 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) | On | 入金画面のカード入力フォーム。Stripeにシークレットキーが設定されるまで非表示になります。 |
| Apple Pay、Google Pay、Link | On | ウォレットボタン。Stripeでドメインが検証された場合にのみ表示されます。 |
| Alipay | オフ | Stripeダッシュボードで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（1日経過しても保留中のままの支払い）、Unmatched（到着したもののどの注文にも一致しないUSDTまたは銀行振込）。KPI行には、30日間のボリューム、障害のあるチャンネルの数（有効化されているが未設定、またはスタックした支払い）、および一致しないものの合計が追加されます。
- WebhookイベントはPayment channels › Gateway eventsにリストされます（
/payments/events）。Stripeには独自のタブがあり、PayPalとUSDTは1つのタブを共有します。失敗したイベントは再実行できます。ウォレットの台帳はべき等であるため、再実行しても二重にクレジットされることはありません。 - 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をクリックしてください。 |