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