Códigos de verificação +351 por programação para lançamentos em Portugal

Quais endpoints uma verificação +351 utiliza?

A URL base é https://otproute.com/api/v1, e toda requisição leva uma chave Bearer que começa com or_live_. O id do país Portugal é pt.

1. GET /api/v1/countries e GET /api/v1/services fornecem os ids; guarde-os em cache a cada execução de teste.
2. GET /api/v1/prices?country=pt&service=<id> retorna o preço atual e informa se a rota está aberta.
3. POST /api/v1/activations com {"service": "telegram", "country": "pt"} reserva o número e retorna um id de ativação.
4. GET /api/v1/activations/{id} informa o status e o código, se você preferir polling.
5. POST /api/v1/activations/{id}/cancel libera um número de que o seu teste não precisa mais.
6. GET /api/v1/balance permite que um pipeline pare cedo quando a carteira estiver com pouco saldo.

Os limites da conta são 10 chaves de API, 5 endpoints de webhook e 300 requisições por minuto. Os esquemas completos estão na referência da API.

Como os webhooks assinados entregam os códigos portugueses ao nosso serviço?

Cadastre um endpoint HTTPS no console do desenvolvedor e assine activation.sms_received, activation.expired e activation.cancelled. Cada POST inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Para verificá-lo, reconstrua a string <t>.<raw body>, calcule o HMAC-SHA256 com o segredo do endpoint e compare com v1 usando uma checagem em tempo constante. Recuse requisições cujo timestamp seja antigo demais, para que uma requisição capturada não possa ser reproduzida. Guarde o id da ativação de cada evento e ignore qualquer repetição, o que deixa o handler seguro quando as entregas são reenviadas. O padrão está explicado passo a passo em captura de OTP por webhook.

Quais serviços estão abertos nas rotas portuguesas?

Portugal mostra mais de 2.000 serviços no snapshot atual. Entre os mais usados estão WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord e Signal.

O conjunto muda ao longo do dia conforme as operadoras parceiras redistribuem a capacidade. Por isso, é o endpoint de preços, e não um arquivo de configuração estático, que deve decidir se um teste roda.

Por que as equipes de produto testam com números portugueses?

Portugal costuma aparecer cedo no plano de expansão pela Europa. Lisboa e Porto abrigam muitas equipes de produto e engenharia, e várias empresas usam Portugal como base europeia. Há também um motivo de localização: o português europeu (pt-PT) difere do português brasileiro em ortografia, vocabulário e formas de tratamento, então um fluxo traduzido para o Brasil pode soar estranho para quem está em Portugal. Executar uma verificação +351 real permite que os revisores vejam juntos o texto em pt-PT, o SMS que chega e as telas ao redor.

Pelo GDPR, manter os números de telefone dos funcionários fora de contas de teste e compartilhadas também é boa minimização de dados. Um número de uso único por checagem significa menos identificadores pessoais nos seus sistemas de QA. O guia de pipeline de CI mostra como incluir isso em todo build.

Como os números +351 são formatados e armazenados?

Portugal não tem prefixo de tronco: os números têm nove dígitos e são discados do mesmo jeito em casa e no formato internacional depois de +351. Os celulares começam com 9, enquanto os fixos geográficos começam com 2. Armazene em E.164, rejeite qualquer coisa que não tenha nove dígitos depois do código do país e remova os espaços que os usuários colocam ao digitar em grupos de três.

Os códigos recebidos costumam chegar em português ou inglês, conforme o remetente e o idioma configurado na conta. O seu extrator de código deve procurar os dígitos, e não uma frase fixa.

Um colega consegue fazer isso sem código, e e se nenhum SMS chegar?

No painel, abra o OTP Gateway, escolha Portugal e um serviço, confira o preço atual e faça o pedido. Cole o número no seu app e aguarde o código na página da ativação.

A janela dura 20 minutos, e você só paga se o código chegar; caso contrário, o valor integral volta para a carteira automaticamente. Quando um código não aparece:

• Deixe a janela terminar em vez de cancelar depois de alguns segundos.
• Confirme que o serviço aceita números virtuais nesse fluxo.
• Tente de novo mais tarde, ou teste a mesma tela com outra rota de serviço.
• Espere um pouco entre as tentativas em vez de refazer o pedido em um laço rápido.

Existe uma linha portuguesa dedicada, e como funciona a cobrança?

A OTP Route não vende números dedicados em autoatendimento em Portugal. Os Números Virtuais Dedicados existem apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês; para uma linha +351 de longo prazo, escreva para [email protected], ciente de que a disponibilidade depende das regras locais e não é garantida. Veja como números temporários e dedicados se diferenciam.

O pagamento é conforme o uso, a partir de uma carteira pré-paga em USD, sem mensalidades nem planos, com recarga por cartão ou com USDT/USDC, e cada recarga vem com uma fatura em PDF. As contas de desenvolvimento podem ser migradas para o sandbox sob solicitação, para testar com números e códigos simulados. Siga os termos de cada serviço; a Política de Uso Aceitável da OTP Route se aplica.

Perguntas frequentes

Qual é o id do país Portugal na API da OTP Route?

É pt, usado tanto na consulta de preços quanto no corpo da requisição de ativação.

Os números de telefone portugueses usam prefixo de tronco, como um 0 inicial?

Não. Os números portugueses têm nove dígitos e nenhum prefixo de tronco, então o formato E.164 é +351 seguido desses nove dígitos.

Posso testar um fluxo de onboarding pt-PT sem um chip SIM português?

Sim. Um número +351 para testes do OTP Gateway recebe o código, que você lê no painel ou pela API.

Quanto custa um número de verificação de Portugal?

A partir de $0.20 por código; o preço exato depende do serviço e é exibido antes de você pedir.

Vou pagar por uma ativação +351 que não recebe nada?

Não. As ativações expiradas ou canceladas são reembolsadas integralmente na sua carteira.

Posso alugar um número português para logins recorrentes?

Não em autoatendimento. As linhas de longo prazo são um produto dos EUA e do Canadá; escreva para o suporte se precisar de uma linha +351.

Devo usar polling ou webhooks para os códigos portugueses?

Os webhooks escalam melhor para jobs em paralelo, enquanto o polling em GET /api/v1/activations/{id} serve para runners que não podem receber tráfego de entrada.

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.