Números de verificação do Reino Unido: checklist de testes OTP com +44

Checklist: a sua stack está pronta para códigos de verificação +44?

Percorra esta lista antes de um release candidate chegar à etapa do Reino Unido no seu plano de testes:

• [ ] Uma chave do console do desenvolvedor (prefixo or_live_) com escopo restrito ao job que vai usá-la.
• [ ] O id de país do Reino Unido, gb, ligado às suas fixtures, mais o id do serviço obtido em GET /api/v1/services.
• [ ] Uma decisão sobre a entrega: um webhook assinado para suítes em paralelo ou polling para um script rápido.
• [ ] Um parsing de números de telefone que trate o zero inicial britânico (mais detalhes abaixo).
• [ ] Saldo suficiente, confirmado com GET /api/v1/balance, ou uma conta sandbox para ensaios.
• [ ] Uma nota no runbook de que um número atende exatamente um código.

Equipes que ligam isso a pipelines vão achar útil o artigo testes de SMS OTP em pipelines de CI.

Como funciona o fluxo da API OTP do Reino Unido para o id de país gb?

A sequência reproduz o que um testador humano faz à mão, só que mais rápida e com registro:

1. Consulte o preço do par com GET /api/v1/prices?country=gb&service=<id>; a resposta reflete a disponibilidade ao vivo.
2. Reserve um número com POST /api/v1/activations e {"service": "<id>", "country": "gb"}.
3. Coloque o número +44 na tela de cadastro, login ou recuperação e solicite o SMS.
4. Receba o código pelo evento activation.sms_received ou lendo GET /api/v1/activations/{id}.
5. Aborte de forma limpa com POST /api/v1/activations/{id}/cancel quando um teste for ignorado.

Um handler de webhook deve tratar toda requisição como não confiável até que o cabeçalho X-OTPRoute-Signature seja validado: o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint deve ser igual a v1, e o timestamp deve ser recente. Persista os resultados com o id da ativação como chave, para que entregas duplicadas sejam inofensivas. Os limites são generosos para a maioria das suítes: 300 requisições por minuto, até 10 chaves e 5 endpoints de webhook por conta. A referência completa está na documentação para desenvolvedores.

Quais serviços e apps do Reino Unido estão na rota?

O Reino Unido é uma das rotas mais amplas, com mais de 4.000 serviços disponíveis. Entre as opções populares estão WhatsApp, Google (Gmail & YouTube), Amazon, Uber, Netflix, eBay, Airbnb, LinkedIn, Microsoft & Outlook, Instagram, Snapchat, X (Twitter), Discord e ChatGPT (OpenAI).

As rotas mudam de hora em hora, então deixe o endpoint de preços ou o painel dizer o que pode ser pedido agora, em vez de supor que o resultado de ontem continua valendo.

O zero inicial: como armazenar celulares do Reino Unido em E.164

O Reino Unido usa o prefixo de tronco 0. As pessoas escrevem o celular como 07xxx xxxxxx, onze dígitos, mas internacionalmente o 0 desaparece e o número vira +447xxxxxxxxx. O bug mais comum nos campos de telefone britânicos é manter os dois, o que produz uma string inválida +4407… que nenhum gateway de SMS vai entregar.

Verificações que valem a pena incluir na sua suíte de testes:

• A entrada 07… é normalizada para +447… antes de ser salva.
• A entrada já no formato +44 7… passa sem alteração.
• Os espaços do agrupamento familiar 07xxx xxxxxx são removidos.
• A formatação de exibição é aplicada só na saída e nunca é armazenada.

As mensagens de verificação para usuários britânicos chegam em inglês. O galês também é um idioma oficial no País de Gales, então serviços voltados ao público com interface bilíngue podem querer checar se os modelos e as telas se comportam bem nos dois idiomas.

Por que equipes de QA e de growth testam com números britânicos

Para muitas empresas, o Reino Unido é o mercado de origem ou o primeiro fora dele. Os produtos financeiros, em particular, tendem a colocar a verificação por telefone no centro do onboarding e das verificações adicionais, então um fluxo +44 quebrado aparece rápido nas filas de suporte.

Motivos comuns para pedir um número +44 para testes:

• Um lançamento no Reino Unido, em que a build en-GB precisa de uma rodada própria para ortografia, formatos de data e o seletor de país.
• Testes de regressão de login e recuperação de conta após uma mudança nas configurações do seu provedor de SMS.
• Recriar o cadastro fracassado de um cliente britânico para ver onde o código se perdeu.

A página de onboarding em fintech descreve como as equipes estruturam essas verificações.

Como investigar um código +44 que não chegou

Quando o código não chega, resista ao impulso de pedir de novo imediatamente. Em vez disso:

1. Deixe a janela de 20 minutos terminar; alguns serviços seguram as mensagens por um tempo.
2. Leia o status da ativação. Se terminar como expirada, nada chegou e o valor integral já voltou para a carteira.
3. Lembre-se de que alguns serviços recusam números virtuais. Esse resultado é exatamente o que a regra de reembolso cobre.
4. Tente de novo após uma pausa, ou com outra rota para o mesmo serviço, em vez de fazer pedidos em loop.
5. Confirme se o seu app chegou a pedir o SMS e se o pedido foi para o número +44 que você reservou, e não para uma fixture antiga.

Caminho pelo painel, cobrança e linhas britânicas de longo prazo

Quem não é desenvolvedor pode fazer tudo isso sem código: abra o painel, escolha Reino Unido e o serviço, confirme o preço exibido, copie o número para o app e aguarde o código na mesma página.

Não existe número britânico de longo prazo em autoatendimento. Os Números Dedicados são um produto dos EUA e do Canadá, a partir de $1.95/mês; para uma linha britânica persistente, escreva para [email protected], e a equipe explicará o que as regras locais permitem, sem prometer. Tudo funciona com uma carteira pré-paga em USD, sem mensalidade, recarregada por cartão ou USDT/USDC, com faturas em PDF por e-mail. Os detalhes estão na página de preços.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app no Reino Unido sem um chip britânico?

Sim. Peça um número +44 no OTP Gateway, digite-o na sua tela de cadastro e leia o código no painel, em um webhook ou no endpoint da ativação.

O id de país do Reino Unido na API é `uk` ou `gb`?

É gb, seguindo o código de país ISO.

Como converto um número britânico que começa com 07?

Remova o 0 inicial e acrescente o prefixo +44; assim, 07… vira +447….

Pago por uma ativação do Reino Unido que expira?

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

A OTP Route pode me dar um número britânico que eu mantenha por meses?

Não como produto de autoatendimento. Os Números Dedicados de longo prazo são vendidos apenas para os EUA e o Canadá; você pode escrever ao suporte para perguntar sobre o Reino Unido, sem garantia de que seja possível.

Posso experimentar a integração com o Reino Unido primeiro em um sandbox?

Sim. Uma conta de desenvolvimento pode ser mudada para sandbox mediante pedido, retornando números e códigos simulados para você testar sem gastar saldo da carteira.

Quais regras de uso valem para os números de verificação do Reino Unido?

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 os seus próprios produtos, testes e contas empresariais 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.