Números de verificação da Guatemala (+502) para testes e operações

O que faz a Guatemala merecer uma rodada de testes dedicada?

A Guatemala é o país mais populoso da América Central e, para muitas equipes, o primeiro mercado de um lançamento regional em espanhol. O espanhol é a língua oficial, mas uma grande parte da população também fala uma das muitas línguas maias, o que importa se o texto do seu onboarding ou o conteúdo de suporte vai além do espanhol.

Três situações aparecem repetidamente:

• Lançamentos regionais que precisam ter a tela de entrada do telefone, o texto do SMS em espanhol e a etapa de verificação conferidos em uma rota +502 real (verificação de apps móveis).
• Produtos para a diáspora, como apps de remessas ou de chamadas usados por guatemaltecos que vivem nos Estados Unidos, em que a conta está vinculada a um número do país de origem.
• Equipes de operações que gerenciam perfis comerciais de clientes guatemaltecos que preferem não vincular o telefone pessoal de ninguém (equipes de operações).

Como os números de telefone da Guatemala são formatados?

A Guatemala usa números nacionais de oito dígitos e não tem prefixo de tronco, então não há zero inicial para remover. A forma E.164 é simplesmente +502 seguido desses oito dígitos, escrito como +502 xxxx xxxx.

Esse comprimento curto atrapalha validadores de formulários escritos pensando em números norte-americanos de dez dígitos. Adicione casos de teste para uma entrada de oito dígitos, para usuários que digitam o 502 sem o sinal de mais e para espaços ou hifens no meio. Armazene a string E.164 normalizada e evite adivinhar se um número é móvel ou fixo apenas pelo comprimento, porque ambos têm os mesmos oito dígitos.

Posso receber códigos SMS OTP da Guatemala pela API?

Sim. A API OTP da Guatemala usa o id de país gt na URL base https://otproute.com/api/v1, autenticada com uma chave Bearer com o prefixo or_live_.

Comece com GET /api/v1/services para encontrar o id do serviço e depois confira a cotação atual com GET /api/v1/prices?country=gt&service=<id>. Crie o número usando POST /api/v1/activations e o corpo {"service": "<id>", "country": "gt"}. Quando o seu app enviar o SMS, faça polling em GET /api/v1/activations/{id} ou deixe um endpoint de webhook receber activation.sms_received. Verifique o cabeçalho X-OTPRoute-Signature, um HMAC-SHA256 sobre o timestamp e o corpo bruto, e rejeite timestamps antigos, como descrito em como proteger webhooks de OTP. A visão geral para desenvolvedores lista os limites: 10 chaves, 5 endpoints de webhook, 300 requisições por minuto.

Quais serviços estão na rota +502 agora?

Mais de 1,600 serviços estão listados para a Guatemala. O retrato atual dos populares inclui WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), X (Twitter), Uber, Amazon, Discord, LinkedIn, Signal, Netflix e Microsoft & Outlook. O estoque gira ao longo do dia, e é por isso que a API retorna a disponibilidade ao vivo em vez de um catálogo fixo.

Existe um caminho sem código para a equipe de suporte e operações?

Qualquer pessoa da equipe pode pedir pelo painel depois de se cadastrar com e-mail e um código de 6 dígitos ou com o login do Google. Escolha Guatemala, selecione o serviço, confirme o preço exibido e copie o número +502 para o app. O código aparece na mesma tela quando chegar. Ativar a autenticação em dois fatores (TOTP) na própria conta da OTP Route é um passo sensato para o acesso compartilhado da equipe.

Por que o meu código +502 não apareceu, e o que devo tentar?

O número fica ativo por 20 minutos, e a cobrança só vale quando um código é entregue. Se a janela expirar ou você cancelar, o valor integral volta automaticamente para a carteira.

1. Espere a janela terminar; o tempo de entrega depende do serviço e da rota.
2. Tente de novo mais tarde, ou por outra rota de serviço, se houver.
3. Confirme que o serviço aceita números virtuais, já que alguns os recusam.
4. Não dispare novos pedidos em um loop apertado; espaçe as tentativas.

E os números guatemaltecos de longo prazo, a cobrança e o sandbox?

Um número guatemalteco de longo prazo em autoatendimento não existe na OTP Route. As linhas dedicadas são apenas para os Estados Unidos e o Canadá, a partir de $1.95/month. Se você precisa de uma linha +502 duradoura, escreva para [email protected]; a possibilidade de arranjar algo depende das regras locais e não é garantida.

O pagamento passa por uma carteira pré-paga em USD sem plano nem mensalidade, abastecida por cartão ou USDT/USDC, com uma fatura em PDF enviada por e-mail a cada recarga. Para o trabalho de integração, uma conta de desenvolvimento pode ser colocada em sandbox mediante pedido, para que números e códigos simulados passem pelo seu código sem custo.

Perguntas frequentes

Posso testar o nosso cadastro em espanhol para a Guatemala sem um chip local?

Sim. Peça um número gt no OTP Gateway, informe-o no seu app e leia o código em espanhol no painel ou no seu webhook.

Os números da Guatemala precisam de um zero inicial?

Não. A Guatemala não tem prefixo de tronco, então um número é apenas +502 mais oito dígitos.

Qual é o menor preço que um código +502 pode ter?

Os preços começam em $0.20 por código; o valor de um serviço específico é retornado por GET /api/v1/prices e exibido antes de você confirmar.

Serei cobrado se o SMS de verificação nunca chegar?

Não. Sem um código entregue dentro da janela de 20 minutos, ou depois de um cancelamento, o valor integral volta para a carteira.

A OTP Route pode manter o mesmo número +502 para a minha equipe a longo prazo?

Não em autoatendimento. Os números do OTP Gateway atendem a um único código, e as linhas de longo prazo são apenas dos EUA e do Canadá; por isso, pergunte sobre a Guatemala a [email protected].

Quais regras se aplicam ao uso desses números?

Os termos de cada serviço mais a Política de Uso Aceitável da OTP Route. Use os números apenas para testar ou operar os seus próprios produtos e contas comerciais legítimos.

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.