Testando e operando com códigos de verificação +376 em Andorra

Por que os números andorranos atrapalham os formulários de cadastro?

Andorra usa o código de país +376 e não tem prefixo de tronco, então não há zero inicial para remover. A maioria dos números de assinante tem apenas seis dígitos, muito menos que os números nacionais de nove dígitos usados na vizinha Espanha e na França. Esse comprimento é a primeira coisa que um engenheiro de QA deve testar: regexes escritas à mão e regras de validação antigas costumam exigir sete ou mais dígitos e rejeitam em silêncio um celular andorrano perfeitamente válido.

Uma regra prática de armazenamento:

• Salve o número em E.164 como +376 seguido dos seis dígitos, sem espaços nem pontuação.
• Formate apenas para exibição, na hora de renderizar, por exemplo em dois grupos de três.
• Mantenha a sua biblioteca de metadados telefônicos atualizada para que as regras de comprimento de AD correspondam à realidade.

Pedir um número +376 para testes é a forma mais rápida de provar que o seu formulário, a coluna do banco de dados e o caminho de envio de SMS aceitam um número tão curto de ponta a ponta.

Quais idiomas e padrões de clientes importam no principado?

O catalão é o idioma oficial, e o espanhol, o francês e o português são amplamente ouvidos em lojas e escritórios. Os grandes apps globais costumam enviar o texto de verificação no idioma da conta ou do aparelho do usuário, então um código pode chegar em inglês, espanhol, francês ou catalão, conforme o serviço. Se o seu próprio produto envia OTPs a usuários andorranos, confira se o modelo em catalão é renderizado corretamente e se os dígitos são fáceis de identificar.

As equipes trabalham com Andorra por alguns motivos recorrentes: negócios de varejo, turismo e temporada de esqui que cadastram visitantes e residentes, empresas registradas no principado que precisam de um caso de teste local e produtos transfronteiriços que atendem pessoas que moram de um lado dos Pirineus e trabalham do outro. Um bug comum é um seletor de países que esconde Andorra ou a mapeia silenciosamente para a Espanha ou a França; um número de verificação +376 real expõe isso rapidamente.

Quais serviços podem entregar um código em uma rota +376?

A rota de Andorra é um catálogo menor que o dos grandes mercados, com mais de 50 serviços na lista ao vivo. Entre as entradas populares no snapshot atual estão WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, TikTok, X (Twitter), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Viber, Netflix e Airbnb.

Como a disponibilidade muda ao longo do dia, trate isto como um retrato do momento e não como uma promessa. Confira o catálogo ao vivo antes de uma execução de testes e, se um serviço de que você precisa não estiver listado para ad, compare as rotas vizinhas na página de países ou leia a nossa nota sobre roteamento de OTP por país.

Como é a sequência de chamadas da API de OTP de Andorra?

Crie uma chave Bearer (prefixo or_live_) no console do desenvolvedor e trabalhe em https://otproute.com/api/v1. Uma execução típica é assim:

1. Chame GET /api/v1/prices?country=ad&service=telegram para confirmar que a rota está aberta e ver o preço atual.
2. Envie POST /api/v1/activations com {"service": "telegram", "country": "ad"} e guarde o id da ativação e o número que ele retorna.
3. Dispare o SMS de verificação a partir do app ou do fluxo que você está testando.
4. Espere o webhook activation.sms_received ou faça polling em GET /api/v1/activations/{id} em um intervalo moderado.
5. Se o teste for abandonado, chame POST /api/v1/activations/{id}/cancel para que os fundos voltem imediatamente.

Todo webhook traz um cabeçalho X-OTPRoute-Signature. Recalcule o HMAC-SHA256 do timestamp, um ponto e o corpo bruto com o segredo do seu endpoint, compare-o e rejeite timestamps antigos. As contas têm até 10 chaves, 5 endpoints de webhook e 300 requisições por minuto. A documentação da API cobre o resto desta API de verificação por SMS.

Um colega de operações pode fazer o mesmo sem código?

Sim. Qualquer pessoa da equipe pode usar o painel no lugar da API de OTP de Andorra:

1. Entre na conta e abra o OTP Gateway.
2. Escolha Andorra e o serviço de que precisa.
3. Confira o preço exibido e peça o número.
4. Cole o número +376 no serviço e solicite o código.
5. Mantenha a ativação aberta na tela; o código +376 é exibido no instante em que chegar.

Esse caminho serve à equipe de suporte que verifica uma conta empresarial ou a um gerente de produto que faz uma demonstração pontual de um cadastro localizado.

O que deve acontecer quando um código +376 não chega?

Cada ativação fica aberta por 20 minutos. Você só paga se o código chegar: se a janela se fechar sem SMS, ou se você cancelar, o valor total volta para a carteira automaticamente.

Quando nada aparece, deixe a janela correr em vez de pedir de novo na hora e confirme se o serviço aceita números virtuais, já que alguns os recusam. Depois tente mais tarde ou por outra rota de serviço. Evite refazer pedidos em um loop apertado a partir de um script; adicione um intervalo crescente (backoff) e um limite. O nosso guia sobre como reduzir falhas na entrega de OTP lista mais verificações.

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

Não existe número de longo prazo em autoatendimento para Andorra. Os Números Dedicados são vendidos na hora apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, por meio de números virtuais. Se a sua equipe precisa de uma linha +376 duradoura, escreva para [email protected] e pergunte; a disponibilidade depende das regras locais e não é assegurada.

A cobrança funciona com uma única carteira pré-paga em USD, sem mensalidade e sem plano a escolher. Recarregue por cartão ou com USDT/USDC, e cada recarga chega com uma fatura em PDF por e-mail; veja os preços. Para trabalhos de integração, uma conta de desenvolvimento pode ser mudada para sandbox sob solicitação, de modo que a lógica de roteamento de OTP seja testada com números e códigos simulados. Use rotas reais apenas 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.

Perguntas frequentes

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

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

Qual é o id de Andorra na API da OTP Route?

Use ad como valor de country nas requisições de preço e de ativação.

Quanto custa receber códigos OTP por SMS de Andorra?

Os preços começam em $0.20 por código e dependem do serviço. O valor exato é retornado por GET /api/v1/prices e mostrado no painel antes de você pedir.

Os números andorranos precisam de um zero inicial?

Não. Andorra não tem prefixo de tronco, então o número é simplesmente +376 seguido dos dígitos do assinante, geralmente seis.

Posso manter o mesmo número +376 para logins repetidos?

Não como produto em autoatendimento. Os números do OTP Gateway servem a um único código; para uma linha duradoura fora dos EUA e do Canadá, escreva para [email protected] e pergunte.

Nossos desenvolvedores podem prototipar a integração com Andorra sem tocar nos fundos da carteira?

Sim. Peça ao suporte que mude uma conta de desenvolvimento para sandbox, que retorna números e códigos simulados.

Sou cobrado se o Telegram nunca enviar o código?

Não. Se nenhum SMS chegar em 20 minutos, ou se você cancelar antes, o valor é reembolsado à sua carteira automaticamente.

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.