Checklist para receber códigos SMS do Bolt em números da OTP Route

Onde o Bolt pede um número de telefone?

O Bolt, empresa de mobilidade fundada em Tallinn, por trás de transporte por aplicativo, entrega de comida e de compras e aluguel de patinetes, constrói as contas em torno de um número de celular. O app de passageiros confirma esse número com um código único por SMS no cadastro, e o mesmo tipo de código costuma reaparecer quando alguém entra em um novo dispositivo ou recupera o acesso. Os produtos para motoristas, entregadores e empresas seguem um padrão parecido.

Para uma empresa, isso significa que o número de telefone do Bolt é, na prática, a chave da conta. Equipes que mantêm uma conta corporativa de viagens, que verificam como a própria integração com parceiros se comporta em uma cidade nova ou que querem manter o chip pessoal de um funcionário fora de um login de trabalho compartilhado precisam de uma forma controlada de receber esse código.

Checklist antes de pedir um número do Bolt

Percorra estes pontos antes de gastar qualquer valor:

• O propósito é legítimo: a conta pertence à sua organização ou é uma conta de teste para o seu próprio produto, e os termos do Bolt permitem isso.
• O mercado está escolhido: o país do número corresponde ao lugar onde a conta vai operar. Uma conta de passageiro registrada com o número de um país e usada em outro pode se comportar de forma diferente.
• A chave de API está pronta: uma chave Bearer com o prefixo or_live_, criada no Developer console (até 10 por conta).
• O endpoint de webhook foi testado: inscrito em activation.sms_received, com a verificação de assinatura ativada.
• A carteira tem saldo: confirme com GET /api/v1/balance ou peça o modo sandbox para ensaiar o fluxo com números simulados.
• O plano B está combinado: decida de antemão o que o teste faz se nenhum código voltar.

Quais países têm rotas do Bolt?

As rotas do Bolt estão listadas hoje para 198 países. Entre os exemplos estão Estônia, Letônia, Lituânia, Polônia, República Tcheca, Portugal, Alemanha, Croácia, Malta, Geórgia, África do Sul, Nigéria, Quênia, Gana, Tanzânia e Uganda.

Escolha o país com critério. Os recursos, as formas de pagamento e as verificações de cadastro do Bolt variam por mercado; por isso, um teste em Varsóvia diz pouco sobre um fluxo em Nairóbi. A disponibilidade por país muda ao longo do dia; GET /api/v1/prices e o painel mostram o que está ativo.

Passo a passo: a API de código de verificação do Bolt

1. Confirme o id do serviço com GET /api/v1/services; para o Bolt, é bolt.
2. Escolha o id do país em GET /api/v1/countries, por exemplo ee para a Estônia.
3. Leia o preço em tempo real: GET /api/v1/prices?country=ee&service=bolt.
4. Faça o pedido: POST /api/v1/activations com {"service": "bolt", "country": "ee"}. Guarde o id de ativação e o número retornado.
5. Digite o número no app do Bolt no seu dispositivo de teste e solicite o SMS.
6. Trate o evento activation.sms_received. Verifique X-OTPRoute-Signature: t=<unix>,v1=<hex> calculando HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, rejeite timestamps antigos e use o id de ativação como chave das gravações, para que uma entrega repetida não altere nada.
7. Se os webhooks não forem uma opção, faça polling em GET /api/v1/activations/{id} a cada poucos segundos, bem dentro do limite de 300 requisições por minuto.
8. Chame POST /api/v1/activations/{id}/cancel se o teste for abandonado.

Os detalhes dos endpoints estão na documentação da API, e como proteger webhooks de OTP explica a verificação da assinatura.

Passo a passo: o caminho pelo painel

Para uma única verificação por SMS do Bolt em testes ou para a configuração pontual de uma conta, o navegador basta. Entre na conta, abra o OTP Gateway, selecione Bolt e o mercado, confira o preço e confirme. Copie o número para o app, solicite o código e veja-o aparecer no cartão do pedido antes de o cronômetro de 20 minutos acabar.

Solução de problemas: o código do Bolt nunca apareceu

Uma janela vazia não custa nada; quando 20 minutos passam sem SMS, ou você cancela, o valor integral volta para a sua carteira. Motivos comuns e correções:

• O Bolt recusou o número: como muitas plataformas, ele não aceita número virtual no cadastro do Bolt em todos os mercados. Tente outra rota de país, se o seu teste permitir, ou uma tentativa mais tarde.
• Entrega lenta: o tempo depende do serviço e da rota; por isso, deixe a janela terminar antes de cancelar.
• Pedidos repetidos: tocar várias vezes em reenviar ou refazer o pedido em laço pode acionar a própria limitação do Bolt. Espace as tentativas.
• Mercado errado: um número de um país que o Bolt não atende no seu cenário de teste pode nunca ser aceito.

O guia sobre roteamento por país para OTP trata da escolha de alternativas.

Quando um Dedicated Number é mais adequado?

Um número de uso único serve para uma única verificação. Se uma conta do Bolt precisa entrar de novo semanas depois, por exemplo um perfil de passageiro de staging que sua equipe de QA reutiliza, ou um login de operações verificado de novo em novos dispositivos, o número precisa continuar com você. Os Dedicated Numbers fazem isso, mas apenas nos Estados Unidos e no Canadá, a partir de $1.95/month, com SMS recebidos no painel e encaminhados ao seu webhook como number.sms_received. Verifique se o mercado do Bolt da conta funciona com um número dos EUA ou do Canadá antes de depender de um. Veja os detalhes em números virtuais.

Como usar números do Bolt com responsabilidade

Siga os termos de serviço do Bolt em todos os mercados. Mantenha uma conta por pessoa real ou empresa e use a OTP Route apenas para testar os seus próprios produtos ou operar contas legítimas que a sua organização possui; criar perfis de passageiro descartáveis ou juntar promoções não é uso aceitável. A Política de Uso Aceitável da OTP Route vale para cada pedido, e Bolt é marca registrada de seu titular, sem nenhuma afiliação implícita.

Perguntas frequentes

Posso receber um OTP do Bolt sem um chip local?

Sim. Peça um número para o serviço bolt no país certo, digite-o no app e leia o código no painel ou pela API.

Qual é o id de serviço do Bolt na API?

É bolt. Combine-o com um id de país como pl ou ke ao chamar POST /api/v1/activations.

Quanto custa um número de verificação do Bolt?

A partir de $0.20 por código. O valor exato depende do país e vem em tempo real de GET /api/v1/prices.

O Bolt aceita qualquer número virtual?

Não. O Bolt pode rejeitar números virtuais em alguns mercados ou fluxos, e é por isso que um código não entregue é reembolsado automaticamente.

Qual país devo escolher para um teste do Bolt?

Use o país em que a conta realmente será usada, para que as regras de cadastro, o idioma e as formas de pagamento correspondam ao que os usuários reais veem.

Posso manter o mesmo número para futuros logins no Bolt?

Não com uma ativação de uso único. Para logins repetidos, um Dedicated Number nos EUA ou no Canadá é a opção self-service.

Posso testar o fluxo antes de pagar?

Sim. Peça o modo sandbox em uma conta de desenvolvimento para receber números e códigos simulados sem gastar saldo da carteira.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.