## USDT transfers (`usdt-transfers`)

Each on-chain transfer into the USDT receiving addresses; those not matching an order are credited or ignored by admins.

Authentication: Admin only · Docs: https://www.gocdn888.com/en/docs/api/usdt-transfers

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

List USDT transfers · Authentication: Admin only

Query parameters:

| Field | Type | Required | Description |
|---|---|---|---|
| `page` | integer |  | Page number, starting from 1 Default: 1 |
| `page_size` | integer |  | Items per page Default: 20 |
| `state` | string |  | Filter by state. Values: ["matched","unmatched","credited","ignored"] |
| `start` | string |  | Block time from (inclusive), RFC 3339. |
| `end` | string |  | Block time until (exclusive), 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`

Credit USDT transfer manually · Authentication: Admin only

Request body:

| Field | Type | Required | Description |
|---|---|---|---|
| `amount_cents` | integer | Yes | Amount to credit, in cents of the tenant's account currency; must be within ±2% of the transfer's USDT × rate, otherwise 422 usdt_credit_mismatch. |
| `rate` | string | Yes | Rate recorded on the order (1 USDT = rate units of the account currency); a decimal greater than 0 with at most 10 integer and 8 fraction digits (no exponent, fraction or sign). |
| `tenant_id` | integer | Yes | Tenant ID to credit. |

```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`

Ignore USDT transfer · Authentication: Admin only

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

USDT transfers object:

| Field | Type | Required | Description |
|---|---|---|---|
| `amount` | string |  | USDT received (4 decimals). |
| `amount_cents` | integer | Yes | Amount to credit, in cents of the tenant's account currency; must be within ±2% of the transfer's USDT × rate, otherwise 422 usdt_credit_mismatch. |
| `block_at` | string |  | Block time on chain. |
| `candidate` | object |  | The likely matching order (closest-amount unpaid order to the same address within a day); null if none. |
| `from_address` | string |  | Sender address. |
| `handled_at` | string |  | When it was handled manually. |
| `handled_by` | string |  | Who handled it (manual credit/ignore). |
| `id` | integer |  | Record ID |
| `order_id` | integer |  | The recharge order credited (set after automatic or manual crediting). |
| `rate` | string | Yes | Rate recorded on the order (1 USDT = rate units of the account currency); a decimal greater than 0 with at most 10 integer and 8 fraction digits (no exponent, fraction or sign). |
| `reason` | string |  | Why it was not credited automatically: underpaid/overpaid = paid less/more; expired = order expired; no_order = no order found; credit_failed = automatic crediting failed (e.g. the order tenant was deleted); dust = below the minimum order amount (ignored directly, no inbox message). Values: ["","underpaid","overpaid","expired","no_order","credit_failed","dust"] |
| `state` | string |  | matched = credited automatically; unmatched = pending; credited = credited manually; ignored = ignored. Values: ["matched","unmatched","credited","ignored"] |
| `tenant_id` | integer | Yes | Tenant ID to credit. |
| `to_address` | string |  | Receiving address (one of the channel's addresses). |
| `txid` | string |  | On-chain transaction ID. |
