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.
Domande frequenti
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.