# 参考资料

> 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 风控被锁定 |

> **INFO:** 监听支付成功时，应同时将 `paid` 和 `overpaid` 视为成功状态，并为客户订单入账。

## 提现状态

`/v1/payout` 与 `/v1/payout/status/{uuid}` 返回的 `status` 字段可取以下值之一：

| 状态 | 描述 |
|------|------|
| `pending` | 已创建，等待处理 |
| `completed` | 已成功完成 — `txid` 已设置 |
| `failed` | 发送失败 — 详情见 `error_type` |
| `cancelled` | 已取消 |

## 提现错误类型

当提现 `status = failed` 时，`error_type` 字段说明失败原因：

| 代码 | 描述 |
|------|------|
| `aml_risk` | 提现被 AML 风控拦截（收款地址被标记为高风险） |