支援的鏈與資產
InfraIO Pay 以穩定幣為主、支援多鏈:八條 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-decimal) | ✓ (18-decimal) | 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,因為 Ethereum
的網路手續費(gas)會超過小額訂單的金額。各網路的最低金額可能不同。
低於最低金額的訂單會被以 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 位小數。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 |
Test 模式使用真實 testnet,而非模擬鏈。要觸發測試付款,你需要 實際的 testnet 資金 — 從水龍頭領取(例如 sepoliafaucet.com 、 coinbase.com/faucets ),再送到 結帳頁產生的每筆訂單獨立收款位址(CREATE2)。
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 是測試穩定幣,僅供測試使用。
API 中使用的貨幣代碼
currency(頂層 + 每個 line item)是 訂單的顯示貨幣 —
買家看到的金額單位。目前建立時只接受一個代碼:
"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)回傳給你。用於支付網路手續費(gas)的原生代幣(ETH、BNB、POL、
MNT, TRX, SOL, TON)只是鏈的元資料,不是有效的付款貨幣。
鏈本身也基於同樣理由不在建立時由 API 指定 — 買家在結帳頁選擇組合。
確認數 vs 最終性
上方「確認數」欄是 InfraIO Pay 在將 PaymentIntent 切到 SETTLED 並發出
payment.settled 之前所等待的區塊數。各網路的數量經過挑選,
以降低重組的可能性:
- Ethereum mainnet 使用 12 個確認。
- L2 使用較低的數量,反映各網路自身的重組風險。
- Testnet 使用 1 個確認,以保持測試快速。不要把測試付款視為 mainnet 等級的最終性。
若你對特定鏈需要更嚴格(或更寬鬆)的確認數,每條鏈的數量可在商家 帳號上設定 — 請與你的帳號聯絡窗口聯繫。
為你的商家啟用鏈
新帳號一開始會有一組範圍較廣的測試網。完成帳號驗證,並為該網路新增 資金庫錢包後(你需簽署訊息以證明你控制該錢包),即可使用 mainnet 網路。
付款會直接進入您的資金庫錢包 — InfraIO Pay 絕不保管您的資金。
請從商家儀表板的 Settings → Networks 啟用額外的鏈。
每筆訂單獨立收款位址 (EVM)
在 EVM 上,每筆訂單都有自己的收款位址(CREATE2),每個位址專屬於一次結帳,並會預先產生。你不需要建立或儲值 任何東西:在 PaymentIntent 上取得位址,顯示給買家即可。
- 同一商家的兩個 intent 會取得不同位址 — 跨買家間不會碰撞。
- 買家在結帳頁會立即看到該位址。
- 買家從不支付任何設定階段的網路手續費(gas)。資金會自動轉入你的資金庫錢包,你不需要額外追蹤。
對整合者的實務影響:
- PaymentIntent 上回傳的
deposit_address是普通的 EVM 位址 — 你可 以將它顯示為 QR code、掃描、從任何錢包轉到它。不需要特別的 client 支援。 - 在 intent 過期之前送到該位址會結算訂單。過期後送出的延遲入金, 有時可以轉入你的資金庫錢包,但無法保證,請不要依賴這一點。
- 每個位址在每個 intent 中只能使用一次。若買家需要第二次嘗試, 請鑄造新的結帳 session — 你會取得新的位址。
直達錢包的網路
TRON、Solana 與 TON 採用直達錢包方式,運作方式與 EVM 不同。沒有獨立收款位址,也沒有 sweep 步驟:買家的錢包直接付款到你的資金庫錢包。當平台手續費在鏈上收取時,會在同一筆付款中拆分出來(你的份額加上費用)。否則,費用會從你的預付額度扣除。採用哪一種由平台決定,而非商家。
| 網路 | 買家如何付款 |
|---|---|
| TRON | TronLink。 結帳頁在 TronLink 內開啟,買家核准轉帳。 |
| Solana | Solana Pay。 買家使用 Phantom、Solflare 或任何支援 Solana Pay 的錢包掃描 QR code;錢包會從結帳頁取得交易。 |
| TON | TON Connect(Tonkeeper、Telegram Wallet、MyTonWallet)。買家核准一次請求;轉帳會附帶一則用來識別該筆付款的訂單參考備註。 |
買家能選擇這些網路之前,請在商家後台為該網路家族新增資金庫錢包(EVM、TRON、Solana 或 TON)。支援的位址格式:
- TRON — 以
T…開頭的 base58 位址 - Solana — base58 公鑰
- TON — 使用者友善格式
UQ…/EQ…(或原始格式0:…),僅支援 basechain
這些網路沒有可顯示的獨立收款位址,因此請讓託管結帳頁來驅動付款流程。
目前不支援
- Bitcoin / Lightning。 不支援。
- 原生幣付款。 買家只能以穩定幣付款。原生幣(ETH、BNB、POL、MNT、TRX、SOL、TON)在任何網路上都不接受作為付款方式。
- 其他穩定幣(USDe、FDUSD、…)。請聯絡 support,申請在已啟用的 網路上新增代幣。
下一步
- 概念 → Sessions — 結帳時鏈 / 資產的 選擇是怎麼發生的。
- Get started → 介紹 — 全貌模型。