Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
A resposta curta: três campos decidem o comportamento de cada código: length (de 4 a 8 algarismos, 6 por omissão), expires_in (de 1 a 60 minutos, 5 por omissão) e max_attempts (de 1 a 10 tentativas erradas, 5 por omissão). Se não enviar nenhum, ficam as omissões, que já servem a maioria dos casos. Mude-os quando o uso o pedir.
Os três campos
| Campo | O que controla | Valores | Omissão |
| length | Quantos algarismos tem o código | 4 a 8 | 6 |
| expires_in | Os minutos em que o código vale | 1 a 60 | 5 |
| max_attempts | As tentativas erradas antes de o código falhar | 1 a 10 | 5 |
Tamanho: a conta de quem tenta adivinhar
Com 6 algarismos há um milhão de códigos possíveis. Com 5 tentativas, quem escreve números ao acaso acerta, em média, 5 vezes em cada milhão de códigos. Com 4 algarismos são só dez mil códigos, e as mesmas 5 tentativas dão 5 em cada dez mil: cem vezes mais fácil. É por isso que 6 é a omissão: fácil de escrever, difícil de adivinhar. Use 8 quando a operação vale muito; use 4 só quando o risco é baixo e a pressa é grande.
Validade e tentativas para cada caso
| Caso | length | expires_in | max_attempts |
| Confirmar o número no registo | 6 | 5 a 10 | 3 a 5 |
| Segundo passo da entrada | 6 | 5 | 3 a 5 |
| Pagamento ou transferência | 6 a 8 | 5 | 3 |
| Entrega à porta | 6 | até 60, perto da chegada | 3 a 5 |
As sugestões seguem as boas práticas da página do SMS de Verificação: 6 algarismos, validade de 5 a 10 minutos e entre 3 e 5 tentativas. Validades de horas ou dias não existem nesta API, e ainda bem: um código serve para agora, não para amanhã.
| As tentativas não voltam com um reenvio. POST /v1/sms/otp/{id}/resend envia um código novo e a validade volta a contar, mas as tentativas erradas já gastas continuam gastas. Com max_attempts a 3 e duas falhadas, o código reenviado tem só uma tentativa. Para começar do zero, peça um código novo com POST /v1/sms/otp. |
| Escreva a validade no texto com {minutes}, que nós trocamos pelo valor de expires_in: o cliente sabe que tem de se despachar. Veja como escrever o SMS de verificação. |
|
Quer escolher o tamanho, a validade e as tentativas de cada código? Veja o SMS de Verificação. Ver o SMS de Verificação |
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 396,00 MT/mês (plano de 3 anos, com cupão) Ver planos |
