Checklist de pré-voo para receber códigos de verificação +375 de Belarus

O que deve estar pronto antes de pedir um número +375?

Antes de usar um número +375 para testes, confira estes itens:

• Uma conta e uma carteira com saldo. Crie uma em /signup com um e-mail e um código de 6 dígitos enviado por e-mail, ou com o login do Google, e depois adicione um pequeno saldo. Ative a autenticação em dois fatores TOTP na conta que guarda as chaves de API.
• Uma chave Bearer com o prefixo or_live_, criada no console do desenvolvedor. Dê chaves separadas ao CI e ao desenvolvimento local; uma conta pode ter até 10.
• Os dois ids que você vai enviar. Belarus é by na API, e o id do serviço é o valor api_service devolvido por GET /api/v1/services.
• Um endpoint receptor, se você pretende usar webhooks, com o segredo de assinatura guardado fora do repositório.
• Uma conta de teste no seu próprio produto que possa alterar ou adicionar um número de telefone.
• Uma biblioteca de telefone configurada para a região BY, para que o número colado no seu formulário de cadastro seja interpretado como um usuário belarusso de verdade o digitaria.

Como os números belarussos são escritos e como o seu app deve armazená-los?

Belarus usa o código de país +375 seguido de um número nacional de nove dígitos. As linhas móveis começam com códigos de operadora como 25, 29, 33 ou 44, então um valor armazenado parece +37529XXXXXXX.

O ponto delicado é o hábito doméstico. Dentro do país, as pessoas costumam escrever um número de celular com um 80 na frente, como em 8 029 XXX-XX-XX, que vem do prefixo de discagem de longa distância. Esse 80 precisa ser removido antes de o código de país ser acrescentado; um formulário que o mantém produz uma string E.164 inválida, que alguns serviços de verificação rejeitam em silêncio. Bons testes de normalização para um número de verificação de Belarus:

• aceitar +375 29 ..., 375 29 ... e 8 029 ... e armazenar os três de forma idêntica;
• exibir o número em um agrupamento amigável localmente, mas enviar apenas E.164 à sua camada de SMS ou de verificação;
• rejeitar um número que ainda tenha 80 depois do 375.

O belarusso e o russo são ambos idiomas oficiais, e o russo é o que a maioria das pessoas usa no dia a dia. Muitos serviços enviam o texto do código em russo ou em inglês, conforme a localidade da conta, então verifique se o seu app exibe o cirílico corretamente em qualquer tela que repita a mensagem.

Para quais serviços um número de verificação de Belarus pode receber códigos?

O roteamento de OTP para Belarus na OTP Route cobre atualmente mais de 1.400 serviços sob o id by. As rotas populares no retrato atual incluem Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Amazon e AliExpress.

A disponibilidade em qualquer rota individual muda ao longo do dia, então trate uma lista como esta como ponto de partida, e não como promessa. Antes de uma execução, consulte GET /api/v1/prices?country=by&service=<id> para saber o preço atual e se a rota pode aceitar um pedido agora. Veja o roteamento de OTP por país ao escolher entre países.

Passo a passo: o fluxo da API OTP de Belarus a partir de um script de teste

Toda requisição vai para https://otproute.com/api/v1 com a sua chave Bearer. A API de verificação por SMS é pequena o bastante para caber em um único helper:

1. Chame GET /api/v1/balance e interrompa o job cedo se a carteira estiver baixa demais para a suíte.
2. Chame GET /api/v1/prices?country=by&service=telegram (troque pelo seu id de serviço) e registre em log o preço que você está prestes a pagar.
3. Crie o pedido com POST /api/v1/activations e um corpo como {"service": "telegram", "country": "by"}. Guarde o id de ativação e o número +375 da resposta.
4. Envie esse número à etapa de telefone do seu próprio app e dispare o código.
5. Colete o código de um evento activation.sms_received ou faça polling em GET /api/v1/activations/{id}. O limite é de 300 requisições por minuto.
6. Se o teste for abortado, chame POST /api/v1/activations/{id}/cancel para que o valor retido volte de imediato para a carteira.

Para webhooks, leia o cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>), calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte entregas com timestamp antigo. Use o id da ativação como chave do handler, de modo que uma entrega repetida seja inofensiva. A documentação da API e o guia sobre proteger webhooks de OTP com HMAC cobrem os detalhes.

Passo a passo: o mesmo trabalho pelo painel

A equipe de suporte que precisa de um código de vez em quando pode dispensar a API:

1. Abra o OTP Gateway no painel e escolha Belarus.
2. Escolha o serviço; o preço dessa rota aparece antes de você confirmar.
3. Copie o número +375 e digite-o no app que você está testando.
4. Acompanhe o cartão do pedido. O código aparece ali assim que chegar.

Se nada chegar em 20 minutos, o pedido se encerra e o valor total é creditado de volta. Você só paga quando um código é entregue.

Solução de problemas: o código +375 não chegou

Causas habituais e o próximo passo para cada uma:

• O serviço recusou o número. Algumas plataformas rejeitam números virtuais. A regra de reembolso existe exatamente para esse caso; tente outra rota de serviço ou outro país, se o teste permitir.
• O número foi digitado na forma doméstica. Confira de novo se o seu formulário enviou +375 mais nove dígitos, sem o 80.
• A rota está ocupada. Deixe a janela seguir seu curso em vez de cancelar depois de um minuto e tente de novo mais tarde.
• O seu script está refazendo pedidos em loop apertado. Acrescente um back-off entre as tentativas; pedidos repetidos e rápidos para um mesmo serviço raramente ajudam e podem parecer abuso para a plataforma de destino.

Outros padrões de falha em pedidos +375 estão em como reduzir falhas na entrega de OTP.

Existe uma linha belarussa de longo prazo e como funciona a cobrança?

Não. A OTP Route não tem um número de longo prazo em autoatendimento para Belarus. Se a sua equipe precisa de um para um caso de operações ou de suporte, escreva para [email protected] e descreva-o; a possibilidade de oferecer algo depende das regras locais e nada é prometido. Os Números Virtuais Dedicados são um produto dos EUA e do Canadá, a partir de $1.95/month, com SMS de entrada, SMS de saída e chamadas pelo navegador.

Os pedidos de Belarus usam a mesma carteira pré-paga em USD que qualquer outra rota, sem cobrança mensal e sem nível para escolher. Recarregue com cartão ou com as stablecoins USDT/USDC; uma fatura em PDF de cada recarga chega à sua caixa de entrada. Os desenvolvedores podem pedir uma conta sandbox que devolve números e códigos simulados, que é a forma mais barata de comprovar uma integração antes dos pedidos reais. Use cada número apenas para o seu próprio produto ou para as suas próprias contas legítimas, siga os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica. Os valores atuais estão em preços.

Perguntas frequentes

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

Sim. Peça um número +375 para o seu serviço no OTP Gateway, envie-o no seu formulário de cadastro e leia o código no painel ou pela API.

Qual é o id de país de Belarus na API da OTP Route?

É by. Use-o em GET /api/v1/prices e no corpo de POST /api/v1/activations.

Devo armazenar números belarussos com o prefixo 80?

Não. Armazene-os em E.164 como +375 seguido de nove dígitos e remova o 80 doméstico; caso contrário, muitos serviços tratarão o número como inválido.

O que acontece com o meu dinheiro se o número +375 nunca receber um código?

Quando a janela de 20 minutos termina sem um SMS, ou você cancela, a cobrança total volta automaticamente para a sua carteira.

Em que idioma será o SMS de verificação?

Isso é decidido pelo serviço remetente. Para números belarussos, costuma ser russo ou inglês, conforme o idioma da conta ou do dispositivo.

Posso manter um número +375 para logins futuros?

Não em autoatendimento. Os Números Dedicados de longo prazo existem apenas para os EUA e o Canadá; para Belarus, você pode escrever para [email protected] e perguntar, sem nenhuma promessa de disponibilidade.

Existe uma forma de testar a integração sem gastar o saldo da carteira?

Sim. Uma conta de desenvolvimento pode ser mudada para sandbox mediante pedido, e ela devolve números e códigos simulados para testes de ponta a ponta.

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.