Capturando códigos de verificação por SMS panamenhos em código, passo a passo

Quais endpoints chamo para obter um código +507?

Tudo fica em https://otproute.com/api/v1 e se autentica com uma chave Bearer que começa com or_live_. O id do país do Panamá é pa. Uma execução típica para um caso de teste é assim:

1. GET /api/v1/prices?country=pa&service=whatsapp devolve a tarifa atual desse par, para que o seu runner possa parar se ela passar de um orçamento que você definiu.
2. POST /api/v1/activations com {"service": "whatsapp", "country": "pa"} reserva um número e devolve um id de ativação.
3. Seu teste digita o número na tela de cadastro e dispara o SMS.
4. O código chega a você por um evento de webhook ou por GET /api/v1/activations/{id}.
5. POST /api/v1/activations/{id}/cancel encerra uma execução mais cedo e a reembolsa.

Use GET /api/v1/balance antes de uma suíte grande, para que uma carteira zerada não apareça como uma onda de falsas falhas. A visão geral para desenvolvedores e a referência completa da API listam os detalhes de requisição e resposta.

Devo confiar em webhooks ou em polling nas rotas do Panamá?

Os webhooks são a escolha mais limpa para uma integração com a API de OTP do Panamá. Registre um endpoint (até 5 por conta) e assine activation.sms_received, activation.expired e activation.cancelled. Cada requisição traz X-OTPRoute-Signature: t=<unix>,v1=<hex>; reconstrua o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, compare em tempo constante e descarte tudo que tiver um timestamp antigo. Baseie o handler no id da ativação para que um reenvio nunca processe o mesmo código duas vezes.

O polling serve para scripts curtos ou redes que não aceitam chamadas de entrada. Espace as requisições; o limite da conta é de 300 requisições por minuto, compartilhado entre até 10 chaves, e um loop frenético sobre uma única ativação desperdiça esse orçamento. Mais padrões estão no nosso artigo sobre captura de OTP por webhook.

O que o meu código precisa saber sobre os números de telefone panamenhos?

O Panamá não tem prefixo de tronco, então os dígitos nacionais vêm depois de +507 sem alteração. Os celulares têm oito dígitos e começam com 6, enquanto os fixos têm sete dígitos, o que importa se o seu validador impõe um único comprimento para o país inteiro.

• Persista os números em E.164, por exemplo +5076 seguido de mais sete dígitos para um celular.
• Aceite um hífen depois do quarto dígito na entrada, já que é um modo local comum de escrever celulares, e remova-o antes de salvar.
• Rejeite uma entrada de sete dígitos em fluxos só de SMS, porque quase certamente é um telefone fixo, que não pode receber o código.

O espanhol é o idioma oficial, então os textos de verificação costumam chegar em espanhol quando o app localiza por região ou pelo idioma da conta. Confira se o seu próprio modelo de mensagem, a contagem de caracteres e qualquer regex de extração de código lidam bem com caracteres acentuados.

Por que as equipes testam ou operam no Panamá, afinal?

O canal, o comércio marítimo e de logística e um grande setor de serviços internacionais fazem do Panamá uma base comum para sedes regionais que cobrem a América Central e o Caribe. Equipes de produto que lançam um app em espanhol na região costumam começar o QA de localização aqui, e equipes de operações baseadas em outros lugares ainda precisam provar que clientes com números +507 conseguem concluir o onboarding.

Um número de verificação do Panamá do OTP Gateway permite fazer isso de qualquer escritório. Quando um teste não precisa especificamente do Panamá, rotas vizinhas como Costa Rica ou Colômbia podem servir de comparação útil para o comportamento do roteamento por país.

Quais serviços podem receber códigos na rota do Panamá?

O retrato de hoje lista WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Uber, eBay, Airbnb e Netflix. No total, a rota tem atualmente mais de 1.000 serviços. O estoque muda ao longo do dia, então leia sempre GET /api/v1/services ou o painel em vez de fixar uma lista no código.

Quem não é desenvolvedor tem a mesma cobertura no navegador: cadastre-se, adicione saldo, escolha um serviço e o Panamá, confirme o preço exibido, copie o número para o app e espere o código aparecer ao lado do pedido.

Como trato um número do Panamá que não recebe nada?

A janela de 20 minutos é a sua rede de segurança: você só é cobrado quando um código chega, e uma ativação expirada ou cancelada reembolsa o valor integral automaticamente. Quando um número fica em silêncio:

• Deixe-o correr até expirar em vez de cancelar e pedir de novo em segundos; loops apertados parecem suspeitos para o serviço remetente.
• Tente de novo após uma pausa, ou experimente outra rota de serviço.
• Confirme se o serviço aceita números virtuais; alguns os recusam de vez, e o reembolso existe para esse caso.
• Registre o evento activation.expired para que execuções instáveis fiquem visíveis em vez de silenciosas.

Esses números servem para testar e operar as suas próprias contas legítimas. Respeite os termos de cada serviço remetente e lembre-se de que a Política de Uso Aceitável da OTP Route rege cada pedido.

E linhas panamenhas de longo prazo, cobrança e testes em sandbox?

A OTP Route não vende um número panamenho de longo prazo em autoatendimento. Os Dedicated Numbers se limitam aos Estados Unidos e ao Canadá, a partir de $1.95/month; para uma linha panamenha, escreva para [email protected] e a equipe dirá se as regras locais permitem alguma coisa.

Os pagamentos passam por uma única carteira pré-paga em USD, sem mensalidade nem plano, recarregada por cartão ou USDT/USDC, com uma fatura em PDF enviada por e-mail a cada recarga. Uma conta de desenvolvimento pode ser movida para sandbox mediante pedido, o que devolve números e códigos simulados para que o fluxo completo seja testado sem tocar nos fundos da carteira. Veja os preços para as tarifas atuais.

Perguntas frequentes

Posso automatizar a verificação por SMS do Panamá no meu pipeline de CI?

Pode. Crie ativações com o país pa pela API REST e consuma o código de um webhook assinado ou fazendo polling da ativação.

Quantos dígitos têm os celulares panamenhos?

Os celulares têm oito dígitos começando com 6, escritos depois de +507, e não há prefixo de tronco a remover.

Quanto custa receber um OTP por SMS do Panamá?

A partir de $0.20 por código; o endpoint de preços da API devolve o valor exato de cada serviço antes do pedido.

Minha carteira é cobrada se o código não chegar?

Não. Sem SMS dentro da janela de 20 minutos, ou depois de um cancelamento, o valor é reembolsado automaticamente.

As mensagens de verificação do Panamá vêm em espanhol?

Normalmente, se o app localiza por região ou idioma da conta, então garanta que a sua lógica de extração lide com texto em espanhol.

Posso testar o meu fluxo de cadastro do Panamá sem um chip local?

Pode. Um número +507 do OTP Gateway atende um código por vez, então sua equipe nunca precisa de um aparelho panamenho.

Posso comprar um número +507 permanente?

Não em autoatendimento. Os Dedicated Numbers de longo prazo são um produto dos EUA e do Canadá; escreva para [email protected] para perguntar sobre o Panamá.

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.