API de OTP do Catar: webhooks, polling e números de teste +974

Como é a sequência de chamadas da API de OTP do Catar?

Tudo fica em https://otproute.com/api/v1, autenticado com uma chave Bearer que começa com or_live_. Você pode ter até 10 chaves, então dê chaves separadas ao CI, ao staging e ao script de operações e revogue uma sem mexer nas outras. Uma ativação +974 completa leva no máximo quatro chamadas:

1. GET /api/v1/prices?country=qa&service=<id> retorna o preço atual e informa que a rota está aberta para esse serviço agora.
2. POST /api/v1/activations com {"service": "<id>", "country": "qa"} reserva um número do Catar e retorna um id de ativação.
3. GET /api/v1/activations/{id} é a chamada de polling: mostra em que pé está o pedido do Catar e inclui o código após a entrega.
4. POST /api/v1/activations/{id}/cancel encerra o pedido mais cedo e devolve o valor à carteira.

Dois auxiliares completam o quadro: GET /api/v1/services associa nomes a ids de serviço, e GET /api/v1/balance permite que um pipeline pare antes de ficar sem saldo. Mantenha o tráfego abaixo de 300 requisições por minuto por conta. A visão geral para desenvolvedores reúne as páginas de referência.

Como um handler de webhook deve tratar os eventos de ativação do Catar?

O polling funciona, mas um webhook permite que o seu test runner reaja no instante em que algo acontece. Cadastre até cinco endpoints e assine activation.sms_received, activation.expired e activation.cancelled; o primeiro traz o código, e os outros dois dizem ao seu runner para parar de esperar.

Cada requisição inclui X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Reconstrua a string assinada como o timestamp, um ponto e o corpo bruto da requisição, calcule o HMAC-SHA256 com o segredo do endpoint e compare em tempo constante. Rejeite qualquer coisa com timestamp antigo. Como os reenvios podem entregar o mesmo evento mais de uma vez, guarde o id da ativação e ignore as repetições. Para uma implementação de referência, leia captura de OTP por webhook.

Quais serviços conseguem enviar um código para um número +974?

O Catar é uma das rotas mais amplas, com mais de 1.600 serviços no último snapshot. Entre os populares estão WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude e Discord.

O estoque muda ao longo do dia, então trate o snapshot como orientação e a resposta da API como a verdade. Alguns serviços recusam números virtuais; quando isso acontece, o pedido simplesmente expira e o dinheiro volta. Cada nome acima é marca registrada do respectivo titular, sem qualquer afiliação implícita.

Normalizando números do Catar nas fixtures de teste

Os números do Catar têm oito dígitos depois de +974 e nenhum prefixo de tronco, então não há nada para remover ao converter um número local para o formato internacional. Mantenha as fixtures em E.164 (+974 mais oito dígitos) e limpe entradas que os usuários digitam com 00974, espaços ou um zero inicial perdido, trazido de hábitos de outro país.

O árabe é o idioma oficial, enquanto o inglês é muito usado nos negócios e por uma população com grande parcela de expatriados. Por isso, os textos de verificação chegam no idioma que o serviço remetente escolhe para a conta, muitas vezes inglês ou árabe. Verifique se a sua lógica de extração encontra o código nos dois alfabetos e se uma interface em árabe mantém o campo de OTP utilizável em um layout da direita para a esquerda.

As equipes testam a rota do Catar ao lançar no GCC, ao localizar um app de consumo para falantes de árabe, ao operar hotelaria ou logística em Doha, ou ao verificar uma conta empresarial regional sem colocar o número pessoal de um funcionário nela. O guia de testes em CI mostra como encaixar essas checagens em execuções automatizadas.

Fazendo uma checagem do Catar pelo painel

Nem toda verificação precisa de um script. No painel, abra o OTP Gateway, selecione Catar e o serviço, confira o preço exibido e confirme. Copie o número +974 para o app, peça o SMS, e o código aparece no pedido. A janela de 20 minutos conta a partir do momento em que você faz o pedido, e você só paga se um código aparecer.

Códigos que não chegam: uma lista de depuração

• Esperou o suficiente? Deixe a ativação cumprir a janela completa antes de tratá-la como falha.
• Números virtuais aceitos? Alguns serviços os bloqueiam, e tentativas repetidas não mudam isso.
• A política de repetição está sensata? Espere um pouco e tente de novo mais tarde, ou troque para outra rota do mesmo serviço. Refazer o pedido em um laço rápido desperdiça o seu limite de requisições e raramente ajuda.
• O handler está saudável? Se a verificação de assinatura falhar ou o endpoint retornar erro, faça polling em GET /api/v1/activations/{id} para ver se o código foi entregue enquanto o seu webhook falhou.

Uma ativação que termina sem SMS, por expiração ou por cancelamento, é reembolsada integralmente.

Existe uma linha catariana de longo prazo, e como o uso é cobrado?

Não existe número de longo prazo em autoatendimento para o Catar. Os Números Virtuais Dedicados (sua própria linha com SMS de entrada e saída, encaminhamento por webhook e chamadas pelo navegador) são oferecidos apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês. Para uma necessidade específica do Catar, escreva para [email protected]; as regras locais determinam o que é possível.

O uso no Catar sai de uma única carteira pré-paga em USD, e nada é cobrado mensalmente. Recarregue por cartão ou USDT/USDC, receba uma fatura em PDF a cada recarga e peça o modo sandbox em uma conta de desenvolvimento se quiser testar a integração com números simulados. Use números +974 apenas para os seus próprios produtos e contas empresariais legítimas, respeite os termos de cada serviço e siga a Política de Uso Aceitável da OTP Route.

Perguntas frequentes

Como recebo códigos SMS OTP do Catar em um teste automatizado?

Crie uma ativação com o país qa, informe o número retornado no app em teste e aguarde o webhook activation.sms_received. A OTP Route também permite fazer polling da ativação se o seu test runner não puder receber requisições de entrada.

Posso usar um número +974 para testes sem um chip SIM do Catar?

Sim. O OTP Gateway fornece um número de verificação do Catar para um código, então você pode testar fluxos de cadastro ou login sem nenhum chip ou aparelho local.

Como confiro os preços do Catar antes de pedir?

Chame GET /api/v1/prices?country=qa&service=<id> ou consulte o painel. Os valores começam em $0.20 por código e variam conforme o serviço.

Sou cobrado por ativações do Catar que falham?

Não. Você só é cobrado quando um código chega; as ativações expiradas ou canceladas são reembolsadas automaticamente na carteira.

Por que testar com um número catariano e não com um de um país vizinho?

Escolha o país que corresponde ao mercado real da conta. Se o seu produto vai ser lançado no Catar, um número +974 exercita exatamente o tratamento do código de país, o idioma e o roteamento de OTP que os seus clientes verão, como explica o artigo sobre roteamento de OTP por país.

Uma conta de desenvolvimento pode funcionar sem saldo na carteira?

Sim. Sob solicitação, uma conta de desenvolvimento pode ser mudada para sandbox, que retorna números e códigos simulados para testes de ponta a ponta.

Posso manter um número do Catar para logins repetidos?

Não em autoatendimento, porque as linhas dedicadas se limitam aos EUA e ao Canadá. Escreva para [email protected] se quiser perguntar sobre uma linha de longo prazo do Catar.

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.