Como receber códigos de verificação alemães +49 para testes e operações

Por que equipes de produto testam com números alemães?

A Alemanha é a maior economia da União Europeia e costuma ser a primeira parada quando uma empresa se expande para a região DACH, de língua alemã. Isso faz dela um mercado em que uma etapa de cadastro quebrada sai caro: os usuários percebem, e os chamados de suporte chegam em alemão.

Motivos típicos pelos quais vemos equipes recorrerem a um número de verificação da Alemanha:

• QA de lançamento. Antes de ativar uma loja ou uma página de app para a Alemanha, alguém precisa percorrer o cadastro com um número +49 real e confirmar que o código é aceito.
• Verificações de localização. Muitos serviços enviam modelos de SMS em alemão para números alemães. Se o seu app lê o código automaticamente, teste se o parser lida com o texto em alemão e não espera uma frase em inglês antes dos dígitos.
• Operações regionais. Agências e equipes de operações que gerenciam perfis comerciais de clientes alemães precisam concluir verificações sem desviar códigos para o telefone pessoal de um funcionário.
• Expectativas de privacidade. Os usuários alemães costumam ser cuidadosos com dados pessoais, e equipes que testam fluxos com telefones descartáveis da equipe acabam com registros bagunçados. Uma rota de teste separada mantém os números pessoais fora disso.

Como armazenar e normalizar um número +49?

Os números alemães enganam o código de validação mais do que a maioria. Algumas regras práticas:

1. Remova o prefixo de tronco. Dentro da Alemanha, os celulares são escritos com um 0 inicial, por exemplo 0151 2345 6789. Em E.164 esse 0 desaparece: +4915123456789.
2. Trate a notação híbrida. As pessoas costumam escrever +49 (0)151 .... O seu normalizador deve descartar o zero entre parênteses em vez de mantê-lo, ou você acabará com uma string inválida +490151....
3. Aceite 0049. O prefixo internacional 00 ainda é comum em formulários e planilhas; converta-o para +49.
4. Não presuma um comprimento fixo. A numeração alemã não é uniforme, e celulares e linhas fixas variam na quantidade de dígitos. Valide o código do país e uma faixa razoável em vez de um comprimento exato.

Armazene a forma E.164 como string e só adicione espaços na exibição. Os números que a OTP Route devolve já estão no formato internacional, então podem ir direto para uma fixture de teste.

Quais serviços uma rota alemã consegue verificar?

A rota alemã do OTP Gateway cobre atualmente mais de 2,500 serviços. Entre os populares no retrato atual estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal e eBay.

O estoque muda ao longo do dia, então trate qualquer lista como ponto de partida. GET /api/v1/services e GET /api/v1/countries retornam o que pode ser pedido agora, e o painel mostra o mesmo quadro antes de você gastar qualquer valor.

Como funciona o fluxo da API OTP da Alemanha?

O fluxo da API OTP da Alemanha são as mesmas cinco chamadas que você usaria em qualquer lugar, com de como id do país.

Crie uma chave Bearer no console do desenvolvedor (as chaves começam com or_live_; você pode ter até 10 por conta). Chame GET /api/v1/prices?country=de&service=whatsapp para ler o preço atual dessa combinação. Quando o preço servir, envie POST /api/v1/activations com um corpo JSON como {"service": "whatsapp", "country": "de"}. A resposta traz o id da ativação e o número +49 a digitar no app em teste.

Daí em diante, escolha como coletar o código. Um endpoint de webhook recebe activation.sms_received com a mensagem; confira o cabeçalho X-OTPRoute-Signature (um HMAC-SHA256 do timestamp mais o corpo bruto, com o segredo do seu endpoint como chave) e rejeite timestamps antigos. Se preferir não expor um endpoint, faça polling em GET /api/v1/activations/{id} em intervalos moderados; o limite da conta é de 300 requisições por minuto, compartilhadas entre as chaves. Se o teste for abortado, POST /api/v1/activations/{id}/cancel libera o número. Os payloads completos estão na documentação da API.

Quem não programa pode usar o painel?

Sim. Equipes de operações e testadores manuais podem fazer tudo sem tocar na API de verificação por SMS:

1. Crie uma conta com o seu e-mail e o código de 6 dígitos que enviamos, ou com o login do Google.
2. Adicione saldo à carteira.
3. Escolha Alemanha e depois o serviço que você precisa verificar.
4. Confira o preço exibido, confirme e copie o número +49 para o formulário de cadastro.
5. Acompanhe a ativação; o código aparece no painel assim que chegar.

É um jeito rápido de obter um número +49 para testes de um único fluxo antes que alguém escreva a automação.

O que acontece quando nenhum código chega ao número alemão?

Cada ativação fica aberta por 20 minutos. Se nenhum SMS chegar nesse tempo, ou se você cancelar, o valor integral volta automaticamente para a sua carteira. Você paga apenas pelos códigos entregues.

Quando um código demora ou não aparece:

• Deixe a janela correr antes de desistir; alguns remetentes colocam mensagens em fila.
• Confirme que o serviço aceita números virtuais. Algumas plataformas os recusam, e é exatamente esse o caso que o reembolso cobre.
• Tente de novo mais tarde, ou use outra rota para o mesmo serviço, em vez de refazer o pedido em um loop apertado. Repetições rápidas tendem a piorar as coisas, não a melhorá-las.
• Registre o id da ativação junto com a execução do teste para que as falhas possam ser rastreadas.

A nossa nota sobre roteamento de OTP por país mostra como escolher uma rota de contingência com bom senso.

Existe uma linha alemã de longo prazo?

Não como produto de autoatendimento. Os Dedicated Virtual Numbers, nossas linhas de longo prazo a partir de $1.95/month, são oferecidos apenas nos Estados Unidos e no Canadá, onde podem ser comprados na hora pelo painel. A Alemanha não tem hoje um equivalente em autoatendimento.

Se a sua equipe precisa de um número alemão persistente, por exemplo uma conta de staging que precisa entrar de novo no próximo trimestre, escreva para [email protected] e descreva o caso de uso. A disponibilidade depende das regras locais e não é prometida. Para códigos pontuais, o OTP Gateway é a ferramenta certa.

Como é feita a cobrança das ativações alemãs?

A OTP Route funciona com uma única carteira pré-paga em USD. Não há mensalidade nem plano a escolher; você recarrega por cartão ou com stablecoins USDT/USDC e gasta conforme os códigos chegam. Cada recarga gera uma fatura em PDF enviada por e-mail, o que agrada ao financeiro quando o gasto com testes é dividido entre projetos.

Para o trabalho de integração, uma conta de desenvolvimento pode ser colocada em sandbox mediante pedido. O sandbox devolve números e códigos simulados, para que você teste o seu handler de webhook e a lógica de roteamento de OTP de ponta a ponta sem usar o saldo da carteira.

Perguntas frequentes

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

Sim. Peça um número +49 no OTP Gateway, informe-o no seu app e leia o código no painel, pela API ou pelo webhook.

Que id de país devo enviar para a Alemanha?

Use de no campo country de POST /api/v1/activations e na consulta de preços.

Como recebo códigos SMS OTP da Alemanha automaticamente?

Registre um endpoint de webhook e trate o evento activation.sms_received depois de verificar a assinatura, ou faça polling da ativação pelo id se preferir não manter um endpoint.

Serei cobrado se o WhatsApp ou outro serviço nunca enviar o código?

Não. Se nada chegar em 20 minutos, ou se você cancelar antes, o valor integral volta para a sua carteira.

Os códigos enviados a números alemães chegam em alemão?

Muitas vezes sim, porque vários serviços localizam o SMS pelo país do número, embora alguns enviem em inglês. Construa a extração do código em torno dos dígitos, não das palavras ao redor.

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

Não há número de longo prazo em autoatendimento na Alemanha; essas linhas existem apenas para os EUA e o Canadá. Você pode escrever para [email protected] para perguntar sobre uma necessidade específica.

Há regras sobre como uso os números alemães?

Sim. Siga os termos de cada serviço e a Política de Uso Aceitável da OTP Route, e use os números apenas para testes ou para operar as suas próprias contas e produtos legítimos.

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.