简介/参考
参考资料
2328.io API 中使用的网络代码、币种与网络的对应关系以及支付状态值。
本页列出了 API 请求和响应中使用的所有参考值。
网络代码
以下代码用于所有出现 network 字段的位置：
| 代码 | 网络 |
|---|---|
TRX-TRC20 | Tron TRC-20 |
BSC-BEP20 | BNB Smart Chain |
ETH-ERC20 | Ethereum (ERC-20) |
AVAX-C | Avalanche C-Chain |
POL-MATIC | Polygon (Matic) |
TON | TON |
BTC | Bitcoin |
LTC | Litecoin |
DASH | Dash |
SOL | Solana |
DOGE | Dogecoin |
币种与网络的对应关系
每种币种仅在部分网络上可用。请使用此表选择有效的组合：
| 币种 | 允许的网络 |
|---|---|
USDT | TRX-TRC20, BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, TON, SOL |
USDC | BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, SOL |
BTC | BTC |
ETH | ETH-ERC20 |
BNB | BSC-BEP20 |
TRX | TRX-TRC20 |
LTC | LTC |
DASH | DASH |
TON | TON |
AVAX | AVAX-C |
POL | POL-MATIC |
SOL | SOL |
DOGE | DOGE |
支付状态
支付的 payment_status 字段以及 /v1/payment/list 过滤参数可取以下值：
| 状态 | 描述 |
|---|---|
pending | 已创建，等待初始化 |
check | 等待客户支付 |
paid | 支付成功 |
underpaid_check | 支付不足（可补足） |
underpaid | 支付不足 |
overpaid | 支付超额（已入账） |
cancel | 已取消 / 已过期 |
aml_lock | 交易因 AML 风控被锁定 |
监听支付成功时，应同时将 paid 和 overpaid 视为成功状态，并为客户订单入账。
提现状态
/v1/payout 与 /v1/payout/status/{uuid} 返回的 status 字段可取以下值之一：
| 状态 | 描述 |
|---|---|
pending | 已创建，等待处理 |
completed | 已成功完成 — txid 已设置 |
failed | 发送失败 — 详情见 error_type |
cancelled | 已取消 |
提现错误类型
当提现 status = failed 时，error_type 字段说明失败原因：
| 代码 | 描述 |
|---|---|
aml_risk | 提现被 AML 风控拦截（收款地址被标记为高风险） |