導入ガイド

Node.js を使用した Web サイトで USDT / USDC 支払いを受け入れる方法

実稼働 USDT / USDC チェックアウトにはウォレット アドレス以上のものが必要です。 Node.js から注文を作成し、チェックアウト データをブラウザーに返し、オンチェーン支払い Webhook が検証された後にのみ履行します。

手順

Node.js USDT / USDC 支払い統合手順

このパターンは、SaaS サブスクリプション、デジタル配信、請求書、アカウント クレジット、または監査可能な USDT / USDC 支払い状態を必要とする Web サイトに使用します。

  1. 01

    支払い API を呼び出す前に、一意の内部注文 ID を作成して保持します。

  2. 02

    Node.js バックエンドからBoltUtil create-order エンドポイントを呼び出し、チェックアウト URL をブラウザーに返します。

  3. 03

    正確な USDT / USDC ネットワークと金額を表示します。ブラウザのリダイレクトは支払いを証明するものではありません。

  4. 04

    生の Webhook 本文と署名を検証し、注文 ID とトランザクション ハッシュによってべき等に実行します。

  5. 05

    サポートと調整のために、確認されたトランザクション ハッシュ、ネットワーク、金額、およびフルフィルメント結果を保存します。

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

>統合に関するメモ

制作前に大切なこと

キーをサーバー上に保管します

Node.js から注文を作成することで、プライベート API キーとローカル カートの検証がブラウザー コードに含まれないようにします。

ダイレクトウォレット決済

顧客は設定されたマーチャントウォレットに支払いますが、BoltUtil は選択された USDT / USDC ネットワークを監視して確認を報告します。

安全な履行

署名されたサーバー間 Webhook を使用すると、アプリケーションは顧客のリダイレクトを信頼せずにアクセスまたは配信をアクティブ化できます。

Node.js 22+ · USDC / Base checkout
import crypto from 'node:crypto'

// Node.js 20+ server module. Call only after authenticating the buyer.
// order must come from your database, with ownership and price checked.
// Never pass req.body directly; persist externalOrderId before calling.
export async function createStablecoinCheckout(order) {
  const key = process.env.BOLTUTIL_API_KEY
  const secret = process.env.BOLTUTIL_API_SECRET
  if (!key || !secret) throw new Error('Missing server credentials')

  const payload = JSON.stringify({
    externalOrderId: order.externalOrderId,
    amount: order.amount,
    currency: 'USDC',
    network: 'BASE',
    notifyUrl: 'https://merchant.com/webhooks/boltutil',
    returnUrl: 'https://merchant.com/orders/complete'
  })
  const timestamp = Date.now().toString()
  const signature = crypto.createHmac('sha256', secret)
    .update(`${timestamp}.${payload}`).digest('hex')

  // A timeout does not prove creation failed. Query order/status using
  // the SAME externalOrderId before deciding whether to retry.
  const response = await fetch('https://api.boltutil.com/api/v1/order/create', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Bolt-Key': key,
      'X-Bolt-Timestamp': timestamp,
      'X-Bolt-Signature': signature
    },
    body: payload,
    signal: AbortSignal.timeout(10000)
  })
  const result = await response.json()
  if (!response.ok || result.code !== 200 || !result.data?.checkoutUrl) {
    throw new Error('Create order failed; reconcile the saved order')
  }
  // Save result.data on the server. Return only checkout data to the buyer.
  return result.data
}

導入・調査用の例です。リクエストは送信されません。注文データ、ネットワーク設定、API ドキュメントを確認してください。

API ドキュメントを読む

リダイレクトは確認ではありません

顧客は早期に戻ることも、失敗したトランザクションを送信することもできます。検証済みの Webhook またはサーバー側の注文ステータス クエリを信頼できる情報源として使用します。

ネットワークの選択はチェックアウト UX の一部です

USDT / USDC は複数のネットワーク上に存在します。 TRC20、ERC20、BEP20、Polygon、Solana、Base を明確に表示し、注文作成時に選択したネットワークのみに一致します。

サポートのために連鎖的な事実を保持する

迅速な照合のために、外部注文 ID、トランザクション ハッシュ、正確な金額、宛先アドレス、および確認状態を保持します。

導入ガイド

販売者が公開前に尋ねる質問

BoltUtilは加盟店の資金を保管しますか?

いいえ。資金は加盟店ウォレットへ直接送られ、BoltUtilは送金を監視して通知します。

USDT / USDC決済はどのように照合されますか?

ネットワーク、トークン、宛先、正確な金額、注文状態、有効期限を確認します。

USDT と USDC はどのネットワークに対応していますか?

TRON は USDT のみ対応します。Ethereum、BNB Smart Chain、Polygon、Solana、Base は設定された USDT / USDC に対応します。利用可否は有効なチャネルと加盟店ウォレットによります。

対応するネットワークとトークンの種類は?

TRON、Ethereum、BNB Smart Chain、Polygon PoS、Solana、Base. TRON は USDT のみ対応します。Ethereum、Polygon、Solana、Base はネイティブ USDC、BNB Smart Chain は Binance-Peg USDC に対応します。Base の USDT は Bridged USDT です。 決済画面には、有効化され、有効な加盟店受取ウォレットが設定されたネットワークとトークンの組み合わせのみ表示します。名称だけでなく、設定されたコントラクトや Mint を確認してください。

よりクリーンな USDT / USDC 支払いフローの開始

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