支持的付款方式、网络和币种
Taria Pay 支持买家使用稳定币付款。具体可用付款方式、网络和币种以商家后台、结账页和当前账户配置为准。
买家有两种付款方式
同一个结账页会根据当前网络展示最多两种付款方式,商家不需要做任何额外接入或配置:
| 方式 | 买家操作 | 适合谁 |
|---|---|---|
| 钱包支付 | 在结账页连接钱包(如 MetaMask、OKX、Trust 等),确认一笔交易 | 习惯使用链上钱包的买家 |
| 直接转账 | 结账页展示该笔订单专属的收款地址和二维码,买家从交易所提币或任意钱包按展示的网络、币种、金额转账 | 资产在交易所、不方便连接钱包的买家 |
关于直接转账,你需要知道的只有这些:
- 收款地址每笔订单唯一,不会复用。买家转账到账后,支付会自动确认,无需买家或商家做任何额外操作。
- 支付确认后,你收到的 webhook 事件、查询接口返回的状态与钱包支付完全一致,你的订单系统不需要区分买家用了哪种方式。
- 如果买家把款项误转到了另一条受支持的网络,系统会在资金实际到账的网络上完成确认,通常不需要人工介入。
- 直接转账按网络开通,是否可用以结账页实际展示为准。
- 退款方式不同:钱包支付可以按原路自动退回买家钱包;直接转账的链上付款方是我们为该订单分配的收款地址,不是买家地址,因此系统不会自动退款(接口会返回明确错误)。需要退款时请联系我们,由买家提供接收地址后人工处理。
商家可以自己控制展示
默认两种方式都展示、转账区收起。如果你想只保留其中一种,或让转账区默认展开(例如你的买家大多从交易所付款),可以在创建支付订单时用 paymentMethods 字段配置,无需其他改动。详见创建支付订单。
支持的稳定币
当前主要支持:
| 币种 | 说明 |
|---|---|
| USDC | 美元稳定币 |
| USDT | 美元稳定币 |
| EURC | 欧元稳定币 |
支持的网络
Taria Pay 会在结账页展示当前可用的支付网络。买家只需要在页面中选择可用网络,然后用钱包付款或直接转账完成支付。
公开文档不要求商家理解合约部署、监听服务或链上事件处理。你只需要关注:
- 买家能在结账页看到哪些支付选项
- 你的订单系统以 webhook 或查询接口的支付状态为准
- 上线前使用 test key 和小额订单完整测试一次
商家需要传 chainId 吗
通常不需要。创建支付订单时,你的服务端提供订单号、金额、币种、成功页和取消页即可。结账页会根据当前环境展示可用网络。