Skip to Content
入门简介
View as Markdown

简介

支付的构成

接入 InfraIO Pay 的商户需要处理四个环节：

结账会话

你在服务端创建一个会话，携带明细项和总额。响应中带有 session_key （cst_…）和 checkout_url。会话有时限（默认 30 分钟），且只能 使用一次。

托管收银台

你加载我们的浏览器 SDK 并打开该会话 — popup、redirect 或嵌入式 iframe。买家选择一个链 × 资产组合（例如 Polygon 上的 USDT、Base 上 的 ETH……），看到生成的每笔订单独立收款地址(CREATE2) + 二维码，并从自己的钱包发送资金。

支付确认

InfraIO Pay 会监控相应的网络，寻找与该会话独立收款地址匹配的入账 转账。一旦达到配置的确认数（例如 Ethereum 主网 12 个确认、Polygon 5 个确认 — 见链与资产），底层的 PaymentIntent 就会转为 SETTLED，其所属的 Order 也随之转为 PAID。

TRON、Solana 和 TON 没有独立收款地址。买家的钱包直接向你的资金库钱包付款(TronLink、Solana Pay 二维码或 TON Connect),InfraIO Pay 会识别这笔付款。见链与资产。

付款直接进入您的资金库钱包——InfraIO Pay 绝不托管您的资金。

Webhook

我们会向你注册的 Webhook URL POST 一个已签名的 payment.settled 事件。你的服务器验证签名，查找对应订单， 然后完成履约。

数据模型示意图

CheckoutSession  ←  1:1  →  Order  ←  1:N  →  PaymentIntent
   (有时限)                 (永久)            (每次支付尝试一个)

你为履约而思考订单，为收款而创建会话，系统则在背后为重试和 选择网络管理 PaymentIntent。

InfraIO Pay 负责什么，你负责什么

InfraIO Pay 负责你负责
托管收银台 UI（独立收款地址、二维码、资产选择器）在你的数据库中创建 Catalog + Order
跨 8 条 EVM 链以及 TRON、Solana、TON(即将推出)的链上监控 + 确认逻辑Webhook 接收端 + 签名验证
多资产稳定币结账(每个网络的 USDT、USDC)通过 external_ref 把我们的 order_id 映射到你自己的订单 ID
退款记账（状态机、仪表板、API）签名并广播链上退款交易
测试模式密钥 + 隔离的测试 Webhook从水龙头为测试网钱包充值

我们不托管商户资金。买家到商户的转账直接在链上完成；我们只是 索引 + 对账层，负责告诉你转账何时到账。

测试模式与生产模式

每个账户都从测试模式开始。测试密钥以 pk_test_ / sk_test_ 为前缀。生产密钥（pk_live_ / sk_live_）在你完成账户验证，并为每个要接收资金的网络添加资金库钱包（你签名一条消息， 证明自己控制该钱包）之后才能开通。

同一个 API base URL 同时服务这两种环境 — 环境由密钥前缀决定，而 不是 URL。测试模式运行在真实的测试网上（Sepolia、Base Sepolia、BSC Testnet 等）— 没有模拟链。要触发一笔测试支付，你需要 从水龙头领取真实的测试网资金。

联系 / 支持

有疑问或需要帮助？请发送邮件至 [email protected]。

InfraIO Pay 不是什么

  • 不是托管方。 资金在链上直接从买家转到你的资金库钱包。我们从 不持有你的余额。
  • 不要求使用特定钱包。 客户用自己的钱包付款 （托管收银台内置了 WalletConnect 选项）。InfraIO Wallet 是一款独立的非托管通行密钥钱包，并非必需。
  • 不是法币兑换通道。 买家用自己持有的加密资产付款；我们不做 兑换。
  • 不是比特币网关。 支持 8 条 EVM 网络以及 TRON、Solana、TON(即将推出)上的稳定币;不支持比特币或 Lightning。完整支持矩阵见链与资产。

下一步

欢迎快速入门