本页内容
支持的币种
在项目启用资产前,先确认 13 个区块链网络中哪些支持 USDT、USDC、USD1、DAI 和黄金锚定的 XAUT。
请求字段
currency 是统一的公开 API 字段。它可以是法币代码(如 USD),也可以是加密资产符号(如 USDT)。
法币账单:发送 currency,不带 network:
{
"amount": "100.00",
"currency": "USD"
}
直接加密货币账单和转出:发送 currency,带 network:
{
"amount": "50.00",
"currency": "USDT",
"network": "TRC20"
}
转出仅支持加密资产。凡是持有余额的资产都可转出,但下面这张表是收款表,转出的范围更窄:NEAR 和 SUI 只收不转,不能作为转出目的地。剩下 11 个网络,具体走哪条仍看资产。
network——创建直接加密货币账单或转出时,currency 与 network 一起指定:
{
"currency": "USDT",
"network": "TRC20"
}
账单上有效的 network 值:TRC20、ERC20、BEP20、POLYGON、ARBITRUM、OPTIMISM、BASE、TON、AVAX、SOL、NEAR、SUI、PLASMA。转出时是同一份清单,去掉 NEAR 和 SUI。
定价模型
法币定价(currency = USD/EUR/…)时,Paymos 在客户在托管收银台选定代币 + 网络的那一刻锁定汇率。客户随后支付等值的代币金额。锁定汇率作为 payment.exchange_rate 返回在账单上。
直接加密货币定价(currency = USDT/USDC/…,带 network)时,客户按该代币该网络的精确金额支付。不涉及汇率换算。
结算始终以客户支付的资产进行。Paymos 绝不把加密货币换成法币:你把同一种资产转到自己的钱包,任何换法币的操作由你自行在 Paymos 之外安排。
法币
| 分组 | 代码 |
|---|---|
| 主要货币 | USD、EUR、GBP、CHF、CAD、AUD、NZD、JPY |
| 欧洲 | PLN、CZK、DKK、SEK、NOK、HUF |
| 独联体 | RUB、UAH、GEL |
| 亚洲 | CNY、HKD、KRW、INR、IDR、MYR、PHP、THB、VND、PKR、SGD、BDT、LKR、MMK、TWD |
| 美洲 | BRL、MXN、ARS、CLP、BMD、VEF |
| 中东 / 非洲 | TRY、AED、ILS、NGN、ZAR、BHD、KWD、SAR |
代币
| 代币 | 符号 | 网络 |
|---|---|---|
| Tether USD | USDT |
TRC20、ERC20、BEP20、POLYGON、ARBITRUM、OPTIMISM、TON、AVAX、SOL、NEAR、PLASMA |
| USD Coin | USDC |
ERC20、BEP20、POLYGON、ARBITRUM、OPTIMISM、BASE、AVAX、SOL、NEAR、SUI |
| Tether Gold | XAUT |
ERC20 |
| Dai | DAI |
ERC20 |
| World Liberty USD | USD1 |
ERC20、SOL |
网络
Paymos 在为付款入账前等待与该网络相称的最终性。在数区块的链上,所需深度随付款的美元金额伸缩——小额快速确认,大额多等。原生最终性快的链——今天是 BNB Smart Chain、Polygon、Solana、Avalanche 和 Plasma——使用链的 finalized 标签而非区块数。确切的确认深度,以及哪条链归在哪一边,都属于运营参数,可能不经通知调整;每笔付款实际应用的值以 API 响应中的 required_confirmations 返回,当链按最终性而非固定区块数确认时为 null。请读这个字段,不要把网络清单写死在代码里。
| 网络 | 代码 | 类型 |
|---|---|---|
| Tron | TRC20 |
L1 |
| Ethereum | ERC20 |
L1 |
| BNB Smart Chain | BEP20 |
L1 |
| Polygon PoS | POLYGON |
L1 |
| Arbitrum One | ARBITRUM |
L2 |
| Optimism | OPTIMISM |
L2 |
| Base | BASE |
L2 |
| TON | TON |
L1 |
| Avalanche | AVAX |
L1 |
| Solana | SOL |
L1 |
| NEAR | NEAR |
L1 |
| Sui | SUI |
L1 |
| Plasma | PLASMA |
L1 |
代币-网络矩阵
不是每个加密资产都在每个网络上可用。下表列出所有有效组合:
| TRC20 | ERC20 | BEP20 | POLYGON | ARBITRUM | OPTIMISM | BASE | TON | AVAX | SOL | NEAR | SUI | PLASMA | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| USDT | 是 | 是 | 是 | 是 | 是 | 是 | -- | 是 | 是 | 是 | 是 | -- | 是 |
| USDC | -- | 是 | 是 | 是 | 是 | 是 | 是 | -- | 是 | 是 | 是 | 是 | -- |
| XAUT | -- | 是 | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |
| DAI | -- | 是 | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |
| USD1 | -- | 是 | -- | -- | -- | -- | -- | -- | -- | 是 | -- | -- | -- |