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.
Perguntas frequentes
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.