Testando a verificação por telefone húngara (+36): checklist, passos e correções

Checklist: a sua stack está pronta para uma execução da API OTP da Hungria?

Percorra esta lista uma vez por projeto, e não uma vez por teste:

1. Segurança da conta. Cadastre-se em /signup e ative o TOTP de dois fatores antes de gerar qualquer chave.
2. Chaves por ambiente. Crie chaves or_live_ no console do desenvolvedor, uma por pipeline ou máquina de desenvolvedor, para que uma chave vazada possa ser revogada sem parar todo mundo.
3. Ids na configuração, não no código. A Hungria é hu; leia os ids de serviço em GET /api/v1/services e mantenha o mapeamento em um arquivo de configuração.
4. Destino do webhook. Registre um endpoint HTTPS (até 5 por conta) e guarde o segredo no seu gerenciador de segredos.
5. Trava de orçamento. Faça a suíte chamar GET /api/v1/balance primeiro e encerrar de forma limpa quando faltarem fundos.
6. Parsing com noção de região. Garanta que o seu campo de telefone conheça a região HU, porque os húngaros raramente digitam o código do país em um formulário nacional.

A página da solução de testes de QA mostra como as equipes costumam organizar isso em um framework de testes.

Por que o tratamento de números +36 merece casos de teste próprios?

O código de país da Hungria é +36, e o prefixo de tronco nacional é 06. Um usuário húngaro costuma digitar um celular como 06 30 123 4567 ou 06 20 ..., em que 20, 30, 31, 50 e 70 são prefixos móveis comuns. O seu formulário deve convertê-lo em +3630... removendo o 06, nunca mantendo-o depois do código do país. Escreva casos explícitos para:

• 06 30 ... em um campo de formato nacional;
• +36 30 ... e 0036 30 ..., já que 00 é o prefixo de acesso internacional;
• espaços, barras e hifens, que aparecem em todas as combinações na entrada real.

O húngaro é o idioma oficial, e muitos serviços enviam o código em húngaro quando a localidade da conta está configurada para ele. As letras ő e ű não fazem parte do alfabeto GSM de 7 bits, então uma mensagem húngara que as contenha é codificada em UCS-2 e cada segmento comporta menos caracteres. Isso importa se o seu próprio produto envia códigos em húngaro, e é um bom motivo para ler o texto recebido nos logs de teste, e não apenas os dígitos extraídos. As palavras húngaras também são longas, então o QA de localização deve verificar se a etapa de telefone e as suas mensagens de erro ainda cabem em telas pequenas.

Quais rotas húngaras estão disponíveis para um número +36 para testes?

O roteamento OTP para hu abrange atualmente mais de 1.600 serviços. As rotas mais pedidas no panorama atual são WhatsApp, Viber, Facebook, Instagram, Google (Gmail & YouTube), Uber, Airbnb, eBay, Amazon, LinkedIn, Netflix e ChatGPT (OpenAI).

Essas rotas são um retrato do momento; o estoque se move ao longo do dia, e é por isso que a API devolve a disponibilidade a cada consulta de preço. Consulte GET /api/v1/prices?country=hu&service=<id> imediatamente antes de pedir, em vez de guardar uma resposta antiga em cache.

Passos: receber códigos SMS OTP da Hungria pela API

Com o checklist cumprido, um único teste pela API de verificação por SMS precisa de cinco chamadas no máximo, todas em https://otproute.com/api/v1:

1. GET /api/v1/prices?country=hu&service=uber para confirmar a rota e registrar o preço.
2. POST /api/v1/activations com {"service": "uber", "country": "hu"}. Guarde o id da ativação; ele é a chave de tudo o que vem depois.
3. Envie o número +36 retornado para a tela de verificação do seu app.
4. Receba o código. Um webhook entrega activation.sms_received; o polling usa GET /api/v1/activations/{id}. Escolha um por tarefa para que os dois caminhos não disputem entre si.
5. Em caso de falha no teste, use POST /api/v1/activations/{id}/cancel para liberar os fundos imediatamente.

Verifique todo webhook antes de confiar nele: separe X-OTPRoute-Signature em t e v1, calcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare em tempo constante e rejeite timestamps muito antigos. Trate activation.expired e activation.cancelled como estados terminais para que as novas tentativas parem. Há um exemplo prático no guia de integração da API OTP.

Passos para colegas que nunca tocam na API

A equipe de sucesso do cliente ou de marketing pode usar o painel. Abra o OTP Gateway, escolha Hungria e o serviço, confira o preço exibido, confirme e cole o número +36 no app. O código aparece no próprio pedido. Se nada chegar em 20 minutos, o pedido expira e a carteira é creditada integralmente, então uma tentativa fracassada não custa nada.

Solução de problemas de um número de verificação húngaro que permanece em silêncio

Percorra estes pontos antes de abrir um chamado:

• O número foi enviado em E.164? Um 06 perdido depois de +36 é a falha autoinfligida mais comum.
• O serviço aceita números virtuais? Alguns não aceitam. O reembolso automático cobre esse caso, e mudar para outra rota de serviço ou um país vizinho costuma ser o caminho mais rápido.
• Você esperou a janela terminar? Cancelar após uma espera curta pode descartar um código que estava a caminho. Deixe o pedido correr e tente de novo mais tarde.
• O script está martelando uma única rota? Espace as novas tentativas com um backoff. Pedidos instantâneos repetidos raramente ajudam e podem acionar as verificações de abuso da própria plataforma.

O artigo sobre como reduzir falhas na entrega de OTP vai além.

Linhas de longo prazo, carteira e uso responsável na Hungria

Não há número de longo prazo de autoatendimento para a Hungria. Se uma equipe de operações ou de suporte precisar de um, escreva para [email protected] com o caso de uso; a disponibilidade depende das regras locais e não pode ser prometida. Os Números Virtuais Dedicados de autoatendimento existem apenas para linhas dos EUA e do Canadá, a partir de $1.95/month.

A OTP Route cobra a partir de uma única carteira pré-paga em USD: sem mensalidade, sem plano, recargas por cartão ou USDT/USDC e uma fatura em PDF por e-mail a cada recarga. Um modo sandbox com números e códigos simulados pode ser ativado sob solicitação para testes de integração. Use os números somente para testar ou operar os seus próprios produtos e contas legítimas, respeite os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

Perguntas frequentes

A minha equipe de QA pode receber um código SMS húngaro sem um chip húngaro?

Sim. Peça um número +36 para o serviço relevante pelo OTP Gateway e colete o código no painel ou pela API.

Que id de país a API usa para a Hungria?

Use hu, por exemplo em POST /api/v1/activations com um corpo como {"service": "uber", "country": "hu"}.

Como converto um número escrito como 06 30 123 4567?

Remova o prefixo de tronco 06 e acrescente +36, obtendo +36301234567. Armazene essa forma E.164 e formate-a apenas para exibição.

Pago se uma rota húngara não entregar um código?

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

Por que a mensagem de um código húngaro às vezes parece diferente da de um em inglês?

Os textos em húngaro podem incluir ő ou ű, que levam a mensagem à codificação UCS-2. Os dígitos são os mesmos; mudam apenas o texto da mensagem e o seu tamanho.

Posso comprar um número húngaro para manter por meses?

Não como produto de autoatendimento. Os Números Dedicados existem só nos EUA e no Canadá; para a Hungria você pode escrever para [email protected] e perguntar, sem promessa de que seja possível.

Quantos serviços a OTP Route suporta para a Hungria?

Mais de 1.600 no momento da redação. Chame GET /api/v1/countries ou consulte o painel para ver a lista atual.

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.