ノンカストディアル決済
USDT / USDCは加盟店ウォレットへ直接送金され、BoltUtilが資金や秘密鍵を保管することはありません。
導入ガイド
USDT / USDC 支払い Webhook が再試行時にのみ成功する理由
ブロックチェーンの支払いはすでに完了しているが、マーチャント アプリが 2 回目の Webhook 試行後にのみ更新される場合、問題は通常、エンドポイントの可用性、署名処理、タイムアウト動作、または非冪等フルフィルメントにあります。
手順
ブロックチェーンの支払いはすでに完了しているが、マーチャント アプリが 2 回目の Webhook 試行後にのみ更新される場合、問題は通常、エンドポイントの可用性、署名処理、タイムアウト動作、または非冪等フルフィルメントにあります。
USDT / USDC 支払い Webhook が再試行時にのみ成功する理由
01 バックエンドから金額、ネットワーク、外部注文IDを指定して決済注文を作成します。
02 購入者に決済URL、ネットワーク、受取アドレス、QRコード、正確なUSDT / USDC金額を表示します。
03 BoltUtilがネットワーク、トークンコントラクト、宛先、金額、有効期限、承認数を確認します。
04 支払い確認後、Webhook署名を検証し、冪等に商品やサービスを提供します。
BoltUtil は支払いを照合し、署名付きコールバックを送信します。加盟店のサーバーで署名と注文状態を確認し、重複処理を防いでから納品・開通・入金処理を行います。
>統合に関するメモ
制作前に大切なこと
6 つの決済ネットワーク
TRON、Ethereum、BNB Smart Chain、Polygon、Solana、Base に対応。TRON は USDT / USDC のみ。その他の USDT / USDC 決済も、資産の有効化と有効な受取ウォレットが必要です。
署名付きWebhook
HMAC署名、タイムスタンプ、再送ログにより、安全な決済後処理を実装できます。
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx response導入・調査用の例です。リクエストは送信されません。注文データ、ネットワーク設定、API ドキュメントを確認してください。
API ドキュメントを読む注文作成はサーバー側で行う
APIキーをブラウザーへ公開せず、決済画面を表示する前に外部注文IDを保存します。
ネットワークを明確に表示する
アドレスだけでなく、TRC20、ERC20、BEP20、Polygon、Solanaのどれを使うか明示します。
検証後にサービスを提供する
戻り先URLは支払い証明ではありません。署名付きWebhookかサーバー側の状態照会を使用します。
導入ガイド
販売者が公開前に尋ねる質問
BoltUtilは加盟店の資金を保管しますか？
いいえ。資金は加盟店ウォレットへ直接送られ、BoltUtilは送金を監視して通知します。
USDT / USDC決済はどのように照合されますか？
ネットワーク、トークン、宛先、正確な金額、注文状態、有効期限を確認します。
USDT と USDC はどのネットワークに対応していますか？
TRON は USDT のみ対応します。Ethereum、BNB Smart Chain、Polygon、Solana、Base は設定された USDT / USDC に対応します。利用可否は有効なチャネルと加盟店ウォレットによります。
よりクリーンな USDT / USDC 支払いフローの開始
顧客にスクリーンショットの送信を依頼することなく、注文を作成し、転送を監視し、バックエンドに通知します。