Receber códigos de verificação +966 por programação em lançamentos na Arábia Saudita

Como é uma ativação +966 pela API?

Comece pelas chamadas, já que a maioria dos leitores desta página está integrando uma API de verificação por SMS a uma suíte de testes ou a uma ferramenta interna. Todos os endpoints ficam em https://otproute.com/api/v1 e esperam uma chave Bearer com o prefixo or_live_, criada no console do desenvolvedor.

1. GET /api/v1/countries e GET /api/v1/services fornecem os ids. A Arábia Saudita é sa.
2. GET /api/v1/prices?country=sa&service=<id> retorna o preço atual dessa combinação; registre-o junto da execução do teste.
3. POST /api/v1/activations com {"service": "<id>", "country": "sa"} retorna um id de ativação e um número +966.
4. O seu teste digita o número no app, e o código chega como evento ou por GET /api/v1/activations/{id}.
5. Se o teste for abandonado, POST /api/v1/activations/{id}/cancel libera o número e reembolsa a carteira.

GET /api/v1/balance é útil como verificação prévia, para que um job noturno falhe cedo com uma mensagem clara em vez de no meio da execução. Limites a considerar: 10 chaves e 5 endpoints de webhook por conta, 300 requisições por minuto.

Como o nosso receptor de webhook deve tratar eventos de OTP sauditas?

Registre um endpoint e assine activation.sms_received, activation.expired e activation.cancelled. Toda requisição inclui X-OTPRoute-Signature no formato t=<unix>,v1=<hex>.

• Reconstrua a string assinada como <t>.<raw body> e calcule o HMAC-SHA256 com o segredo desse endpoint.
• Compare com v1 usando uma função de tempo constante e rejeite qualquer requisição com timestamp antigo demais.
• Trate cada evento como identificado pelo id da ativação, de modo que uma reentrega não atualize nada duas vezes.
• Responda com um 2xx rapidamente e deixe o trabalho lento para um job em segundo plano.

O polling continua sendo uma alternativa válida para runners que não aceitam conexões de entrada. Nossos artigos sobre captura de OTP por webhook e proteção de webhooks de OTP com HMAC aprofundam o tema.

Por que equipes de produto testam com um número +966?

A Arábia Saudita é um dos maiores mercados digitais do Golfo, e as equipes chegam a esta página por motivos práticos: uma fintech que prepara o onboarding de residentes sauditas, um marketplace que adiciona vendedores do Golfo, um fornecedor de SaaS cujo cliente exige uma verificação de login regional ou uma equipe de operações que gerencia contas empresariais de um escritório em Riade ou Jeddah. Em cada caso alguém precisa provar que o fluxo funciona com um número de verificação saudita real, e o roteamento de OTP pelo gateway evita enviar chips para a região. A página de onboarding de fintech descreve esse cenário com mais detalhes.

Quais serviços recebem códigos nas rotas sauditas?

O panorama atual da Arábia Saudita cobre mais de 1.000 serviços. Entre os mais usados estão Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord e Netflix. Snapchat e X têm públicos especialmente grandes no Reino, o que os torna itens comuns em uma lista de verificação de localização. O estoque muda ao longo do dia, então consulte a API na hora da execução.

Como formatar números +966 e interpretar mensagens em árabe?

Localmente, os celulares sauditas são escritos com o 0 do prefixo de tronco, normalmente como 05 seguido de oito dígitos. A forma internacional elimina esse zero: +966 5 e os oito dígitos restantes. Normalize tudo para E.164 no ponto de entrada e remova o zero se o usuário o digitar depois do código do país.

O árabe é o idioma oficial, então os textos de verificação podem chegar em árabe, em inglês ou nos dois. O árabe é escrito da direita para a esquerda, e alguns modelos podem usar dígitos árabe-índicos em vez de algarismos ocidentais. Um parser que converte esses dígitos para ASCII antes de comparar, e que registra o UTF-8 bruto, evita uma classe irritante de falsas falhas.

Existe um caminho pelo painel para quem não programa?

Sim. Entre na OTP Route, abra o OTP Gateway, escolha Arábia Saudita e o serviço, confira o preço e confirme. O número aparece de imediato e o código é exibido ao lado quando chega. Um atendente de suporte pode usar isso para reproduzir o problema de cadastro de um cliente em poucos minutos.

E se o código nunca chegar, e as linhas de longo prazo e a cobrança?

Se nenhum SMS chegar em 20 minutos, ou se você cancelar, o valor integral volta automaticamente para a carteira. Deixe a janela terminar, tente de novo mais tarde ou por outra rota de serviço, confirme que o serviço aceita números virtuais e evite refazer o pedido em um laço rápido.

Não há número saudita de longo prazo em autoatendimento. Os Números Virtuais Dedicados são oferecidos apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês; para uma linha +966 de longo prazo, escreva para [email protected], lembrando que as regras locais definem se isso é possível.

O financiamento usa uma única carteira pré-paga em USD, pague conforme o uso, sem mensalidade. Pagamentos por cartão e USDT/USDC funcionam para recargas, e cada uma gera uma fatura em PDF enviada por e-mail. Uma conta de desenvolvimento pode ser trocada para sandbox mediante pedido, com números e códigos simulados. Veja os valores atuais na página de preços.

Perguntas frequentes

Como recebo um SMS OTP saudita por uma API?

Crie uma ativação com o país sa e o id do seu serviço e depois pegue o código no webhook activation.sms_received ou fazendo polling da ativação.

Um número +966 para testes é cobrado se o código falhar?

Não. Um código ausente significa que o valor integral volta para a carteira quando a janela de 20 minutos fecha ou você cancela.

Posso testar o fluxo de cadastro saudita do meu app sem um chip local?

Sim. O OTP Gateway emite um número +966 para um código, que você digita no seu app e lê de volta pelo painel ou pela API.

Como devo armazenar um celular saudita digitado como 05XXXXXXXX?

Remova o zero do prefixo de tronco e salve como +966 5 mais os oito dígitos restantes em E.164.

Podemos manter o mesmo número saudita para logins futuros?

Não com um produto de autoatendimento, porque os Números Dedicados de longo prazo cobrem apenas os EUA e o Canadá. Escreva para a equipe se precisar de uma linha saudita, sem garantia de que ela possa ser fornecida.

Dá para ensaiar o fluxo saudita antes de envolver dinheiro de verdade?

Sim. Peça o modo sandbox em uma conta de desenvolvimento para receber números e códigos simulados, inclusive com webhooks.

Que uso a OTP Route permite?

Testar e operar os seus próprios produtos e contas legítimos. Siga os termos de cada serviço; a Política de Uso Aceitável da OTP Route se aplica.

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.