Cycle de commande et facturation
Une commande passe de PENDING à RECEIVED à l’arrivée du SMS, puis à FINISHED. Sans SMS, elle se termine en CANCELED ou TIMEOUT et le montant réservé revient.
Quand mon solde est-il débité ?
Seulement à l’arrivée d’un SMS. À l’achat, le prix du numéro est réservé sur le solde. Le débit a lieu quand la commande passe à RECEIVED. Si la commande est annulée, expire ou est rendue sans SMS, le montant réservé est libéré automatiquement.
Statuts de commande
| Statut | Signification | Solde |
|---|---|---|
| PENDING | Numéro attribué, en attente du SMS | Prix réservé, pas de débit |
| RECEIVED | Le SMS est arrivé, le code est dans messages | Débité |
| FINISHED | Vous avez clôturé l’activation | Débité si un SMS est arrivé, libéré sinon |
| CANCELED | Annulée avant tout SMS | Libéré |
| TIMEOUT | Expirée sans SMS | Libéré |
| BANNED | Rendue car l’application la signale comme déjà utilisée | Libéré si aucun SMS n’est arrivé |
Règles de délai
- Le numéro reste réservé jusqu’à 20 minutes. Le champ expires donne l’heure exacte en UTC.
- Interrogez GET /v1/orders/{id} toutes les 3 à 5 secondes. Si rien n’arrive en 2 minutes environ, annulez et essayez un autre pays ou un autre serveur.
- Sur le serveur 1, cancel et ban sont acceptés environ 2 minutes après l’achat. Avant, la réponse est 400 avec Wait about 2 minutes and try again.
- Cancel ne fonctionne que tant qu’aucun SMS n’est arrivé. Après le SMS, utilisez finish.
Un autre SMS sur le même numéro
Certaines applications envoient un second code, par exemple lors d’une nouvelle connexion. Appelez resend après l’arrivée du premier code, tant que la commande est en RECEIVED et non expirée. Aucun coût supplémentaire : awaiting_resend passe à true et le nouveau message s’ajoute à messages.
Quand l’application refuse le numéro
Si l’application indique que le numéro est déjà enregistré ou bloqué, appelez ban. Le numéro est rendu et, si aucun SMS n’est arrivé, le montant réservé est libéré. Achetez ensuite un autre numéro, de préférence dans un autre pays ou sur l’autre serveur.
Questions fréquentes
Que se passe-t-il si je n’appelle jamais finish ?
Rien de grave. Une commande qui a reçu le SMS reste débitée ; l’activation se clôt à l’expiration du numéro.
Puis-je être remboursé après l’arrivée du SMS ?
Non. Une fois le code livré, l’activation est terminée et débitée. Le remboursement ne concerne que les commandes qui se terminent sans SMS.