Como levar códigos de verificação +975 do Butão para a sua suíte de testes

Por que uma equipe de produto iria querer um número butanês?

O Butão é um mercado pequeno, mas aparece em mais roadmaps do que se imagina: fluxos de reserva de viagens e hotelaria para visitantes do Himalaia, apps de pagamento e remessas usados por famílias butanesas com parentes que estudam ou trabalham no exterior e apps regionais que lançam em toda a Ásia do Sul ao mesmo tempo. Quem faz QA e precisa provar que um cadastro +975 realmente se completa não consegue isso com um chip do próprio país.

O idioma nacional é o dzonga, enquanto o inglês é amplamente usado em escolas, governo e negócios. A maioria dos textos de verificação que você verá numa rota do Butão são modelos curtos em inglês, mas, se o seu produto é localizado em dzonga, confira se o texto do seu próprio SMS é exibido corretamente antes do lançamento.

Há também o lado operacional. Operadoras de turismo, ONGs e consultorias que tocam projetos em Timbu ou Paro às vezes registram ferramentas compartilhadas de negócio com um número do Butão para que a equipe não precise entregar seus telefones pessoais. Para esse tipo de confirmação pontual, uma única ativação do gateway costuma bastar.

Quais apps conseguem enviar códigos para uma rota +975?

A lista atual do Butão cobre mais de 1.700 serviços. Entre os mais pedidos estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Viber, WeChat, Microsoft & Outlook, Amazon, Airbnb e Uber.

A disponibilidade nesta rota muda ao longo do dia, então trate qualquer lista como um retrato do momento. Seu código deve chamar GET /api/v1/services e GET /api/v1/countries antes de pedir, em vez de fixar o que existia na semana passada.

Qual é a ordem das chamadas para o id de país `bt`?

1. Autentique-se com uma chave Bearer (prefixo or_live_) criada no console do desenvolvedor, em https://otproute.com/api/v1.
2. Peça a GET /api/v1/prices?country=bt&service=<id> o preço atual desse par.
3. Faça o pedido com POST /api/v1/activations e o corpo {"service": "<id>", "country": "bt"}.
4. Consulte GET /api/v1/activations/{id} ou assine activation.sms_received, activation.expired e activation.cancelled.
5. Libere um número desnecessário com POST /api/v1/activations/{id}/cancel.

As requisições de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcule o HMAC-SHA256 sobre "<t>.<raw body>" com o segredo do endpoint e descarte timestamps antigos. O guia de captura por webhook mostra um handler completo, e a documentação da API lista todos os campos.

Cada conta pode ter até 10 chaves de API e 5 endpoints de webhook e enviar 300 requisições por minuto, o que é mais que suficiente para uma regressão noturna num mercado pequeno como este. Para um ritmo mais lento, um loop de polling que consulta a cada poucos segundos mantém o número de peças móveis no mínimo.

Como armazenar números +975?

Mantenha uma única forma canônica: +975 seguido dos dígitos nacionais, sem espaços, traços ou parênteses. Os celulares butaneses têm oito dígitos, menos que o padrão de dez dígitos que muitos validadores assumem, então afrouxe qualquer checagem de tamanho ajustada para mercados maiores. Se um usuário digitar um zero inicial por hábito, remova-o antes de salvar. Normalizar na borda mantém consistentes a deduplicação, as regras antifraude e as consultas do suporte.

Ao escrever fixtures para testes automatizados, inclua ao menos um número butanês junto com seus exemplos internacionais mais longos. Isso pega os bugs de tamanho que, de outra forma, só aparecem quando um usuário real em Timbu relata um formulário rejeitado.

E se o código do Butão não aparecer?

• Deixe a janela de 20 minutos terminar; alguns remetentes enfileiram mensagens.
• Confirme se o app de destino aceita números virtuais, pois alguns os recusam.
• Tente de novo um pouco mais tarde, ou escolha outra rota de serviço, em vez de martelar o endpoint de pedidos num loop.

Um número que não recebe nada não custa nada, porque o reembolso é automático. Mais táticas estão em como reduzir entregas de OTP que falham.

Ajuda também registrar o id da ativação junto do id da sua própria execução de teste, para que um código ausente possa ser rastreado em segundos em vez de adivinhado.

Linhas de longo prazo, cobrança e sandbox

A OTP Route não tem número de longo prazo em autoatendimento no Butão. As linhas dedicadas são um produto dos Estados Unidos e do Canadá a partir de $1.95/mês; para uma linha do Butão você pode escrever para [email protected], embora as regras locais decidam se isso é possível. Tudo funciona numa carteira pré-paga em USD sem mensalidade, recarregada com cartão ou USDT/USDC, com fatura em PDF a cada recarga. Contas de desenvolvimento podem solicitar o modo sandbox para ensaiar todo o fluxo bt com números simulados. Veja em preços como a carteira funciona.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app no Butão sem um chip local?

Sim. Peça um número +975 para o seu serviço no OTP Gateway, dispare o código a partir do app e leia-o no painel ou pela API.

Qual id de país a API usa para o Butão?

O Butão é bt. Informe-o na consulta de preços e no corpo da requisição de ativação.

Quanto custa um código de verificação do Butão?

Um código do Butão custa a partir de $0.20, e o valor varia conforme o serviço. O número exato vem de GET /api/v1/prices antes de você confirmar.

Em que idioma costumam chegar as mensagens OTP do Butão?

Em geral em inglês, comum nos negócios e na educação butaneses. O dzonga é o idioma nacional, então teste seus próprios modelos localizados se você enviar nele.

Sou cobrado se o número +975 não receber nada?

Não. Se nenhum SMS chegar em 20 minutos, ou se você cancelar antes, o valor total volta para a sua carteira automaticamente.

Posso manter um número do Butão para logins repetidos?

Não em autoatendimento. Os números de longo prazo são oferecidos apenas nos EUA e no Canadá; escreva para a equipe por e-mail e pergunte sobre o Butão.

É aceitável criar muitas contas com números do Butão?

Não. Use a OTP Route para testar e operar seus próprios produtos legítimos, siga os termos de cada serviço e lembre que a Política de Uso Aceitável se aplica.

Quais formas de pagamento a carteira aceita?

Cartões e as stablecoins USDT ou USDC. Você paga conforme o uso, sem plano para escolher.

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.