Skip to Content
概念支援的鏈與資產
View as Markdown

支援的鏈與資產

InfraIO Pay 以穩定幣為主、支援多鏈:八條 EVM 網路,加上 TRON、Solana 與 TON。下方矩陣列出 InfraIO Pay 支援的網路。TRON、Solana 與 TON 即將上線正式環境。

Mainnet

鏈Chain ID原生USDCUSDT確認數最低訂單金額
Ethereum1ETH✓ (ERC-20)✓ (ERC-20)12$5.00
Base8453ETH✓ (ERC-20)—10$1.00
Polygon137POL✓ (ERC-20)✓ (ERC-20)5$1.00
BSC56BNB✓ (18-decimal)✓ (18-decimal)5$1.00
Arbitrum42161ETH✓ (ERC-20)✓ (ERC-20)5$1.00
Optimism10ETH✓ (ERC-20)✓ (ERC-20)5$1.00
ZKsync Era324ETH——5$1.00
Mantle5000MNT——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原生USDCUSDT確認數最低訂單金額
TRON728126428TRX—✓ (TRC-20)19$1.00
Solana1151111081099710SOL✓ (SPL)✓ (SPL)32$1.00
TON607000000000000TON—✓ (Jetton)1$1.00

Solana 與 TON 沒有 EVM 鏈 ID,因此上方的 ID 是 API 為它們使用的內部識別碼。此處列出的所有穩定幣都使用 6 位小數。TON 每個區塊都會最終確認,所以 1 次確認即為最終。

Testnet

鏈Chain ID原生確認數最低訂單金額
Ethereum Sepolia11155111ETH1$0.50
Base Sepolia84532ETH1$0.50
Polygon Amoy80002POL1$0.50
BNB Smart Chain Testnet97tBNB1$0.50
Arbitrum Sepolia421614ETH1$0.50
OP Sepolia11155420ETH1$0.50
Mantle Sepolia5003MNT1$0.50
ZKsync Sepolia300ETH1$0.50

Test 模式使用真實 testnet,而非模擬鏈。要觸發測試付款,你需要 實際的 testnet 資金 — 從水龍頭領取(例如 sepoliafaucet.com 、 coinbase.com/faucets ),再送到 結帳頁產生的每筆訂單獨立收款位址(CREATE2)。

TRON Nile, Solana Devnet, TON Testnet

鏈Chain ID原生測試穩定幣確認數最低訂單金額
TRON Nile3448148188TRXUSDT, IUSD19$0.50
Solana Devnet1151111081099711SOLUSDC, IUSD32$0.50
TON Testnet607000000000003TONIUSD1$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 步驟:買家的錢包直接付款到你的資金庫錢包。當平台手續費在鏈上收取時,會在同一筆付款中拆分出來(你的份額加上費用)。否則,費用會從你的預付額度扣除。採用哪一種由平台決定,而非商家。

網路買家如何付款
TRONTronLink。 結帳頁在 TronLink 內開啟,買家核准轉帳。
SolanaSolana Pay。 買家使用 Phantom、Solflare 或任何支援 Solana Pay 的錢包掃描 QR code;錢包會從結帳頁取得交易。
TONTON 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,申請在已啟用的 網路上新增代幣。

下一步