USDT (Binance)
管理画面での場所: Finance › Payment channels › USDT (
/payments/usdt)。スイッチと手数料: Finance › Payment channels › Fees & limits (/payments/fees)。未一致の入金: Finance › Payment channels › Gateway events › PayPal & USDT (/payments/events?tab=gateways)。
動作内容
お客様が お客様の Binance 入金アドレス に USDT を送信すると、NexCMP は 読み取り専用 の Binance API キーを介して入金履歴を読み取り、入金が未決済のリクエストと一致したときにウォレットに入金します。Binance が請求する手数料以外に決済代行手数料は発生せず、NexCMP が秘密鍵を保持することは一切ありません。
要件
| 項目 | 要件 |
|---|---|
| Binance アカウント | 選択したネットワークで USDT の入金が有効になっている、認証済みの Binance アカウント。 |
| API キー | Enable Reading のみが有効な Binance API キー。「Enable Withdrawals」、「Internal Transfer」、「Spot/Margin Trading」は必ず オフ にしてください。 |
| IP 制限 | 強く推奨: サーバーのアウトバウンド IP にキーを制限します (Test & verify address ダイアログに表示されます)。 |
| ネットワーク | api.binance.com へのアウトバウンド HTTPS。インバウンドポートは不要です。 |
| サポートされるネットワーク | TRX (Tron、TRC20)、BSC (BNB Smart Chain、BEP20)、SOL (Solana)、ETH (Ethereum、ERC20)。コインは USDT に固定されています。 |
| 依存関係 | なし。 |
ネットワークの選択は 1 回のみ
間違ったネットワークで送信した顧客は資金を失います。顧客の取引所がサポートする手数料の低いネットワークを選択し (通常は TRX と BSC)、頻繁に変更しないでください。
インフラストラクチャの準備
- Binance で Account › API Management を開き、新しい API キーを作成します (システム生成)。「NexCMP」などのラベルを付けます。
- 権限を編集します: Enable Reading のみにチェックを残します。出金、振替、取引は有効にしないでください。
- Restrict access to trusted IPs only の下で、NexCMPサーバーのパブリックIPアドレスを追加します。まだ不明な場合は制限なしでキーを作成し、NexCMPで最初のテストを実行して(アウトバウンドIPが出力されます)からIPを追加してください。
- API key と Secret key をコピーします(シークレットは一度しか表示されません)。
- Wallet › Deposit › Crypto を開き、USDTと使用するネットワークを選択して、入金アドレスをコピーします(例:TRX上の
T...アドレス、またはBSC/ETH上の0x...)。
NexCMP での接続
- Finance › Payment channels › USDT (
/payments/usdt)を開きます。 - API key (Binance › API Management) に API key と API secret を貼り付けます。両方を同時に入力する必要があります。
- Deposit address で Network を選択し、選択したネットワーク上のUSDT入金アドレスを貼り付けます。フォーマットはネットワークごとに検証されます(TRXは
T+ 33 文字、BSCおよびETHは0x+ 40 16進数文字、SOLは base58)。 - Saveをクリックします。アドレスまたはネットワークを変更すると検証がリセットされ、再検証するまでチャネルが一時停止されます。確認を求めるページが表示されます。
- Test & verify addressをクリックします(未保存の変更は拒否され、チェックは保存された設定に対して実行されます)。ダイアログには以下が表示されます:
- キーの権限(読み取り、出金、内部振替、取引、IP制限)—危険な権限には赤色の警告が表示されます:
- サーバーのアウトバウンドIP(Binanceに入力するため);
- ネットワーク(入金のオープン/クローズ、必要な承認数、ダスト);
- そのネットワークに対してBinanceが発行するアドレス、およびそれがお客様の住所と一致するかどうか。
- アドレスが一致すると、NexCMPは検証時間を記録します。その後初めて、Fees & limitsを開き、**USDT (Binance)**を有効にし、USDT fee %(デフォルトは1)および USDT request expires after (mins)(5〜180、デフォルトは30)を確認して、Save channels & feesをクリックできます。
支払いの照合方法
- お客様は Billing › Deposit › USDT で金額を入力し、Get deposit addressをクリックします。
- NexCMPはリクエストを作成し、アドレス、ネットワーク、および6桁の小数を持つ正確な金額を表示します(例:
19.173742)。最後の4桁の小数は、そのリクエストに対して金額を一意にするためのランダムなノンスです。 - お客様はそのネットワーク上で正確にその金額を送信する必要があります。一致しない支払い(丸められた金額、間違ったネットワーク)は自動的に割り当てることができません。
- NexCMPは60秒ごとに過去24時間のBinance入金を読み取ります。一致する入金によりリクエストがconfirming(確認中)に移動し、Binanceに必要な承認数が揃うとウォレットに入金されます。資金が確認されたリクエストは、承認待ちの間は期限切れになりません。
- 有効期限(デフォルト30分)内に支払われなかったリクエストは期限切れとしてマークされます。
確認
- アドレスが検証されUSDTが有効になったら、テスト顧客としてサインインし、少額の入金(最低トップアップ額)をリクエストします。
- 別のウォレットまたは取引所から正確な金額を送信します。数分お待ちください。
- ポータルに Transfer seen — confirming が表示された後、USDT received — balance updated が表示されます。
- USDTページに最近の Last poll の時間と、0の Unmatched が表示されます。
制限と注意事項
- レート。 1 USDT = 1.00 USD。USDT fee % の手数料はお客様に表示され、Customer pays top-up fee の設定に応じて金額から差し引かれるか、金額に加算されます。
- 返金不可。 USDTの支払いはNexCMPによって送信元に返金されることはありません(HTTP 409
usdt_no_refund)。必要に応じてシステム外で手動で返金してください。 - 保留制限。 顧客が持つオープンなリクエストの数には制限があり、それを超えるとサーバーは
too_many_pending(HTTP 429)を返します。 - Resellers は自身のBinanceアカウントを使用できます。Resellers を参照してください。
- Binanceアカウントを他のシステムと共有している場合、2つのポーラーが同じ入金を決して検知しないよう、各システムに異なるネットワークを割り当ててください。
一致しない入金
どのリクエストにも一致しない入金(金額ミス、ネットワークミス、期限切れのリクエスト)は、deposit.unmatchedイベントと管理者アラートを発生させます。Payment channels › Gateway events › PayPal & USDTを開いてイベントを見つけ、Binanceでトランザクションを確認し、割り当てアクションをクリックして正しい顧客に入金します。その後、USDTページおよびチャンネル概要のUnmatchedカウンターが0に下がります。
トラブルシューティング
| 症状 | 原因 | 対処法 |
|---|---|---|
| 「API key and secret must be entered together」のエラーが表示される | 片方のフィールドのみが入力されている | 両方に入力してください。 |
| 「Address is not in the format of network ...」のエラーが表示される | アドレスが選択したネットワークの形式に適合していない | 同じネットワーク用にBinanceから再コピーしてください。 |
| 「Unsaved changes — Save first then Test」のエラーが表示される | 保存された設定でテストが実行される | Saveをクリックしてからテストしてください。 |
| 警告「key has Enable Withdrawals」 | 過剰な権限 | BinanceのAPI管理でそれを削除してください。 |
| 警告「key not restricted to IP」 | ipRestrictがオフになっている | ダイアログに表示されるサーバーの発信IPを追加してください。 |
| 警告「key lacks Enable Reading」 | 権限が不足している | Enable Readingを有効にしてください。 |
| 警告「Binance has deposits disabled for USDT on the network」 | ネットワークが一時停止中 | 別のネットワークを選択するか、お待ちください。 |
| 「DANGER: configured address differs from the address Binance issues」のエラーが表示される | アドレスまたはネットワークが誤っている | そのネットワーク用にBinanceからアドレスを再度コピーしてください。 |
| Fees & limitsでUSDTのスイッチがグレーアウトしている | アドレスが検証されていない | 一致するまでTest & verify addressを実行してください。 |
| 顧客が支払ったが、入金されていない | 金額が丸められている、またはネットワークが誤っている | Gateway eventsでイベントを見つけ、手動で割り当ててください。 |
| 入金は確認できたが長い間待たされている | 確認(コンファメーション)回数がまだ足りない | お待ちください。確認中もリクエストの有効期限は切れません。 |