## USDT 到账 (`usdt-transfers`)

链上转入 USDT 收款地址的逐笔记录;对不上订单的由管理员补入或忽略。

鉴权: 仅管理员 · 文档: https://www-sa2.kuxitong.com/zh/docs/api/usdt-transfers

### GET `/api/v2/usdt-transfers`

USDT 到账 · 鉴权: 仅管理员

查询参数:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `page` | integer |  | 页码,从 1 开始。 默认: 1 |
| `page_size` | integer |  | 每页条数。 默认: 20 |
| `state` | string |  | 按状态过滤。 可选值: ["matched","unmatched","credited","ignored"] |
| `start` | string |  | 出块时间起(含),RFC 3339。 |
| `end` | string |  | 出块时间止(不含),RFC 3339。 |

```sh
curl "https://panel.example.com/api/v2/usdt-transfers" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/usdt-transfers/{id}/credit`

补入 USDT 到账 · 鉴权: 仅管理员

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `amount_cents` | integer | 有 | 入账金额(该用户账户币种的分);须在到账 USDT × rate 折算值的 ±2% 内,否则 422 usdt_credit_mismatch。 |
| `rate` | string | 有 | 记在订单上的汇率(1 USDT = rate 账户币种),大于 0 的十进制数,整数位 ≤10、小数位 ≤8(不收科学计数法、分数、正负号)。 |
| `tenant_id` | integer | 有 | 补入给哪个用户(租户 ID)。 |

```sh
curl -X POST "https://panel.example.com/api/v2/usdt-transfers/{id}/credit" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/usdt-transfers/{id}/ignore`

忽略 USDT 到账 · 鉴权: 仅管理员

```sh
curl -X POST "https://panel.example.com/api/v2/usdt-transfers/{id}/ignore" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

USDT 到账对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `amount` | string |  | 到账 USDT(4 位小数)。 |
| `amount_cents` | integer | 有 | 入账金额(该用户账户币种的分);须在到账 USDT × rate 折算值的 ±2% 内,否则 422 usdt_credit_mismatch。 |
| `block_at` | string |  | 链上出块时间。 |
| `candidate` | object |  | 疑似对应的订单(同地址近一天未付款单里金额最接近的);没有为 null。 |
| `from_address` | string |  | 转出地址。 |
| `handled_at` | string |  | 人工处理时间。 |
| `handled_by` | string |  | 处理人(人工补入/忽略时)。 |
| `id` | integer |  | 记录 ID |
| `order_id` | integer |  | 入账的充值单(自动入账或补入后才有)。 |
| `rate` | string | 有 | 记在订单上的汇率(1 USDT = rate 账户币种),大于 0 的十进制数,整数位 ≤10、小数位 ≤8(不收科学计数法、分数、正负号)。 |
| `reason` | string |  | 未自动入账的原因:underpaid/overpaid = 少付/多付;expired = 订单已过期;no_order = 找不到订单;credit_failed = 自动入账出错(如订单租户已删);dust = 低于最小下单额的零头转账(直接记已忽略,不发站内信)。 可选值: ["","underpaid","overpaid","expired","no_order","credit_failed","dust"] |
| `state` | string |  | matched = 自动入账;unmatched = 待处理;credited = 已人工补入;ignored = 已忽略。 可选值: ["matched","unmatched","credited","ignored"] |
| `tenant_id` | integer | 有 | 补入给哪个用户(租户 ID)。 |
| `to_address` | string |  | 收款地址(本站渠道里的某个地址)。 |
| `txid` | string |  | 链上交易号。 |
