Códigos de verificação por SMS da Jamaica: checklist, passos e correções

O que devo confirmar antes da primeira ativação na Jamaica?

A Jamaica faz parte do Plano de Numeração Norte-Americano, então algumas verificações são diferentes das da maioria dos países:

• Seu validador aceita números +1 que não sejam dos EUA nem do Canadá. Muitos formulários de cadastro assumem em silêncio que todo número +1 é americano.
• Seu seletor de país lista a Jamaica separadamente, em vez de tratar o +1 como uma região única.
• Existe uma chave de API or_live_ no console de desenvolvedor, e um endpoint de webhook com seu segredo está implantado, ou seu harness de testes está configurado para fazer polling.
• A carteira tem saldo, ou o modo sandbox foi ativado para um ensaio.
• Você conhece o id do serviço em GET /api/v1/services; o id do país Jamaica é jm.

Errar os dois primeiros itens gera falhas que parecem problemas de roteamento, mas que vivem inteiramente no seu próprio código.

Por que um número jamaicano +1 exige tratamento especial?

Os números jamaicanos usam os códigos de área 876 e o mais recente 658, seguidos de um número de assinante de sete dígitos, então a forma E.164 completa é +1 mais dez dígitos. No uso doméstico as pessoas discam um 1 inicial para longa distância, que deve ser removido antes de armazenar.

O ponto importante para engenheiros é que o +1 sozinho não diz nada sobre o país. A detecção de região precisa olhar o código de área, e qualquer lógica que escolha moeda, fuso horário ou modelo de SMS a partir do código de discagem exige o mesmo cuidado. Armazene a string E.164 canônica, mantenha a região detectada em um campo separado e teste entradas 876 e 658.

O inglês é o idioma oficial e os SMS de verificação quase sempre chegam em inglês, enquanto a fala cotidiana costuma usar o patoá jamaicano. As equipes testam aqui para lançamentos no Caribe, para fluxos de remessas e fintech que atendem a diáspora nos EUA, no Reino Unido e no Canadá, e para produtos de turismo e hotelaria. O artigo sobre roteamento de OTP por país explica como escolher rotas por mercado.

Quais são os passos da API de verificação por SMS da Jamaica?

1. Confira o preço em tempo real com GET /api/v1/prices?country=jm&service=<id> na URL base https://otproute.com/api/v1.
2. Faça o pedido: POST /api/v1/activations com o corpo {"service": "<id>", "country": "jm"}. Anote o id da ativação e o número.
3. Envie o número no app que você está testando.
4. Receba o código pelo evento activation.sms_received no seu webhook, ou por polling em GET /api/v1/activations/{id}.
5. Desista de uma tentativa jamaicana mais cedo enviando POST /api/v1/activations/{id}/cancel, o que libera a reserva.

Antes de agir sobre qualquer evento, recalcule o HMAC-SHA256 de "<t>.<raw body>" com o segredo do seu endpoint, compare com o valor v1 em X-OTPRoute-Signature e recuse timestamps muito antigos. Trate também activation.expired e activation.cancelled, indexados pelo id da ativação, para que as novas tentativas nunca processem duas vezes. Para planejar capacidade, uma única conta pode ter 10 chaves e 5 endpoints de webhook, com um teto de 300 requisições por minuto entre eles.

Quais apps recebem códigos em uma rota jamaicana?

A Jamaica lista atualmente mais de 900 serviços. Entre os mais usados estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb e ChatGPT (OpenAI).

A disponibilidade por serviço varia ao longo do dia, então leia o endpoint de preços no início de cada execução em vez de fixar uma lista no código.

Como quem não programa segue o mesmo checklist no painel?

Crie uma conta em /signup com um código por e-mail ou com o Google, ative o TOTP e faça uma recarga. Depois abra o OTP Gateway, escolha o serviço, escolha a Jamaica e confirme o preço em tempo real. Cole o número no app, e o código aparece no painel assim que o SMS chegar. A equipe de suporte costuma usar esse caminho para reproduzir o problema de cadastro de um cliente em um número jamaicano.

Solução de problemas: o código jamaicano está atrasado, ausente ou foi recusado

• Rejeitado na entrada? Verifique primeiro o seu próprio formulário; um validador só para EUA é um culpado comum. Se o app de terceiros recusar o número, ele pode não aceitar números virtuais.
• Ainda nada? Deixe a ativação aberta pelos 20 minutos em vez de cancelar e pedir de novo.
• Continua nada? Tente de novo mais tarde ou com outra rota de serviço. Evite martelar o mesmo pedido em loop.

Quando nenhum SMS chega ao número antes do fim da janela, a cobrança integral é devolvida à carteira automaticamente. O guia sobre como reduzir entregas de OTP com falha traz um checklist mais longo.

As linhas dedicadas, a carteira e o sandbox valem para a Jamaica?

Compartilhar o código +1 não faz da Jamaica parte do produto dedicado. Os Números Virtuais Dedicados são vendidos apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês, e não existe número jamaicano de longo prazo em autoatendimento. Se precisar de um, escreva para [email protected] e pergunte; as regras locais decidem e nada é prometido.

Todo o resto funciona como em qualquer lugar: uma carteira pré-paga em USD, sem mensalidade, recargas por cartão ou USDT/USDC e uma fatura em PDF por e-mail para cada uma. O modo sandbox, disponível sob solicitação, devolve números e códigos simulados para testes de integração. Veja em /pricing como as cobranças funcionam.

Perguntas frequentes

Posso testar a verificação por telefone jamaicana do meu app sem estar em Kingston?

Sim. Peça um número +1 876 ou +1 658 para o seu serviço pela OTP Route e leia o código no painel ou na API, de onde sua equipe estiver.

Qual id de país devo enviar para a Jamaica?

Envie jm. O código de discagem é +1, mas a API identifica o país por esse id.

Um número jamaicano conta como um número dos EUA?

Não. Ele compartilha o código +1, mas é um país separado, com seus próprios códigos de área, e muitos apps o tratam como Jamaica.

O que acontece com meu dinheiro se o código jamaicano não vier?

Se nenhum SMS chegar em 20 minutos, ou se você cancelar, o valor integral volta para a carteira.

Posso comprar um número jamaicano de longo prazo na OTP Route?

Não em autoatendimento. Os Números Dedicados de longo prazo cobrem apenas os EUA e o Canadá; escreva ao suporte para perguntar sobre a Jamaica.

Existe um jeito de testar o fluxo de webhook sem pagar?

Peça o modo sandbox em uma conta de desenvolvimento. Ele devolve números e códigos simulados, e o artigo sobre captura de OTP por webhook explica o lado do handler.

Quais usos de um número +1 da Jamaica para testes são permitidos?

Testar seu próprio produto, automação de QA e operar contas empresariais legítimas. A rota do Caribe está sujeita aos termos de cada app, além da Política de Uso Aceitável da OTP Route.

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.