Códigos de verificação da Polônia (+48): checklist, passos da API e soluções

Pré-voo: o que preciso antes de testar cadastros poloneses?

Percorra esta lista uma vez e o primeiro pedido polonês tende a transcorrer sem sustos:

1. Credenciais. Gere uma chave Bearer no console do desenvolvedor (ela começa com or_live_). Chaves separadas para staging, CI e produção tornam a rotação indolor.
2. Identificadores. A Polônia é pl. Busque os ids dos serviços em GET /api/v1/services em vez de fixar nomes de exibição no código.
3. Fundos. Recarregue a carteira; cada preço é visível antes do pedido.
4. Destino da entrega. Registre um webhook HTTPS e mantenha o segredo fora do controle de versão. O polling também funciona se o tráfego de entrada estiver bloqueado.
5. Orçamento de requisições. A API permite 300 requisições por minuto por conta, então regule as suítes paralelas de acordo.
6. Escopo. Verifique apenas contas que pertençam ao seu próprio produto, à sua empresa ou ao seu cliente, e siga os termos de cada serviço junto com a nossa Política de Uso Aceitável.

Para pipelines em especial, veja testes de SMS OTP em pipelines de CI.

Quais serviços enviam códigos para números +48 atualmente?

Para o roteamento de OTP, a Polônia é uma das entradas mais amplas do catálogo, com mais de 2.300 serviços. O retrato atual dos mais populares inclui Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber e Netflix.

Trate essa lista como ponto de partida, não como promessa. A disponibilidade de qualquer rota muda ao longo do dia, então consulte o endpoint de preços para o par específico antes de cada pedido.

Quais são os passos exatos da API de OTP da Polônia?

Usando a API de verificação por SMS em https://otproute.com/api/v1, um teste automatizado faz o seguinte:

1. GET /api/v1/prices?country=pl&service=<id> confirma um preço atual desse serviço na Polônia.
2. POST /api/v1/activations com {"service": "<id>", "country": "pl"} devolve o número +48 e um id de ativação.
3. Seu teste digita o número no formulário de cadastro e solicita o SMS.
4. O handler recebe activation.sms_received; se vir activation.expired ou activation.cancelled, marca a execução como não entregue.
5. Sem webhook, leia GET /api/v1/activations/{id} a cada poucos segundos até o código aparecer ou a janela terminar.
6. Chame POST /api/v1/activations/{id}/cancel quando um teste for desmontado antes.

Valide o cabeçalho X-OTPRoute-Signature antes de confiar em qualquer payload: ele contém t=<unix>,v1=<hex>, em que v1 é o HMAC-SHA256 de <t>.<raw body> assinado com o segredo do endpoint. Rejeite tudo que tiver um timestamp antigo e torne o handler idempotente pelo id da ativação. O guia de segurança de webhooks mostra a verificação em detalhe.

A equipe de operações pode pedir um número polonês sem a API?

Pode. No painel da OTP Route, abra o OTP Gateway, escolha Polônia, procure o serviço e confirme o preço exibido. Depois do pedido, copie o número de verificação da Polônia para a tela de verificação do app e acompanhe o cartão da ativação; o texto do SMS aparece ali assim que for recebido. Não é preciso instalar nada, e a mesma carteira financia tanto o navegador quanto a API.

O que torna diferentes os números e as mensagens poloneses?

A Polônia usa um plano de numeração fechado e sem prefixo de tronco: todo número, móvel ou fixo, tem nove dígitos depois do +48. Isso torna a validação agradavelmente rígida. Rejeite entradas que não se reduzam a nove dígitos nacionais, remova espaços e traços que os usuários acrescentam em grupos de três e guarde +48 mais os nove dígitos como uma única string E.164. Um zero inicial perdido é um erro de digitação, não um prefixo a preservar.

As mensagens de verificação costumam chegar em polonês quando o idioma da conta é o polonês. Caracteres como ą, ę, ł e ż ficam fora do alfabeto GSM de 7 bits, então, se você envia os seus próprios textos de OTP em polonês, espere segmentos mais curtos e teste o modelo como ele realmente é exibido em um aparelho. Ao interpretar os códigos recebidos, baseie-se nos dígitos e ignore as palavras ao redor.

Motivos comuns para testar aqui: um produto que entra no mercado polonês, QA de localização para fluxos em polonês, equipes regionais que cuidam de contas empresariais na Europa Central e apps cujos clientes incluem falantes de polonês que vivem em outros países da UE.

Solução de problemas: por que o código +48 não chegou?

• A janela ainda está aberta. Dê a ela os 20 minutos completos antes de concluir qualquer coisa; você só é cobrado se um código chegar.
• O serviço pode rejeitar números virtuais. Algumas plataformas o fazem e, quando isso acontece, o reembolso automático devolve o valor integral à carteira.
• A rota está ocupada. Tente de novo mais tarde, ou teste outra rota de serviço.
• O teste está em loop. Pedir de novo a cada poucos segundos consome o seu orçamento de requisições; adicione um backoff.

Mais padrões estão reunidos em como reduzir falhas na entrega de OTP.

A Polônia tem números dedicados e como funcionam os pagamentos?

Não como produto em autoatendimento. Os Dedicated Virtual Numbers, a partir de $1.95/month, são oferecidos apenas nos Estados Unidos e no Canadá. Para uma linha polonesa de longo prazo, escreva para [email protected] para perguntar; as regras locais decidem se isso é possível, então não há promessa de uma.

Os pagamentos vão para uma única carteira pré-paga em USD: sem plano, sem mensalidade, recargas por cartão ou USDT/USDC e uma fatura em PDF enviada por e-mail a cada recarga. Os desenvolvedores podem pedir o modo sandbox em uma conta de desenvolvimento para receber números e códigos simulados enquanto constroem a integração. Veja os preços para as tarifas atuais.

Perguntas frequentes

Como posso testar um fluxo de cadastro polonês se ninguém da equipe tem um chip +48?

Peça um número +48 para testes no OTP Gateway e use-o no fluxo. O código aparece no painel e pode ser enviado ao seu webhook.

Qual é o id da Polônia nas chamadas da API da OTP Route?

É pl, usado tanto em POST /api/v1/activations quanto na consulta de preços.

Quantos dígitos tem um número de telefone polonês?

Nove dígitos nacionais depois de +48, sem zero de tronco. Esse comprimento fixo deixa a validação no servidor simples.

Quanto custa receber um OTP por SMS da Polônia?

Os preços começam a partir de $0.20 por código e variam conforme o serviço. O painel e o endpoint de preços mostram o valor exato antes do pedido.

Perco dinheiro se uma ativação polonesa expirar vazia?

Não. Uma ativação que termina sem código, ou que você cancela, é reembolsada integralmente à carteira.

Posso simular o fluxo inteiro da Polônia antes de entrar em produção?

Pode. Peça o modo sandbox em uma conta de desenvolvimento para obter números e códigos simulados sem gastar saldo da carteira.

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.