# Ciclo do pedido e cobrança

Um pedido passa de PENDING para RECEIVED quando o SMS chega e depois para FINISHED. Sem SMS, ele termina como CANCELED ou TIMEOUT e o valor reservado volta.

## Quando meu saldo é cobrado?

Só quando o SMS chega. Ao comprar, o preço do número fica reservado no saldo. A cobrança acontece quando o pedido vira RECEIVED. Se o pedido for cancelado, expirar ou for devolvido sem SMS, o valor reservado é liberado automaticamente.

## Status do pedido

| Status | Significado | Saldo |
|---|---|---|
| PENDING | Número entregue, aguardando o SMS | Preço reservado, sem cobrança |
| RECEIVED | O SMS chegou e o código está em messages | Cobrado |
| FINISHED | Você encerrou a ativação | Cobrado se chegou SMS, liberado se não chegou |
| CANCELED | Cancelado antes de qualquer SMS | Liberado |
| TIMEOUT | Expirou sem SMS | Liberado |
| BANNED | Devolvido porque o app diz que já está em uso | Liberado quando nenhum SMS chegou |

## Regras de tempo

- O número fica reservado por até 20 minutos. O campo expires traz o horário exato em UTC.
- Consulte GET /v1/orders/{id} a cada 3 a 5 segundos. Se nada chegar em uns 2 minutos, cancele e tente outro país ou servidor.
- No servidor 1, cancel e ban são aceitos cerca de 2 minutos depois da compra. Antes disso, a resposta é 400 com Wait about 2 minutes and try again.
- Cancel só funciona enquanto nenhum SMS chegou. Depois do SMS, use finish.

## Outro SMS no mesmo número

Alguns apps mandam um segundo código, por exemplo quando você entra de novo na conta. Chame resend depois que o primeiro código chegou, com o pedido ainda em RECEIVED e dentro da validade. Não há custo extra: awaiting_resend vira true e a nova mensagem é adicionada em messages.

## Quando o app recusa o número

Se o app disser que o número já está cadastrado ou bloqueado, chame ban. O número é devolvido e, se nenhum SMS chegou, o valor reservado é liberado. Depois compre outro número, de preferência de outro país ou servidor.

## FAQ

**E se eu nunca chamar finish?** Não tem problema. Um pedido que recebeu o SMS continua cobrado; a ativação só se encerra quando o número expira.

**Posso pedir estorno depois que o SMS chegou?** Não. Com o código entregue, a ativação está completa e cobrada. O estorno vale só para pedidos que terminam sem SMS.

Fonte: https://smsnitro.com/pt/desenvolvedores/ciclo-do-pedido