Códigos de verificação do Paraguai (+595), começando pela API

Como peço um número +595 por código?

Comece no console do desenvolvedor e crie uma chave Bearer; as chaves começam com or_live_ e você pode ter até 10, o que facilita ter chaves separadas para staging e CI. Todas as chamadas vão para https://otproute.com/api/v1.

1. Guarde em cache o catálogo de GET /api/v1/services e GET /api/v1/countries. O Paraguai aparece como py.
2. Antes de cada pedido, leia GET /api/v1/prices?country=py&service=<id>. Preço e disponibilidade são valores em tempo real, não constantes.
3. Faça o pedido com POST /api/v1/activations e {"service": "whatsapp", "country": "py"}. Guarde o id da ativação da resposta.
4. Envie o número no fluxo que você está testando.
5. Aguarde o webhook ou consulte GET /api/v1/activations/{id}; chame POST /api/v1/activations/{id}/cancel se o teste parar antes.

GET /api/v1/balance é útil como etapa prévia em um pipeline, para que o job falhe de forma explícita com a carteira vazia em vez de estourar o tempo limite. O guia de integração percorre as mesmas chamadas com mais contexto.

O que o handler de webhook deve fazer com um código paraguaio?

Seu endpoint recebe activation.sms_received quando a mensagem chega, activation.expired quando a janela fecha vazia e activation.cancelled depois de um cancelamento. Cada um está ligado ao id da ativação.

• Verifique primeiro. Separe X-OTPRoute-Signature em t e v1, calcule o HMAC-SHA256 do timestamp, um ponto e o corpo bruto da requisição com o segredo do endpoint e compare em tempo constante.
• Rejeite requisições antigas. Um timestamp muito distante do seu relógio indica um replay ou um servidor com horário muito errado.
• Seja idempotente. Guarde o id da ativação e ignore repetições, para que um reenvio nunca processe um código em dobro.

São permitidos até 5 endpoints de webhook por conta. Se preferir polling, mantenha o intervalo moderado; o limite é de 300 requisições por minuto na conta inteira. O guia de webhooks com HMAC traz uma lista de verificação mais completa.

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

O Paraguai oferece atualmente mais de 1.600 serviços. Entre os mais pedidos estão WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix e ChatGPT (OpenAI). O WhatsApp é o mensageiro do dia a dia de muita gente na região, então costuma ser o primeiro serviço que as equipes verificam ao testar atendimento por chat.

Como se escrevem e se normalizam os celulares +595?

O Paraguai usa o prefixo de tronco 0 para discagem doméstica, então um celular visto localmente começa com 09. Em E.164 esse 0 some: a forma canônica é +595 seguido de nove dígitos, com os celulares começando em 9. Normalize na entrada, guarde apenas a forma E.164 e formate para exibição na borda. Regras de validação que esperam um comprimento fixo de outro país são um motivo comum de falha no cadastro de usuários paraguaios, então inclua um número +595 nos seus casos de teste de validação.

Espanhol e guarani são idiomas oficiais. As mensagens de verificação de serviços internacionais tendem a vir em espanhol ou inglês, conforme o modelo e as configurações da conta. Extraia o código com um padrão só de dígitos e mantenha o corpo das mensagens em UTF-8, para que caracteres acentuados e o ñ sobrevivam ao registro em log.

Por que as equipes verificam contas no Paraguai?

O Paraguai faz parte do Mercosul e fica entre Argentina, Brasil e Bolívia, então empresas que já operam na região costumam incluí-lo em um lançamento sul-americano. Entre os motivos típicos para testar lá estão o QA de localização em espanhol para um público paraguaio, a confirmação de que um fluxo regional de onboarding aceita números +595, equipes de operações que verificam perfis empresariais de clientes locais e o suporte a paraguaios no exterior que se cadastram com números do país. A página de verificação em apps móveis descreve como essas verificações se encaixam nos testes de release.

Existe uma forma sem código de obter um número de verificação do Paraguai?

Existe. No painel, abra o OTP Gateway, escolha Paraguai e um serviço, revise o preço e confirme. Copie o número para o app e deixe a ativação aberta até o código aparecer ao lado dela. Os pedidos pelo navegador e pela API usam a mesma carteira e o mesmo histórico.

O que ajuda quando um código +595 não aparece?

Dê à ativação os 20 minutos completos antes de tirar conclusões. Se ela fechar vazia, a cobrança volta automaticamente. Depois percorra as causas usuais: o serviço pode recusar números virtuais, a rota pode estar congestionada naquela hora, ou outra rota de serviço pode funcionar mais tarde. Não dispare pedidos repetidos em um loop apertado; adicione um backoff entre as tentativas e registre os ids das ativações para identificar padrões por serviço.

Posso manter um número paraguaio a longo prazo e como funciona a cobrança?

Linhas de longo prazo não são vendidas em autoatendimento para o Paraguai. Os Dedicated Virtual Numbers existem apenas nos Estados Unidos e no Canadá, a partir de $1.95/month, por isso uma conta que precisa continuar entrando é muitas vezes alocada em um deles. Para perguntar sobre uma linha paraguaia de longo prazo, escreva para [email protected]; a resposta depende das regras locais.

A cobrança usa uma única carteira pré-paga em USD: recarregue por cartão ou USDT/USDC, receba uma fatura em PDF por e-mail e pague apenas pelos códigos que chegam. Contas de desenvolvimento podem ser mudadas para sandbox mediante pedido, com números e códigos simulados. A OTP Route serve para testar e operar os seus próprios produtos legítimos; siga os termos de cada serviço e a Política de Uso Aceitável.

Perguntas frequentes

Qual é o id do Paraguai na API da OTP Route?

É py. Use-o na consulta de preços e no corpo de POST /api/v1/activations.

Guardo os números paraguaios com o prefixo 09?

Não. Remova o 0 doméstico e guarde +595 seguido do número nacional de nove dígitos.

Quanto custa um número +595 para testes?

Uma ativação paraguaia custa a partir de $0.20 por código, conforme o serviço, e a carteira só é debitada por um código que realmente chega.

Posso testar um fluxo de cadastro em espanhol para o Paraguai sem um chip local?

Pode. Peça um número de verificação do Paraguai no OTP Gateway e leia o código no painel ou pela API.

Os códigos chegarão em guarani?

Raramente, se é que chegam. Os serviços internacionais costumam enviar texto em espanhol ou inglês, então extraia apenas os dígitos.

O que acontece com o meu dinheiro se a ativação expirar?

Quando nenhum SMS chega dentro da janela de 20 minutos, o valor integral volta automaticamente para a sua 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.