対応チェーン・資産
InfraIO Pay はステーブルコインファーストのマルチチェーン対応で、8 つの EVM ネットワークに加えて TRON、Solana、TON をサポートしています。以下のマトリクスは InfraIO Pay が対応するネットワークの一覧です。TRON、Solana、TON は近日公開です。
Mainnet
| チェーン | Chain ID | ネイティブ | USDC | USDT | 確認回数 | 最小注文額 |
|---|---|---|---|---|---|---|
| Ethereum | 1 | ETH | ✓ (ERC-20) | ✓ (ERC-20) | 12 | $5.00 |
| Base | 8453 | ETH | ✓ (ERC-20) | — | 10 | $1.00 |
| Polygon | 137 | POL | ✓ (ERC-20) | ✓ (ERC-20) | 5 | $1.00 |
| BSC | 56 | BNB | ✓ (18 桁) | ✓ (18 桁) | 5 | $1.00 |
| Arbitrum | 42161 | ETH | ✓ (ERC-20) | ✓ (ERC-20) | 5 | $1.00 |
| Optimism | 10 | ETH | ✓ (ERC-20) | ✓ (ERC-20) | 5 | $1.00 |
| ZKsync Era | 324 | ETH | — | — | 5 | $1.00 |
| Mantle | 5000 | MNT | — | — | 5 | $1.00 |
BSC の USDC + USDT は 18 桁 で、他の場所のような 6 桁ではありません。 トークン金額を自前で計算する場合は、これを考慮してください。 SDK とホスト型チェックアウトは自動的に処理します。
「最小注文額」は USD 建ての最小注文額です。デフォルトは
Mainnet $1.00 / Testnet $0.50 で、Ethereum は
ネットワーク手数料(ガス)が小口注文を上回ってしまうため $5 です。最小額はネットワークごとに異なる場合があります。
下限を下回る注文は AMOUNT_BELOW_MINIMUM (HTTP 400) で拒否され、
details.floor_usd にそのネットワークの最小額が入るので、バイヤーに表示できます。
TRON, Solana and TON
近日公開。 TRON、Solana、TON は本番環境ではまだ利用できません。
| チェーン | Chain ID | ネイティブ | USDC | USDT | 確認回数 | 最小注文額 |
|---|---|---|---|---|---|---|
| TRON | 728126428 | TRX | — | ✓ (TRC-20) | 19 | $1.00 |
| Solana | 1151111081099710 | SOL | ✓ (SPL) | ✓ (SPL) | 32 | $1.00 |
| TON | 607000000000000 | TON | — | ✓ (Jetton) | 1 | $1.00 |
Solana と TON には EVM のチェーン ID がないため、上記の ID は API がこれらに使う内部識別子です。ここに挙げたステーブルコインはすべて 6 decimals です。TON は各ブロックがファイナライズされるため、1 回の確認で確定です。
Testnet
| チェーン | Chain ID | ネイティブ | 確認回数 | 最小注文額 |
|---|---|---|---|---|
| Ethereum Sepolia | 11155111 | ETH | 1 | $0.50 |
| Base Sepolia | 84532 | ETH | 1 | $0.50 |
| Polygon Amoy | 80002 | POL | 1 | $0.50 |
| BNB Smart Chain Testnet | 97 | tBNB | 1 | $0.50 |
| Arbitrum Sepolia | 421614 | ETH | 1 | $0.50 |
| OP Sepolia | 11155420 | ETH | 1 | $0.50 |
| Mantle Sepolia | 5003 | MNT | 1 | $0.50 |
| ZKsync Sepolia | 300 | ETH | 1 | $0.50 |
テストモードは実際のテストネット を使用しており、モックチェーン ではありません。テスト決済をトリガーするには実際のテストネット資金が 必要です — フォーセット (例: sepoliafaucet.com 、 coinbase.com/faucets ) から入手し、 チェックアウトページが生成する入金先アドレスに送金してください。
TRON Nile, Solana Devnet, TON Testnet
| チェーン | Chain ID | ネイティブ | テスト用ステーブルコイン | 確認回数 | 最小注文額 |
|---|---|---|---|---|---|
| TRON Nile | 3448148188 | TRX | USDT, IUSD | 19 | $0.50 |
| Solana Devnet | 1151111081099711 | SOL | USDC, IUSD | 32 | $0.50 |
| TON Testnet | 607000000000003 | TON | IUSD | 1 | $0.50 |
これらのネットワークの テストモードも実際のテストネットを使用します。IUSD テスト用ステーブルコイン(IUSD)はテスト専用です。
API で使用する通貨コード
currency(トップレベルおよび各明細項目)は オーダーの表示通貨
— バイヤーに金額として見せる単位です。現時点で作成時に受け付けるコードは
1 つだけです:
"USD"— サポートされている唯一の値。POST /v1/ordersとPOST /b2b/v1/checkout-sessions/quickのどちらも、それ以外はINVALID_INPUT(“unsupported currency”)で拒否します。GET /v1/supported/currenciesで現在のリストを取得できます。
バイヤーが実際に決済する オンチェーン資産(USDC, USDT, …)は
currency フィールドではありません。マーチャント設定で有効化した
チェーン × トークンの組み合わせから、バイヤーがチェックアウトページ
で選択し、PaymentIntent と webhook の payload に settlement_token
(symbol + chain)として返されます。ネットワーク手数料(ガス)用のネイティブトークン
(ETH, BNB, POL, MNT, TRX, SOL, TON)はチェーンのメタデータでしかなく、
有効な支払い通貨ではありません。
チェーン自体も同じ理由で作成時の API では指定しません — バイヤーが チェックアウトページで組み合わせを選択します。
確認回数と確定
上記の「確認回数」列は、InfraIO Pay が PaymentIntent を SETTLED に
移行して payment.settled を送信する前に待つブロック数です。
回数は、reorg が起きにくくなるようネットワークごとに選ばれています:
- Ethereum mainnet は 12 confirmations を使用します。
- L2 は各ネットワーク自身の reorg リスクを反映した、より少ない回数を使用します。
- テストネットはテストを高速に保つため 1 confirmation です。テスト決済を Mainnet 級の確定性として扱わないでください。
特定のチェーンでより厳格な (またはより緩い) 確認数が必要な場合、 マーチャントアカウントごとに設定可能です — 担当者にご相談ください。
マーチャントでのチェーン有効化
新しいアカウントでは、多くのテストネットが最初から有効になっています。Mainnet ネットワークは、 アカウント認証を完了し、そのネットワーク用のトレジャリーウォレットを追加すると 利用可能になります (ウォレットの管理権を証明するメッセージに署名します)。
お支払いはお客様のトレジャリーウォレットに直接入金されます。InfraIO Payが資金を預かることはありません。
追加チェーンの有効化はマーチャントダッシュボードの Settings → Networks から行えます。
注文ごとの入金先アドレス (CREATE2、EVM)
EVM ネットワークでは、注文ごとの入金先アドレス (CREATE2 で生成) を使います。各アドレスは 1 回のチェックアウトに固有 で、事前に生成されます。 事前作成や事前資金は不要 — PaymentIntent でアドレスが返 されるので、それをバイヤーに表示するだけです。
- 同じマーチャントの 2 つの intent は 異なる アドレスを得ます — バイヤー 間で衝突しません。
- バイヤーはチェックアウトページで即座にアドレスを確認できます。
- バイヤーがセットアップ用のネットワーク手数料(ガス)を払うことはありません。資金はトレジャリーウォレットへ自動送金されます。 この転送ステップを sweep と呼びます(入金先アドレスの資金をトレジャリーウォレットへ集める処理)。 マーチャント側で追跡する必要はありません。
インテグレータへの実用上の含意:
- PaymentIntent で返される
deposit_addressは通常の EVM アドレスです — QR コードとして表示、スキャン、任意のウォレットからの送金が可能です。 特別なクライアントサポートは不要。 - intent が期限切れになる 前 にアドレスへ送金すると注文が決済されます。 期限切れ後の入金 (遅延入金) は、トレジャリーウォレットへ転送できる場合も ありますが、保証されないため、あてにしないでください。
- 各アドレスは intent ごとに使い切りです。バイヤーが 2 回目の試行を 必要とする場合、新しいチェックアウトセッションを発行してください — 新しい アドレスが得られます。
ウォレット直接決済ネットワーク
TRON、Solana、TON は EVM とは仕組みが異なります。注文ごとの入金先アドレスも sweep(トレジャリーウォレットへの転送)ステップもありません。購入者のウォレットが、マーチャントのトレジャリーウォレットへ直接支払います(「ウォレットへ直接」方式)。プラットフォーム手数料をオンチェーンで徴収する場合は、同じ支払いの中で分割されます(マーチャント取り分と手数料)。それ以外の場合、手数料は前払いクレジットから請求されます。どちらが適用されるかはマーチャントではなくプラットフォームが決定します。
| ネットワーク | 購入者の支払い方法 |
|---|---|
| TRON | TronLink。 チェックアウトが TronLink 内で開き、購入者が送金を承認します。 |
| Solana | Solana Pay。 購入者が Phantom、Solflare などの Solana Pay 対応ウォレットで QR コードをスキャンすると、ウォレットがチェックアウトからトランザクションを取得します。 |
| TON | TON Connect(Tonkeeper、Telegram Wallet、MyTonWallet)。購入者は 1 件のリクエストを承認します。送金には支払いを識別する注文参照コメントが付きます。 |
購入者がこれらのネットワークを選べるようにするには、マーチャントダッシュボードでそのネットワークファミリー用のトレジャリーウォレット(EVM、TRON、Solana、TON)を追加してください。受け付けるアドレス形式は次のとおりです。
- TRON —
T…で始まる base58 アドレス - Solana — base58 の公開鍵
- TON — ユーザーフレンドリー形式の
UQ…/EQ…(または raw 形式の0:…)、basechain のみ
これらのネットワークでは表示する入金先アドレスがないため、支払いはホスト型チェックアウトに任せてください。
現在サポートしていないもの
- Bitcoin / Lightning。 サポートしていません。
- ネイティブ通貨での支払い。 購入者はステーブルコインでのみ支払います。ネイティブコイン(ETH、BNB、POL、MNT、TRX、SOL、TON)は、どのネットワークでも支払いとして受け付けません。
- その他のステーブルコイン (USDe、FDUSD、…)。すでに有効なネットワーク上の 追加トークンをご希望の場合は、サポートにご連絡ください。
次に
- コンセプト → セッション — チェックアウト時に チェーン / アセットの選択がどう行われるか。
- スタート → イントロダクション — 大局的なモデル。