Montando um teste de verificação +592 com webhooks e polling

Como projetar um fluxo de API OTP da Guiana baseado em webhook?

Para qualquer coisa além de uma verificação pontual, deixe a plataforma enviar os códigos até você em vez de perguntar repetidamente. No console do desenvolvedor, adicione um endpoint HTTPS (uma conta pode ter 5) e assine-o em activation.sms_received, além de activation.expired e activation.cancelled, para que o seu executor de testes saiba dos becos sem saída tão rápido quanto dos sucessos.

Trate toda requisição recebida como não confiável até que passe pela verificação:

• Leia o cabeçalho X-OTPRoute-Signature, que tem o formato t=<unix>,v1=<hex>.
• Junte o timestamp, um ponto e o corpo da requisição sem alterações, e calcule o HMAC-SHA256 dessa string com o segredo do endpoint.
• Compare o seu resultado com v1 em tempo constante e descarte a requisição se o timestamp estiver vencido.
• Encontre o id da ativação no evento; se você já o processou, retorne sucesso e não faça mais nada.

Essa última regra mantém o handler idempotente, de modo que um reenvio após uma falha de rede nunca confunda o teste. Um tratamento mais longo está em captura de OTP por webhook.

Quais endpoints e ids um pedido +592 usa?

Autentique-se com uma chave Bearer do console do desenvolvedor; as chaves live começam com or_live_ e cada conta pode manter até 10. A URL base é https://otproute.com/api/v1, e o id de país da Guiana é gy.

Uma execução típica lê primeiro GET /api/v1/prices?country=gy&service=<id>, porque o preço e a disponibilidade nesta rota são valores ao vivo, e não constantes. Depois envia POST /api/v1/activations com {"service": "<id>", "country": "gy"} e recebe de volta um número +592 e um id de ativação. Sem webhook, o executor faz polling de GET /api/v1/activations/{id} a cada poucos segundos, bem abaixo do teto de 300 requisições por minuto. Uma etapa de limpeza chama POST /api/v1/activations/{id}/cancel quando o teste é abortado, e uma chamada prévia a GET /api/v1/balance interrompe a suíte cedo se a carteira estiver baixa. Os ids de serviço vêm de GET /api/v1/services; o hub do desenvolvedor tem exemplos de cliente para esta API de verificação por SMS.

Como formatar números +592 para armazenamento?

A Guiana usa o código de país 592 e números nacionais de sete dígitos, sem prefixo de tronco para remover, então a forma E.164 é simplesmente +592 seguido desses sete dígitos. Costuma-se escrever os dígitos em um grupo de três e outro de quatro.

Sem zero inicial para tirar, a normalização se resume a apagar espaços e hifens e acrescentar o código do país quando o usuário digita só os dígitos locais. Um erro frequente é um formulário que presume que todo número sul-americano tem código de área, ou que define um tamanho mínimo acima de sete dígitos e, assim, rejeita entradas guianenses válidas. Um número +592 para testes expõe isso rapidamente. Salve a string E.164 e aplique a formatação local somente na hora de exibir.

Quais serviços recebem códigos SMS OTP da Guiana, e posso pedir manualmente?

A rota da Guiana lista mais de 900 serviços. Entre os mais solicitados estão WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix e Claude. Essa lista é um retrato do catálogo ao vivo, então confirme pela API ou pelo painel antes de planejar um teste em torno de um remetente específico.

Para colegas que não programam, o painel faz o mesmo trabalho. Entre, abra o OTP Gateway, escolha Guiana e um serviço, confira o preço e faça o pedido. O número de verificação da Guiana aparece junto com uma contagem regressiva de 20 minutos, e o código é exibido ao lado quando chega.

O que um teste deve fazer quando o código +592 atrasa ou não chega?

Uma ativação fica aberta por 20 minutos. Você só paga se o código chegar dentro dessa janela; se ela expirar ou você cancelar, o valor integral volta para a carteira sem nenhum chamado ao suporte.

Um tratamento sensato em uma execução automatizada:

1. Espere a janela terminar antes de declarar falha, a menos que o seu teste tenha um limite de tempo rígido, caso em que você deve cancelar explicitamente.
2. Tente de novo mais tarde, ou mude para outra rota de serviço se a API oferecer uma.
3. Verifique se o serviço de destino aceita números virtuais; alguns os recusam, e o reembolso cobre exatamente esse caso.
4. Espace as novas tentativas com um backoff em vez de refazer o pedido em laço apertado.

O guia de roteamento de países para OTP explica como escolher rotas alternativas.

Por que as equipes testam fluxos de cadastro na Guiana?

A Guiana é o único país sul-americano com o inglês como idioma oficial, e Georgetown abriga o Secretariado da CARICOM, por isso ela costuma aparecer em lançamentos que tratam a Comunidade do Caribe como um único mercado. Um setor energético offshore em rápido crescimento atraiu empreiteiros e fornecedores internacionais, enquanto uma grande diáspora nos Estados Unidos, no Canadá e no Reino Unido mantém aplicativos de remessas, mensagens e viagens ativos em números +592. O crioulo guianense é muito falado no dia a dia, mas os textos de verificação geralmente chegam em inglês. Para o QA, isso direciona o esforço para a digitação do número, os seletores de país e o texto de consentimento de SMS, e não para cópias traduzidas. Mantenha todas as verificações em contas que a sua organização possui, siga os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route vale para todos os pedidos.

Posso manter uma linha da Guiana, e como o uso é cobrado?

Números de longo prazo de autoatendimento não são oferecidos para a Guiana. Os Números Dedicados da OTP Route cobrem apenas os Estados Unidos e o Canadá, a partir de $1.95/month. Para uma linha +592, escreva para [email protected] e a equipe verificará o que as regras locais permitem, sem nenhuma promessa.

O pagamento passa por uma única carteira pré-paga em USD: sem mensalidade, sem plano, recargas por cartão ou USDT/USDC e uma fatura em PDF por e-mail a cada uma. Uma conta de desenvolvimento pode ser movida para o sandbox sob solicitação, de modo que os testes de integração rodem com números e códigos simulados e deixem o saldo intacto. As tarifas por serviço aparecem na página de preços.

Perguntas frequentes

Posso verificar o cadastro do meu app na Guiana sem um chip de uma operadora guianense?

Sim. Peça um número +592 no OTP Gateway para o seu serviço, informe-o no seu fluxo, e o código aparece no painel ou chega ao seu webhook. Os preços começam em $0.20 por código.

Que id de país a API usa para a Guiana?

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

Preciso remover um zero inicial dos números da Guiana?

Não. A Guiana não tem prefixo de tronco, então a forma E.164 é +592 seguido do número de sete dígitos.

Em que idioma chegam as mensagens de verificação +592?

Normalmente em inglês, o idioma oficial. Mas o remetente controla o texto e pode seguir a configuração de idioma do app.

Há reembolso se o serviço nunca enviar o SMS?

Sim, e é automático. Se passarem 20 minutos sem código, ou se você cancelar, o valor total volta para a sua carteira.

Posso testar toda a integração sem gastar dinheiro?

Peça ao suporte para mudar a sua conta de desenvolvimento para o sandbox. Ele devolve números e códigos simulados, de modo que as chamadas de API e os webhooks possam ser exercitados de ponta a ponta.

Há um número +592 de longo prazo disponível?

Não como produto de autoatendimento. Os Números Dedicados são vendidos somente nos Estados Unidos e no Canadá; escreva para [email protected] para perguntar sobre a Guiana.

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.