TRADOM Payment
ステーブルコイン決済を、ECサイトに組み込むための開発者向けガイド
TRADOM Paymentは、買い手からUSDC / USDTで支払いを受け付けるための決済基盤です。マーチャントはJPYまたはUSDで金額を指定し、買い手の決済画面、入金確認、返金までをAPIから扱えます。
統合方式を選ぶ
| Hosted Checkout | Custom Payment Flow | |
|---|---|---|
| おすすめ | ほとんどのECサイトに推奨 | 独自UIが必要な場合 |
| 実装するもの | 注文作成とredirect | 決済画面と状態管理 |
| 買い手の画面 | TRADOM Paymentがhost | 自社で実装 |
| 認証 | Gateway key gw_live_… | Secret key sk_test_… / sk_live_… |
| 最初に読む | Hosted Checkout Quickstart | Custom Payment Flow |
迷った場合はHosted Checkoutを選んでください。暗号資産・networkの選択、QR表示、入金待ち画面を用意する必要がなく、最短で導入できます。
Hosted Checkoutの流れ
1. マーチャントのbackendでcheckoutを作成
2. 買い手をcheckoutUrlへredirect
3. 買い手がUSDC / USDTを送金
4. backendで支払い状態を確認
5. 商品提供・後続処理を開始最初の決済を作るには Quickstart へ進んでください。
必要なもの
- TRADOM Paymentのマーチャントアカウント
- サーバ側に保存したGateway API key
- 支払い後の戻り先となる
returnUrl - Node.js 18以降とnpm
Gateway key、secret key、Webhook secretはブラウザへ送らないでください。SDKはbackendでのみ使用します。
導入の順番
- Hosted Checkout Quickstartで最初のcheckoutを作る
- テスト方法で資金を動かさずに確認する
- Webhookで非同期の支払い完了を受け取る
- 返金を実装する
SDKやREST APIの詳細が必要になったら、TypeScript SDK と APIオブジェクト を参照してください。