业务流程
时序图
操作步骤
获取收款地址
商户调用 获取充值地址 接口，获取专属收款地址。同一商户在同一链上的收款地址固定不变。
展示给终端用户
商户在自己的支付页面展示收款地址和金额（或集成 Checkout 收银台 提供现成的 H5 支付页面）。
Webhook 通知
入账完成后，系统向商户推送 充值回调 事件，包含交易哈希、金额、币种等完整信息。
入账规则
支持的代币
通过 获取支持的代币列表 查询当前支持的充值币种。主要支持：- USDT：Ethereum、Tron、Arbitrum、Polygon、BSC、Base
- USDC：Ethereum、Arbitrum、Polygon、BSC、Base
计价与换算
终端用户充入的 USDT、USDC 等代币，统一换算为 NUSD 计价入账到商户钱包：| 参数 | 说明 |
|---|---|
| 充值金额 | 终端用户链上转账的原始金额 |
| 汇率 | 充值代币对 NUSD 的实时汇率 |
| 服务费 | 按项目配置的 Payin 费率计算 |
每笔交易的实际汇率和服务费在充值记录中可查，也会通过 Webhook 回调返回。
确认时间
不同链的区块确认时间不同：| 链 | 预估确认时间 | 说明 |
|---|---|---|
| Ethereum | ~2 分钟 | 需等待足够区块确认 |
| Tron | ~1 分钟 | |
| Arbitrum / Polygon / BSC / Base | ~30 秒 | L2 链确认较快 |
充值状态
| 状态 | 说明 |
|---|---|
| Pending | 交易已检测到，等待区块确认 |
| Confirming | 正在等待链上确认 |
| Completed | 确认完成，已入账 |
| Failed | 处理失败 |
异常情况
充错币种
如果终端用户向收款地址发送了不支持的代币（如平台仅支持 USDT，但用户转了 ETH），该笔充值不会自动入账。商户可通过管理后台的 工单系统 提交误充退款申请。小额充值
极小金额的充值（如几分钱）会正常入账。如需过滤小额充值，可在业务层自行处理。充值未到账
如果终端用户已发起转账但商户未收到 Webhook 通知：- 确认交易是否已上链（通过区块链浏览器查询）
- 确认 Webhook 端点是否正常响应
- 调用 交易记录 接口主动查询
下一步
Payout 付款方案
了解如何向外部地址发起付款。
Webhook 配置
配置 Webhook 接收交易通知。