# Riferimenti

> Codici di rete, mappature valuta-rete e valori di stato dei pagamenti utilizzati nell'API di 2328.io.

Questa pagina elenca tutti i valori di riferimento utilizzati nelle richieste e nelle risposte dell'API.

## Codici di rete

Questi codici vengono utilizzati ovunque sia presente un campo `network`:

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

## Mappatura valuta-rete

Ogni valuta è disponibile solo su un sottoinsieme di reti. Utilizza questa tabella per scegliere una combinazione valida:

| Valuta | Reti consentite |
|----------|-----------------|
| `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 |

## Stati dei pagamenti

Il campo `payment_status` sui pagamenti e il filtro `/v1/payment/list` accettano i seguenti valori:

| Stato | Descrizione |
|--------|-------------|
| `pending` | Creato, in attesa di inizializzazione |
| `check` | In attesa del pagamento da parte del cliente |
| `paid` | Pagato con successo |
| `underpaid_check` | Pagamento insufficiente (è possibile integrare) |
| `underpaid` | Pagamento insufficiente |
| `overpaid` | Pagamento in eccesso (accreditato) |
| `cancel` | Annullato / scaduto |
| `aml_lock` | Transazione bloccata per AML |

> **INFO:** Quando ascolti un pagamento andato a buon fine, dovresti trattare sia `paid` sia `overpaid` come stati di successo e accreditare l'ordine del cliente.

## Stati dei prelievi

Il campo `status` su `/v1/payout` e `/v1/payout/status/{uuid}` assume uno dei seguenti valori:

| Stato | Descrizione |
|--------|-------------|
| `pending` | Creato, in attesa di elaborazione |
| `completed` | Completato con successo — `txid` è impostato |
| `failed` | Errore di invio — vedi `error_type` |
| `cancelled` | Annullato |

## Tipi di errore dei prelievi

Quando un prelievo ha `status = failed`, il campo `error_type` ne descrive il motivo:

| Codice | Descrizione |
|------|-------------|
| `aml_risk` | Prelievo bloccato dai controlli di rischio AML (l'indirizzo del destinatario è stato segnalato come ad alto rischio) |