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