Coletando OTPs bahamenses +1 242 com chamadas REST e webhooks

Quais requisições uma integração com a API de OTP das Bahamas precisa?

Uma integração com a API de OTP das Bahamas é uma curta cadeia de chamadas a https://otproute.com/api/v1, autorizada por uma chave Bearer com o prefixo or_live_ que você gera no console do desenvolvedor. O id do país das Bahamas é bs; ids de serviço como whatsapp ou telegram vêm do catálogo.

1. Carregue o catálogo com GET /api/v1/services e GET /api/v1/countries e guarde os ids na configuração, em vez de comparar pelos nomes exibidos.
2. Antes de cada pedido, solicite GET /api/v1/prices?country=bs&service=<id>. A resposta traz o preço atual e indica se há uma rota aberta neste momento, já que a disponibilidade muda ao longo do dia.
3. Crie a ativação com POST /api/v1/activations e o corpo {"service": "<id>", "country": "bs"}. Você recebe um id de ativação e um número +1 242.
4. Leve esse número à etapa de cadastro ou de login do produto em teste.
5. Espere o código por webhook ou faça polling em GET /api/v1/activations/{id}. Abandone uma execução com limpeza usando POST /api/v1/activations/{id}/cancel.

Uma conta pode ter até 10 chaves e enviar 300 requisições por minuto, então o staging, o CI e o notebook de um colega podem ter cada um uma chave separada, que você revoga individualmente. Os parâmetros e as respostas desta API de verificação por SMS estão na documentação da API.

Como verifico webhooks assinados para códigos +1 242?

O polling serve bem para uma verificação manual; quando várias suítes rodam lado a lado, a entrega por push é mais organizada. Registre até 5 endpoints no console do desenvolvedor e se inscreva em activation.sms_received, activation.expired e activation.cancelled.

Cada entrega traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstrua a string assinada como <t>.<raw body>, execute HMAC-SHA256 sobre ela com o segredo do endpoint e compare o resultado com v1 usando uma função de tempo constante. Trabalhe com os bytes exatamente como chegaram; reserializar o JSON já interpretado altera os espaços em branco e os hashes deixam de coincidir. Recuse qualquer timestamp com mais de alguns minutos, para que uma requisição capturada não possa ser reproduzida.

Use o id da ativação como chave do seu handler e torne-o idempotente, porque uma entrega repetida nunca deve marcar um teste como aprovado duas vezes. O artigo sobre como proteger webhooks de OTP com HMAC trata de dessincronia de relógio e rotação de segredos.

Quais serviços das Bahamas estão na rota, e a equipe pode pedir manualmente?

A rota das Bahamas lista atualmente mais de 900 serviços. Entre as escolhas populares estão WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber, Airbnb e Signal. Trate essa lista como um retrato do momento; o que vale é a resposta da API na hora do pedido.

Os colegas que nunca tocam em uma chave têm o mesmo resultado no navegador. Entre na conta, abra o OTP Gateway, selecione as Bahamas e o serviço, leia o preço exibido e faça o pedido. O número de verificação das Bahamas aparece com uma contagem regressiva, e o código é mostrado nessa mesma tela quando chegar.

O que acontece dentro da janela de 20 minutos, e se nada chegar?

Toda ativação fica aberta por 20 minutos. Se um SMS chegar nesse tempo, você paga o preço listado; se a janela se fechar vazia, ou se você cancelar antes, o valor total volta para a sua carteira automaticamente.

Quando um código bahamense não aparece:

• Deixe a janela correr até o fim antes de considerar o teste um fracasso; alguns remetentes enfileiram as mensagens.
• Tente de novo mais tarde ou por outra rota de serviço, porque o estoque e o comportamento dos remetentes mudam ao longo do dia.
• Verifique se o serviço aceita números virtuais. Alguns os recusam, e é exatamente por isso que o reembolso existe.
• Evite refazer pedidos em um loop apertado. Espere entre as tentativas para que um teste instável não consuma o seu orçamento de requisições.

Mais padrões de solução de problemas estão reunidos em como reduzir falhas na entrega de OTP.

Como um número +1 242 deve ser armazenado e normalizado?

As Bahamas fazem parte do Plano de Numeração Norte-Americano, então os seus números compartilham o código de país 1 com os Estados Unidos e o Canadá. Um número completo é o 1, o código de área 242 e um número de assinante de sete dígitos; em E.164 isso vira +1242 seguido de sete dígitos, onze no total. Os moradores costumam citar apenas os sete dígitos locais, enquanto quem liga de outras partes do plano disca um 1 antes do 242.

Duas consequências para o seu código. Um validador que deduz o país só pelo +1 vai classificar usuários bahamenses como americanos, então inspecione o código de área ou use uma biblioteca de numeração que conheça os territórios do NANP. E armazene todo número em E.164, formatando só para exibição, para que as buscas e a deduplicação permaneçam consistentes. Os textos de verificação em linhas bahamenses costumam vir em inglês, o idioma oficial, o que mantém as checagens de localização focadas na formatação de números e nos rótulos de país, e não em textos traduzidos.

Por que as equipes de produto testam cadastros com as Bahamas?

Turismo, hotelaria e serviços financeiros sustentam boa parte da economia bahamense, então plataformas de reservas, apps de transporte e entrega, produtos de pagamento e bancos com clientes caribenhos precisam de um caminho funcional para usuários +1 242. Um número +1 242 para testes permite que um engenheiro de QA confirme que um formulário aceita o número, que o seletor de países mostra as Bahamas em vez de incluí-las nos EUA e que o texto de consentimento de SMS é exibido corretamente. Um bom roteamento de OTP também significa escolher o país certo para cada caso de teste, em vez de adotar por padrão um número do continente. O guia de testes de QA mostra como ligar isso a suítes automatizadas. Mantenha todas as verificações em contas que a sua organização possui e siga os termos de cada serviço; a Política de Uso Aceitável da OTP Route se aplica a todos os pedidos.

Um número bahamense de longo prazo é possível, e como o uso é cobrado?

Não existe número de longo prazo em autoatendimento para as Bahamas. Os Números Dedicados são um produto dos EUA e do Canadá a partir de $1.95/mês, com SMS de entrada e de saída, chamadas pelo navegador e encaminhamento por webhook. Se a sua equipe precisa de uma linha bahamense contínua, escreva para [email protected]; se algo é possível depende das regras locais e não pode ser prometido.

O uso sai de uma única carteira pré-paga em USD, sem mensalidade e sem plano a escolher. Recarregue por cartão ou com USDT/USDC, e uma fatura em PDF chega à sua caixa de entrada a cada recarga. Para trabalhos de integração, peça para mudar uma conta de desenvolvimento para sandbox: ele retorna números e códigos simulados, e assim todo o fluxo pode ser exercitado sem gastar o saldo da carteira. A página de preços mostra como as cobranças aparecem.

Perguntas frequentes

Posso testar o fluxo de cadastro bahamense do meu app sem um chip local?

Sim. Peça um número +1 242 no OTP Gateway para o serviço que está testando, informe-o no seu fluxo e leia o código no painel ou por webhook. Você paga a partir de $0.20 por código, e só quando o SMS chega.

Qual é o id das Bahamas na API?

É bs. Passe-o a GET /api/v1/prices e no corpo de POST /api/v1/activations.

Minha biblioteca de telefones tratará +1 242 como um número dos EUA?

Só se ela deduzir o país apenas pelo código do país. Verifique o código de área ou use uma biblioteca que tenha dados dos territórios do NANP, para que os números bahamenses sejam rotulados corretamente.

Sou cobrado se o código nunca chegar?

Não. Quando nada chega em 20 minutos, ou se você cancelar, o valor total volta para a sua carteira automaticamente.

Posso manter um número de verificação das Bahamas para logins futuros?

Não como produto em autoatendimento. Os Números Dedicados de longo prazo existem apenas nos Estados Unidos e no Canadá; para uma linha bahamense, escreva para [email protected] e a equipe dirá o que as regras locais permitem.

Quantas requisições uma suíte de testes pode enviar?

Até 300 requisições por minuto por conta, distribuídas por até 10 chaves de API. Fazer polling a cada poucos segundos, ou migrar para webhooks, mantém você bem dentro desse limite.

Posso recarregar a carteira com stablecoins?

Sim. A carteira aceita cartões e USDT/USDC, e cada recarga vem com uma fatura em PDF por e-mail.

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.