# Références

> Codes de réseau, correspondances devise-réseau et valeurs de statut de paiement utilisés dans l'API 2328.io.

Cette page liste toutes les valeurs de référence utilisées dans les requêtes et réponses de l'API.

## Codes de réseau

Ces codes sont utilisés partout où un champ `network` est présent :

| Code | Réseau |
|------|--------|
| `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 |

## Correspondance devise-réseau

Chaque devise n'est disponible que sur un sous-ensemble de réseaux. Utilisez ce tableau pour choisir une combinaison valide :

| Devise | Réseaux autorisés |
|--------|-------------------|
| `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 |

## Statuts de paiement

Le champ `payment_status` sur les paiements et le filtre `/v1/payment/list` prennent les valeurs suivantes :

| Statut | Description |
|--------|-------------|
| `pending` | Créé, en attente d'initialisation |
| `check` | En attente du paiement du client |
| `paid` | Payé avec succès |
| `underpaid_check` | Sous-payé (peut être complété) |
| `underpaid` | Sous-payé |
| `overpaid` | Surpayé (crédité) |
| `cancel` | Annulé / expiré |
| `aml_lock` | Transaction bloquée pour cause d'AML |

> **INFO:** Lorsque vous attendez un paiement réussi, vous devez traiter à la fois `paid` et `overpaid` comme des états de succès et créditer la commande du client.

## Statuts de retrait

Le champ `status` sur `/v1/payout` et `/v1/payout/status/{uuid}` prend l'une des valeurs suivantes :

| Statut | Description |
|--------|-------------|
| `pending` | Créé, en attente de traitement |
| `completed` | Terminé avec succès — `txid` est défini |
| `failed` | Erreur d'envoi — voir `error_type` |
| `cancelled` | Annulé |

## Types d'erreurs de retrait

Lorsqu'un retrait a `status = failed`, le champ `error_type` indique la raison :

| Code | Description |
|------|-------------|
| `aml_risk` | Retrait bloqué par les contrôles de risque AML (adresse du destinataire signalée comme à haut risque) |