Como receber um código SMS do Battle.net em um número de teste, passo a passo

A situação: um estúdio ou time de eSports precisa de um número do Battle.net que controle

Imagine um líder de QA em uma empresa que cria ferramentas complementares, overlays ou software de torneios em torno de jogos da Blizzard. A equipe mantém contas oficiais da empresa para testes e transmissões, e ninguém quer o celular pessoal de um engenheiro vinculado a elas. Outro caso comum é uma organização de eSports cuja equipe de operações administra contas compartilhadas do time e precisa que a verificação chegue a um lugar que todos possam ver.

O Battle.net usa um número de telefone para várias coisas: confirmar a pessoa por trás de uma conta, enviar códigos quando dados sensíveis mudam, apoiar a recuperação da conta e funcionar como camada de segurança ao lado do app Blizzard Authenticator. Alguns títulos da Blizzard também já pediram um número de telefone na conta antes de jogar. A verificação por SMS do Battle.net para testes, portanto, toca fluxos que a sua equipe pode precisar reproduzir mais de uma vez.

Checklist antes de pedir um número virtual para o Battle.net

• Escolha o produto certo. Verificações pontuais combinam com o OTP Gateway. Uma conta que manterá o telefone associado e precisará passar por futuros pedidos de segurança pertence a um Número Dedicado (veja abaixo).
• Combine o país. O país de uma conta do Battle.net é escolhido na criação e em geral não pode ser trocado depois pelo usuário, então peça o número do mesmo mercado da conta.
• Prepare as credenciais. Uma chave Bearer do console de desenvolvedor (prefixo or_live_) e, idealmente, um endpoint de webhook com o seu segredo.
• Abasteça a carteira. Cartão ou USDT/USDC na carteira pré-paga em USD; não há plano mensal.
• Ensaie no sandbox. O suporte pode colocar uma conta de desenvolvimento em sandbox para que a integração receba números e códigos simulados sem gastar saldo.

A página de testes de QA descreve como as equipes organizam esse tipo de dado de teste reutilizável.

Quais países podem receber um OTP do Battle.net?

A rota battle_net abrange atualmente 197 países. Entre eles estão Estados Unidos, Canadá, Reino Unido, Alemanha, França, Espanha, Polônia, Suécia, Coreia do Sul, Taiwan, Japão, Singapura, Filipinas, Austrália, Brasil, México, Turquia e África do Sul. A Blizzard atende os jogadores por hubs regionais de jogos, então o país que você escolher deve refletir a região e a loja de que trata o seu caso de teste, e não a rota que por acaso for mais barata. A disponibilidade em tempo real por país vem de GET /api/v1/prices.

Como funciona o fluxo da API de código de verificação do Battle.net?

URL base https://otproute.com/api/v1, autenticação Bearer, 300 requisições por minuto.

1. Confirme preço e disponibilidade: GET /api/v1/prices?country=<id>&service=battle_net, usando o id do país de GET /api/v1/countries.
2. Crie a ativação com POST /api/v1/activations e um corpo como {"service": "battle_net", "country": "us"}.
3. Digite o número retornado no Battle.net e solicite o código.
4. Trate activation.sms_received no seu webhook. Verifique o X-OTPRoute-Signature calculando o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, e recuse timestamps antigos.
5. Torne o handler idempotente: use o id da ativação como chave do processamento para que uma entrega reenviada não envie o mesmo código duas vezes.
6. Sem endpoint público? Consulte GET /api/v1/activations/{id} e trate um evento activation.expired ou activation.cancelled como o fim daquela execução de teste.

O guia de captura por webhook cobre filas e novas tentativas em detalhe.

O que quem não programa faz no painel?

Abra o OTP Gateway, escolha o Battle.net e o país da conta, confira o preço exibido e confirme. Digite o número no campo de telefone do Battle.net, solicite o SMS e mantenha aberta a página da ativação; o código aparece ali quando for entregue. Valem a mesma janela de 20 minutos e o mesmo reembolso automático.

Por que um código do Battle.net pode não chegar?

A Blizzard pode recusar números virtuais ou do tipo pré-pago em alguns recursos de segurança, e essa política pode mudar sem aviso. Se o código nunca vier, o valor integral volta para a sua carteira quando a janela termina ou você cancela. Então:

• deixe a janela inteira correr, já que o tempo de entrega depende do serviço e da rota;
• tente de novo mais tarde, ou com outro país que ainda corresponda à conta;
• evite ciclos rápidos de cancelar e pedir de novo, que desperdiçam o seu limite de requisições;
• se o número for rejeitado de vez, trate isso como uma resposta de política, e não como algo a contornar.

O checklist de falhas de entrega lista mais sinais para registrar.

Quando um Número Dedicado é o melhor número de telefone para o Battle.net?

Um número de um só código desaparece depois da janela, então é uma escolha ruim para qualquer conta que precisará receber um código de segurança de novo. Para uma conta corporativa de longa duração, um Número Dedicado nos Estados Unidos ou no Canadá, a partir de $1.95/mês, mantém a mesma linha enquanto renova pela carteira e encaminha os SMS recebidos para o painel e para o seu webhook como number.sms_received.

Seja qual for a escolha, siga os termos da Blizzard: uma conta por pessoa real ou empresa, sem contas extras e sem tentativas de contornar uma suspensão. A OTP Route existe para testar e operar os seus próprios produtos e contas legítimos, e a sua Política de Uso Aceitável se aplica. Battle.net é marca registrada de seu titular, e a OTP Route não tem afiliação com ele.

Perguntas frequentes

Posso receber um OTP do Battle.net sem usar o meu telefone pessoal?

Sim. Peça um número do OTP Gateway para battle_net, digite-o no Battle.net e leia o código no painel ou por webhook. Custa a partir de $0.20 por código, cobrado apenas na entrega.

O Battle.net aceita qualquer número virtual?

Não. A Blizzard pode recusar números virtuais ou pré-pagos em alguns recursos, e é por isso que as ativações não entregues são reembolsadas automaticamente.

Qual país devo escolher para uma conta de teste do Battle.net?

Use o mesmo país da conta. O país de uma conta do Battle.net é definido na criação, então um número incompatível pode gerar resultados confusos.

Qual é o id do serviço do Battle.net na API?

O id do serviço é battle_net. Combine-o com um id de país em POST /api/v1/activations.

O que impede um handler de webhook do Battle.net de agir duas vezes sobre o mesmo código?

Guarde o id da ativação quando tratar activation.sms_received pela primeira vez e ignore qualquer entrega posterior com o mesmo id, depois de verificar a assinatura.

Uma conta corporativa que precisa de códigos mais tarde deve usar uma ativação temporária?

Não. Para pedidos de segurança repetidos, um Número Dedicado dos EUA ou do Canadá, a partir de $1.95/mês, mantém a mesma linha enquanto renova.

Quantos países a rota do Battle.net cobre?

197 países no último levantamento. A disponibilidade muda ao longo do dia, então leia os preços atuais pela API antes de fazer o pedido.

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.