支持的链与资产
InfraIO Pay 以稳定币为先、支持多链:八条 EVM 网络,外加 TRON、Solana 和 TON。下面的矩阵列出了 InfraIO Pay 支持的网络。TRON、Solana 和 TON 即将上线生产环境。
主网
| 链 | 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 计的最低订单金额。默认值是主网 $1.00、测试网 $0.50,
Ethereum 为 $5,因为 Ethereum 上的网络手续费(gas)会把小额订单吃掉。
最低金额因网络而异。低于它的订单会被拒绝并返回 AMOUNT_BELOW_MINIMUM
(HTTP 400),details.floor_usd 携带该网络的最低金额,方便你展示给买家。
TRON、Solana 和 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 次确认即为最终。
测试网
| 链 | 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 )并发送 到结账页生成的每笔订单独立收款地址(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 指定 — 买家在结账页选择组合。
确认数与最终性
上表的”确认数”列是 InfraIO Pay 在把 PaymentIntent 移到 SETTLED 并发送
payment.settled 之前等待的区块数。各网络的数值经过选择,以降低发生重组
的可能:
- Ethereum 主网使用 12 个确认。
- L2 使用较低的数值,反映各网络自身的重组风险。
- 测试网使用 1 个确认,以保持测试快速。请勿把测试支付当作主网级最终性。
如果你需要对特定链使用更严格(或更宽松)的确认数,该值可在商户账户 按链配置 — 联系你的客户经理。
为你的商户启用链
新账户默认开通一组较宽的测试网。完成账户验证并为该网络添加资金库钱包 (你签名一条消息证明你控制该钱包)后,主网网络才会开放。
付款直接进入您的资金库钱包——InfraIO Pay 绝不托管您的资金。
从商户仪表板的 Settings → Networks 启用更多链。
每笔订单独立收款地址 (EVM)
EVM 上每笔订单都有自己的收款地址(CREATE2)。每个地址只属于一次结账, 并提前生成。你无需创建或注资:在 PaymentIntent 上就能拿到地址,把它展示给买家即可。
- 同一商户的两个 intent 得到不同地址 — 买家之间不会冲突。
- 买家在结账页能立刻看到该地址。
- 买家从不支付任何设置阶段的网络手续费(gas)。资金会自动转入你的资金库钱包;这一步叫 sweep(把资金从收款地址转入资金库钱包),无需你额外跟踪。
对集成方的实际影响:
- PaymentIntent 上返回的
deposit_address是普通 EVM 地址 — 你可以 把它显示为二维码、扫描它、从任何钱包向它发送。客户端无需特殊支持。 - 在 intent 过期之前向地址发送会结算订单。迟到的存款(过期后发送) 有时可以转入你的资金库钱包,但这不能保证,请勿依赖。
- 每个地址在每个 intent 是单次使用。如果买家需要第二次尝试,请铸造 新的结账会话 — 你会得到一个新地址。
直达钱包的网络
TRON、Solana 和 TON 采用直达钱包方式,工作方式与 EVM 不同。没有独立收款地址,也没有 sweep 步骤:买家的钱包直接向你的资金库钱包付款。当平台手续费在链上收取时,它会在同一笔付款中被拆分出来(你的份额加上费用)。否则,费用会从你的预付额度中扣除。具体采用哪种方式由平台决定,而不是商户。
| 网络 | 买家如何付款 |
|---|---|
| TRON | TronLink。 结账页在 TronLink 内打开,买家确认转账。 |
| Solana | Solana Pay。 买家用 Phantom、Solflare 或任何支持 Solana Pay 的钱包扫描二维码;钱包会从结账页获取交易。 |
| 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……)。如需在已启用的网络上增加代币,请 联系支持团队。