跳到正文

API

本页内容

支持的币种

在项目启用资产前,先确认 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"
}

转出仅支持加密资产。凡是持有余额的资产都可转出,但下面这张表是收款表,转出的范围更窄:NEARSUI 只收不转,不能作为转出目的地。剩下 11 个网络,具体走哪条仍看资产。

network——创建直接加密货币账单或转出时,currencynetwork 一起指定:

{
  "currency": "USDT",
  "network": "TRC20"
}

账单上有效的 network 值:TRC20ERC20BEP20POLYGONARBITRUMOPTIMISMBASETONAVAXSOLNEARSUIPLASMA。转出时是同一份清单,去掉 NEARSUI

定价模型

法币定价currency = USD/EUR/…)时,Paymos 在客户在托管收银台选定代币 + 网络的那一刻锁定汇率。客户随后支付等值的代币金额。锁定汇率作为 payment.exchange_rate 返回在账单上。

直接加密货币定价currency = USDT/USDC/…,带 network)时,客户按该代币该网络的精确金额支付。不涉及汇率换算。

结算始终以客户支付的资产进行。Paymos 绝不把加密货币换成法币:你把同一种资产转到自己的钱包,任何换法币的操作由你自行在 Paymos 之外安排。

法币

分组 代码
主要货币 USDEURGBPCHFCADAUDNZDJPY
欧洲 PLNCZKDKKSEKNOKHUF
独联体 RUBUAHGEL
亚洲 CNYHKDKRWINRIDRMYRPHPTHBVNDPKRSGDBDTLKRMMKTWD
美洲 BRLMXNARSCLPBMDVEF
中东 / 非洲 TRYAEDILSNGNZARBHDKWDSAR

代币

代币 符号 网络
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 -- -- -- -- -- -- -- -- -- -- --