Ciclo del pedido y cobro
Un pedido pasa de PENDING a RECEIVED cuando llega el SMS y luego a FINISHED. Sin SMS termina como CANCELED o TIMEOUT y el importe reservado vuelve.
¿Cuándo se cobra mi saldo?
Solo cuando llega un SMS. Al comprar, el precio del número queda reservado en tu saldo. El cobro se hace cuando el pedido pasa a RECEIVED. Si el pedido se cancela, caduca o se devuelve sin SMS, el importe reservado se libera automáticamente.
Estados del pedido
| Estado | Significado | Saldo |
|---|---|---|
| PENDING | Número entregado, esperando el SMS | Precio reservado, sin cobro |
| RECEIVED | Llegó el SMS y el código está en messages | Cobrado |
| FINISHED | Cerraste la activación | Cobrado si llegó SMS, liberado si no |
| CANCELED | Cancelado antes de cualquier SMS | Liberado |
| TIMEOUT | Caducó sin SMS | Liberado |
| BANNED | Devuelto porque la app dice que ya está en uso | Liberado si no llegó ningún SMS |
Reglas de tiempo
- El número queda reservado hasta 20 minutos. El campo expires indica la hora exacta en UTC.
- Consulta GET /v1/orders/{id} cada 3 a 5 segundos. Si no llega nada en unos 2 minutos, cancela y prueba otro país u otro servidor.
- En el servidor 1, cancel y ban se aceptan unos 2 minutos después de la compra. Antes, la respuesta es 400 con Wait about 2 minutes and try again.
- Cancel solo funciona mientras no haya llegado ningún SMS. Después del SMS, usa finish.
Otro SMS en el mismo número
Algunas apps envían un segundo código, por ejemplo cuando vuelves a iniciar sesión. Llama a resend después de recibir el primer código, con el pedido todavía en RECEIVED y sin caducar. No tiene coste adicional: awaiting_resend pasa a true y el nuevo mensaje se añade a messages.
Cuando la app rechaza el número
Si la app dice que el número ya está registrado o bloqueado, llama a ban. El número se devuelve y, si no llegó ningún SMS, el importe reservado se libera. Después compra otro número, mejor de otro país o servidor.
Preguntas frecuentes
¿Qué pasa si nunca llamo a finish?
Nada malo. Un pedido que recibió el SMS sigue cobrado; la activación se cierra cuando el número caduca.
¿Puedo pedir un reembolso después de recibir el SMS?
No. Con el código entregado, la activación está completa y cobrada. El reembolso solo se aplica a pedidos que terminan sin SMS.