決済導入

バックエンドが信頼できる USDT / USDC 支払い Webhook

BoltUtil は、支払い確認後に注文 ID、ステータス、ネットワーク、金額、確認、トランザクション ハッシュを含む署名付き Webhook ペイロードを送信します。

手順

BoltUtil は、支払い確認後に注文 ID、ステータス、ネットワーク、金額、確認、トランザクション ハッシュを含む署名付き Webhook ペイロードを送信します。

バックエンドが信頼できる USDT / USDC 支払い Webhook

  1. 01

    バックエンドから金額、ネットワーク、外部注文IDを指定して決済注文を作成します。

  2. 02

    購入者に決済URL、ネットワーク、受取アドレス、QRコード、正確なUSDT / USDC金額を表示します。

  3. 03

    BoltUtilがネットワーク、トークンコントラクト、宛先、金額、有効期限、承認数を確認します。

  4. 04

    支払い確認後、Webhook署名を検証し、冪等に商品やサービスを提供します。

BoltUtil は支払いを照合し、署名付きコールバックを送信します。加盟店のサーバーで署名と注文状態を確認し、重複処理を防いでから納品・開通・入金処理を行います。

>統合に関するメモ

制作前に大切なこと

ノンカストディアル決済

USDT / USDCは加盟店ウォレットへ直接送金され、BoltUtilが資金や秘密鍵を保管することはありません。

6 つの決済ネットワーク

TRON、Ethereum、BNB Smart Chain、Polygon、Solana、Base に対応。TRON は USDT / USDC のみ。その他の USDT / USDC 決済も、資産の有効化と有効な受取ウォレットが必要です。

署名付きWebhook

HMAC署名、タイムスタンプ、再送ログにより、安全な決済後処理を実装できます。

HMAC-SHA256 · Signed payment notification
X-Bolt-Webhook-Timestamp: <timestamp>
X-Bolt-Webhook-Signature: <hex signature>

signed_content = timestamp + "." + raw_body
expected = HMAC_SHA256(signed_content, webhook_secret)

Verify timestamp + constant-time signature comparison
→ Parse JSON and validate local order / payment
→ Persist notification and process once
→ Return 2xx after durable acceptance

導入・調査用の例です。リクエストは送信されません。注文データ、ネットワーク設定、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 支払いフローの開始

顧客にスクリーンショットの送信を依頼することなく、注文を作成し、転送を監視し、バックエンドに通知します。