O caminho do desenvolvedor para códigos de verificação da Jordânia (+962)

Como é a sequência de requisições para um número +962?

A API de verificação por SMS é REST puro em https://otproute.com/api/v1, com chaves Bearer prefixadas por or_live_ que você gera no console de desenvolvedor. Esta é a ordem que a maioria das integrações segue para a Jordânia:

1. Descoberta: GET /api/v1/services e GET /api/v1/countries retornam os identificadores. A Jordânia é jo; um serviço como o Telegram é telegram.
2. Consulta de preço: GET /api/v1/prices?country=jo&service=telegram retorna quanto essa combinação custa agora e se pode ser pedida.
3. Pedido: POST /api/v1/activations com {"service": "telegram", "country": "jo"} reserva um número e devolve o id da ativação.
4. Coleta: faça polling em GET /api/v1/activations/{id} a cada poucos segundos, ou deixe o webhook enviar o resultado até você.
5. Limpeza: POST /api/v1/activations/{id}/cancel libera uma ativação de que você não precisa mais e a reembolsa.

GET /api/v1/balance é útil como trava no início de uma execução de testes, para que o job falhe cedo com uma mensagem clara quando a carteira estiver baixa. A referência completa está na documentação.

Como confirmo que um webhook realmente veio da OTP Route?

Cada evento (por exemplo activation.sms_received ou activation.expired) chega com um cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Seu servidor calcula o HMAC-SHA256 de "<t>.<raw body>" usando o segredo daquele endpoint e compara o resultado com v1. Rejeite a requisição se os valores diferirem ou se t estiver muito no passado; isso impede replays.

Como as novas tentativas podem entregar o mesmo evento duas vezes, indexe o processamento pelo id da ativação e trate uma segunda cópia como não-operação. O polling continua sendo um bom plano B no desenvolvimento local, onde uma URL pública de webhook é incômoda. O artigo sobre captura de OTP por webhook trata de filas e novas tentativas.

Quais apps podem ser verificados em uma rota da Jordânia?

Mais de 1.700 serviços estão listados para a Jordânia. Entre os populares estão WhatsApp, Telegram, Facebook, Instagram, Snapchat, TikTok, X (Twitter), Discord, Claude, Microsoft & Outlook, Amazon, Viber, imo, Signal e LinkedIn.

A lista é um retrato, não uma promessa. A capacidade das operadoras varia ao longo do dia, então a API informa a disponibilidade em tempo real e o seu código deve lê-la antes de fazer o pedido.

Formatando números jordanianos: zero de tronco, E.164 e texto em árabe

O código de país da Jordânia é +962 e o prefixo de tronco é 0. Localmente, um celular se escreve começando por 07; na forma internacional o zero some, ficando +962 seguido de nove dígitos que começam com 7. Armazene a forma E.164 e, quando os usuários colarem um número local, remova o 0 inicial antes de adicionar o código do país. Comparar 07… com +9627… como strings é uma causa clássica de bugs de conta duplicada.

O árabe é o idioma oficial, e muita gente configura o celular e os apps nesse idioma. Dependendo do app e da configuração de idioma da conta, um código pode chegar em texto árabe ou inglês. As mensagens em árabe são enviadas em Unicode, e os dígitos podem ficar dentro de um texto da direita para a esquerda, então extraia o código com um padrão e teste os dois idiomas.

As equipes trabalham com a Jordânia quando localizam um produto para falantes de árabe, operam o suporte a partir de Amã para a região ampla ou verificam fluxos junto com mercados vizinhos, como a Arábia Saudita e os Emirados Árabes Unidos.

Pedindo um código da Jordânia pelo painel

A equipe de operações pode fazer a mesma coisa sem escrever código. Crie uma conta com e-mail e um código de seis dígitos ou com o login do Google, adicione saldo, escolha a Jordânia e o serviço no OTP Gateway, confirme o preço exibido e faça o pedido. O número +962 aparece na hora, e o código surge ao lado dele quando o SMS chega.

A ativação fica aberta por 20 minutos. Você só paga se o código chegar; se a janela fechar vazia ou você cancelar, o valor é devolvido à sua carteira automaticamente.

Uma ordem de depuração para códigos que não chegam

Comece pela explicação mais simples e vá ampliando:

• A janela ainda está aberta? A entrega depende do serviço e da rota. Deixe os 20 minutos completos correrem antes de decidir que falhou.
• O serviço aceita números virtuais? Alguns não aceitam, e por isso as ativações não usadas são reembolsadas.
• Tente outra rota. Peça de novo mais tarde, ou use uma rota de serviço diferente para a mesma funcionalidade, se o seu produto permitir.
• Controle as tentativas. Um loop que refaz o pedido a cada poucos segundos só queima tentativas; espace-as.

Teste apenas contas que você possui ou opera, siga as regras de cada serviço e lembre que a Política de Uso Aceitável da OTP Route cobre todo o uso.

Linhas de longo prazo, carteira e sandbox

A OTP Route não tem número de longo prazo em autoatendimento na Jordânia. Os Números Dedicados, a partir de $1.95/mês, são oferecidos de forma instantânea apenas nos EUA e no Canadá. Se a sua equipe precisa de uma linha +962 duradoura, escreva para [email protected]; se algo pode ser providenciado depende das regras locais.

A carteira é pré-paga em USD, sem mensalidade e sem plano para escolher. Recarregue com cartão ou com USDT/USDC e receba uma fatura em PDF por e-mail a cada recarga. Durante a integração, peça o modo sandbox em uma conta de desenvolvimento para receber números e códigos simulados sem gastar saldo. Veja os preços para as tarifas atuais.

Perguntas frequentes

Qual é o código de país da Jordânia na API?

Use jo como valor de country na API da OTP Route, por exemplo em GET /api/v1/prices?country=jo&service=whatsapp.

Devo remover o 0 de um celular jordaniano?

Sim, no formato internacional. Um número local 07 vira +962 seguido de nove dígitos começando com 7.

Um código de verificação da Jordânia chega em árabe?

Pode chegar. O idioma costuma seguir o app e as configurações da conta, então extraia os dígitos por padrão e teste mensagens em árabe e em inglês.

Por quanto tempo um número +962 fica reservado para o meu código?

Cada ativação dura 20 minutos. Se nenhum SMS chegar nesse prazo, a cobrança volta para a sua carteira.

Posso ter um número dedicado da Jordânia que eu mantenha?

Não em autoatendimento. Os Números Dedicados são um produto dos EUA e do Canadá; para a Jordânia você pode escrever para [email protected] e perguntar.

Há como receber SMS OTP da Jordânia em testes automatizados?

Sim. Faça o pedido com POST /api/v1/activations e depois faça polling da ativação ou trate o webhook assinado; uma conta sandbox permite ensaiar isso com códigos simulados.

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.