<!-- Source: https://docs.infraio.xyz/zh-CN/get-started/introduction -->
<!-- Last updated: 2026-10-04 -->

# 简介

## 支付的构成

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

### 结账会话

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

### 托管收银台

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

### 支付确认

InfraIO Pay 会监控相应的网络，寻找与该会话独立收款地址匹配的入账
转账。一旦达到配置的确认数（例如 Ethereum 主网 12 个确认、Polygon
5 个确认 — 见[链与资产](https://docs.infraio.xyz/zh-CN/concepts/chains)），底层的
PaymentIntent 就会转为 `SETTLED`，其所属的 Order 也随之转为
`PAID`。

TRON、Solana 和 TON 没有独立收款地址。买家的钱包直接向你的资金库钱包付款(TronLink、Solana Pay 二维码或 TON Connect),InfraIO Pay 会识别这笔付款。见[链与资产](https://docs.infraio.xyz/zh-CN/concepts/chains)。

> 付款直接进入您的资金库钱包——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 | 从水龙头为测试网钱包充值 |

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

## 测试模式与生产模式

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

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

## 联系 / 支持

有疑问或需要帮助？请发送邮件至 [contact@lartech.xyz](mailto:contact@lartech.xyz)。

## InfraIO Pay 不是什么

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

## 下一步

- [快速入门](https://docs.infraio.xyz/zh-CN/get-started/quickstart) — 约 10 分钟，复制粘贴
  即可完成你的第一次集成。
- [概念 → 会话](https://docs.infraio.xyz/zh-CN/concepts/sessions) — 深入了解数据模型。
- [SDK → JavaScript](https://docs.infraio.xyz/zh-CN/sdks/javascript) — 目前唯一已发布的
  SDK。
- [定价与费用](https://docs.infraio.xyz/zh-CN/concepts/pricing) — 交易量档位与折扣。
- [商户应用](https://docs.infraio.xyz/zh-CN/get-started/merchant-app) — 用手机管理你的业务。