# 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.

## FAQ

**¿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.

Fuente: https://smsnitro.com/es/desarrolladores/ciclo-del-pedido