概述
本文档帮助您了解不同支付场景下支持的币种、公链和货币:- 收款:接收客户的稳定币付款
- 定价:使用熟悉的法币设置价格
- Off-Ramp 对接:将稳定币兑换为法币
本文档列出的代币是 Cobo Payments 支持的币种。虽然 Cobo 托管平台支持更广泛的代币种类,但只有下方列出的稳定币在 Payment 收款时才会自动入账。发送到 Payment 地址的其他代币将不会被自动处理。
套餐与支持范围
不同套餐支持的币种和公链范围不同:- Starter Test:仅支持 TRON Nile 测试网,可接收 USDT 测试币。测试币无真实价值,用于验证业务流程。
- Starter Live / Enterprise:支持以下所有主网币种和公链组合。
收款支持的币种和公链
以下为 Starter Live 和 Enterprise 套餐收款时可接收的稳定币和公链组合:如何选择合适的公链
链标识符
每条支持的公链都有一个chain_id 标识,它是一个字符串标识符(例如 ETH 或 TRON),而非数字 ID。Payments API 中使用的 token_id 由链标识符与代币符号组合而成,格式为 {chain_id}_{token_symbol}(例如 ETH_USDC 或 TRON_USDT)。
部分链标识符本身包含下划线(例如 AVALANCHE_C),且部分代币符号并非简单的币种代码。请始终使用上方支持的代币表中列出的准确 token_id 值,而不要自行拼接。
下表列出了各 chain_id 对应的完整公链名称及网络。以下公链在 Starter Live 和 Enterprise 套餐的收款场景中受支持。
如需通过 API 查询实时支持的公链和代币列表,请使用 List supported chains 和 List supported tokens 操作。
代币精度
每个支持的代币都有一个decimal 值 —— 即用于在代币的链上最小单位与可读显示金额之间转换的小数位数。例如,decimal 为 6 的代币,其 1 个显示单位在链上表示为 1000000 个最小单位。TRON_USDT 的 decimal 为 6,这是 USDT 的标准精度。
Payments API 的订单和交易金额以显示单位的字符串形式表示(例如 10.5),而非最小单位,因此在创建订单或读取 Payments API 返回的金额时无需应用 decimal。decimal 主要在您将 Payment 数据与链上最小单位金额进行对账时使用。
每个代币的 decimal 值可通过 List supported tokens 操作返回的 decimal 字段获取。同一稳定币在不同公链上的精度可能不同,因此请始终以该操作返回的值为准,而非假定固定值。
支持的定价货币
在创建支付订单时,您可以使用以下法币作为定价货币(pricing_currency)。系统会自动根据该币种的实时汇率计算应付金额。
汇率更新频率:每 10 分钟。您可以调用 Get exchange rate 查询当前汇率。
仅在收款时支持指定以下货币作为定价货币。加密货币入账后,如需进行 Off-Ramp 对接,仅支持转出 USD。
USD— 美元 (United States Dollar)CAD— 加元 (Canadian Dollar)MXN— 墨西哥比索 (Mexican Peso)BRL— 巴西雷亚尔 (Brazilian Real)ARS— 阿根廷比索 (Argentine Peso)CLP— 智利比索 (Chilean Peso)COP— 哥伦比亚比索 (Colombian Peso)PEN— 秘鲁新索尔 (Peruvian Nuevo Sol)EUR— 欧元 (Euro)GBP— 英镑 (British Pound Sterling)CHF— 瑞士法郎 (Swiss Franc)SEK— 瑞典克朗 (Swedish Krona)NOK— 挪威克朗 (Norwegian Krone)DKK— 丹麦克朗 (Danish Krone)PLN— 波兰兹罗提 (Polish Zloty)CZK— 捷克克朗 (Czech Koruna)HUF— 匈牙利福林 (Hungarian Forint)CNH— 离岸人民币 (Chinese Yuan Offshore)HKD— 港元 (Hong Kong Dollar)JPY— 日元 (Japanese Yen)KRW— 韩元 (South Korean Won)SGD— 新加坡元 (Singapore Dollar)TWD— 新台币 (New Taiwan Dollar)THB— 泰铢 (Thai Baht)MYR— 马来西亚林吉特 (Malaysian Ringgit)IDR— 印度尼西亚卢比 (Indonesian Rupiah)INR— 印度卢比 (Indian Rupee)AUD— 澳大利亚元 (Australian Dollar)NZD— 新西兰元 (New Zealand Dollar)PHP— 菲律宾比索 (Philippine Peso)VND— 越南盾 (Vietnamese Dong)AED— 阿联酋迪拉姆 (United Arab Emirates Dirham)SAR— 沙特里亚尔 (Saudi Riyal)QAR— 卡塔尔里亚尔 (Qatari Rial)KWD— 科威特第纳尔 (Kuwaiti Dinar)BHD— 巴林第纳尔 (Bahraini Dinar)ZAR— 南非兰特 (South African Rand)EGP— 埃及镑 (Egyptian Pound)NGN— 尼日利亚奈拉 (Nigerian Naira)KES— 肯尼亚先令 (Kenyan Shilling)TRY— 土耳其里拉 (Turkish Lira)ILS— 以色列新谢克尔 (Israeli New Sheqel)MAD— 摩洛哥迪拉姆 (Moroccan Dirham)
Off-Ramp 对接支持情况
以下表格列出了 Off-Ramp 对接时支持的币种和公链组合,以及各组合在开发环境和生产环境下的支持情况。标记为”需跨链费用”的币种和公链组合在进行 Off-Ramp 对接时,除常规费用外,还需额外支付跨链费用。例如,在生产环境将 BASE_USDC 进行 Off-Ramp 对接时,需额外支付跨链费用。
测试网
目前支持 TRON Nile 测试网,可接收 USDT 测试币。测试币无真实价值,不涉及真实资金。重要说明
Token ID 使用说明在与 Cobo API 集成时,请务必使用本文档中指定的准确 Token ID(如
ETH_USDC 或 TRON_USDT)。使用错误的 Token ID 将导致 API 报错。相关资源
- 获取 Payment 支持的代币列表 — 通过 API 查询 Payment 支持的代币(仅返回 Payment 支持的代币,而非 Cobo 托管支持的所有代币)
- 创建收款订单 — 了解如何使用定价货币创建支付订单
