# Ciclo dell’ordine e addebito

Un ordine passa da PENDING a RECEIVED quando arriva l’SMS e poi a FINISHED. Senza SMS termina come CANCELED o TIMEOUT e l’importo bloccato torna disponibile.

## Quando viene addebitato il mio saldo?

Solo quando arriva un SMS. All’acquisto il prezzo del numero viene bloccato sul saldo. L’addebito avviene quando l’ordine passa a RECEIVED. Se l’ordine viene annullato, scade o viene restituito senza SMS, l’importo bloccato si sblocca in automatico.

## Stati dell’ordine

| Stato | Significato | Saldo |
|---|---|---|
| PENDING | Numero assegnato, in attesa dell’SMS | Prezzo bloccato, nessun addebito |
| RECEIVED | L’SMS è arrivato e il codice è in messages | Addebitato |
| FINISHED | Hai chiuso l’attivazione | Addebitato se è arrivato l’SMS, sbloccato altrimenti |
| CANCELED | Annullato prima di qualsiasi SMS | Sbloccato |
| TIMEOUT | Scaduto senza SMS | Sbloccato |
| BANNED | Restituito perché l’app lo segnala come già usato | Sbloccato se non è arrivato alcun SMS |

## Regole sui tempi

- Il numero resta riservato fino a 20 minuti. Il campo expires indica l’ora esatta in UTC.
- Interroga GET /v1/orders/{id} ogni 3-5 secondi. Se non arriva nulla in circa 2 minuti, annulla e prova un altro paese o un altro server.
- Sul server 1, cancel e ban sono accettati circa 2 minuti dopo l’acquisto. Prima la risposta è 400 con Wait about 2 minutes and try again.
- Cancel funziona solo finché non è arrivato nessun SMS. Dopo l’SMS usa finish.

## Un altro SMS sullo stesso numero

Alcune app inviano un secondo codice, per esempio quando rientri nell’account. Chiama resend dopo l’arrivo del primo codice, con l’ordine ancora in RECEIVED e non scaduto. Non costa nulla in più: awaiting_resend diventa true e il nuovo messaggio si aggiunge a messages.

## Quando l’app rifiuta il numero

Se l’app dice che il numero è già registrato o bloccato, chiama ban. Il numero viene restituito e, se non è arrivato alcun SMS, l’importo bloccato si sblocca. Poi acquista un altro numero, meglio se di un altro paese o server.

## FAQ

**Cosa succede se non chiamo mai finish?** Niente di grave. Un ordine che ha ricevuto l’SMS resta addebitato; l’attivazione si chiude quando il numero scade.

**Posso chiedere un rimborso dopo l’arrivo dell’SMS?** No. Con il codice consegnato l’attivazione è completa e addebitata. Il rimborso vale solo per gli ordini che terminano senza SMS.

Fonte: https://smsnitro.com/it/sviluppatori/ciclo-dell-ordine