API de verificação por SMS da Nigéria (+234) para equipes de QA, fintech e lançamento

Quais endpoints devo chamar para receber um OTP nigeriano?

Tudo fica em https://otproute.com/api/v1 e se autentica com uma chave Bearer que começa com or_live_. O id do país da Nigéria é ng. Uma integração típica faz quatro chamadas:

1. GET /api/v1/prices?country=ng&service=<id> para confirmar o preço atual antes de se comprometer.
2. POST /api/v1/activations com {"service": "<id>", "country": "ng"} para reservar um número +234. Guarde o id da ativação devolvido: toda chamada posterior e todo evento de webhook são identificados por ele.
3. GET /api/v1/activations/{id} para ler o status e, depois da entrega, o código.
4. POST /api/v1/activations/{id}/cancel se o seu teste falhar antes e você não precisar mais do número.

GET /api/v1/balance é útil como verificação prévia no CI, para que uma suíte noturna falhe logo quando a carteira estiver baixa. O guia de integração da API de OTP percorre a mesma sequência com tratamento de erros.

Uma suíte de testes em Lagos deve usar polling ou webhooks?

O polling serve bem para algumas execuções manuais. Quando um pipeline pede vários números +234 em paralelo, os webhooks são mais limpos. Registre um dos seus cinco endpoints no console do desenvolvedor e assine activation.sms_received, activation.expired e activation.cancelled.

Cada requisição traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 sobre o timestamp, um ponto e o corpo bruto usando o segredo do seu endpoint, compare em tempo constante e descarte a requisição se o timestamp for antigo. Guarde os ids de ativação já processados para que um evento reenviado não dispare o seu teste duas vezes. O artigo sobre como proteger webhooks de OTP com HMAC traz uma lista de verificação mais completa. Mantenha o tráfego total abaixo de 300 requisições por minuto por conta, o que é bastante folgado se você usar eventos em vez de polling agressivo.

Quais serviços estão disponíveis nas rotas +234?

A rota ng lista atualmente mais de 2.700 serviços. Entre os mais pedidos estão WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon e ChatGPT (OpenAI). O estoque muda ao longo do dia conforme nossos parceiros de operadora atualizam a oferta, então consulte a disponibilidade em tempo real em vez de presumir que um serviço visto ontem ainda está lá.

Por que as equipes precisam de um número de verificação da Nigéria?

A Nigéria é um dos mercados de fintech e de aplicativos de consumo mais movimentados da África, e muitos produtos tratam o número de telefone como identidade principal. Isso faz da etapa do SMS uma parte crítica do onboarding de carteiras digitais, apps de crédito, transporte por aplicativo, entregas e produtos sociais. Equipes de fora do país usam um número +234 para testes para confirmar que o fluxo de cadastro, o temporizador de reenvio e a mensagem de erro se comportam como para um usuário local.

O inglês é o idioma oficial, então os textos de verificação costumam chegar em inglês, o que mantém simples a lógica de verificação dos testes automatizados. Equipes de fintech, em particular, devem ver a página de onboarding para fintech para entender como isso convive com verificações de identidade que a OTP Route não substitui.

Como são formatados os números de celular nigerianos?

O código do país é +234 e o prefixo de tronco é 0. Os nigerianos costumam escrever um celular com onze dígitos começando em zero, como 0803 123 4567; na forma internacional o zero some e o resultado é +234 803 123 4567. Guarde o valor em E.164 (+234803...), aceite o formato local de onze dígitos na entrada e remova o 0 inicial antes de salvar. Um validador que só confere o comprimento total aceita sem reclamar +2340803..., causa frequente de falhas de envio em produção.

Posso pedir um número nigeriano pelo painel?

Pode. Cadastre-se com um código por e-mail ou com o Google, adicione saldo à carteira, abra o OTP Gateway, escolha Nigéria e o serviço e confirme o preço exibido. O número fica pronto na hora e o código aparece ao lado do pedido assim que chega.

Se não chegar, deixe a janela de 20 minutos correr até o fim; você só paga se o código chegar, e pedidos expirados ou cancelados são reembolsados automaticamente. Depois tente um novo pedido um pouco mais tarde, experimente outra rota, como Gana, quando o seu teste permitir, e verifique se o serviço recusa números virtuais. Evite disparar novos pedidos em um loop apertado.

E linhas nigerianas de longo prazo, cobrança e sandbox?

A OTP Route não tem um número nigeriano de longo prazo em autoatendimento. Os Dedicated Numbers são vendidos apenas para os Estados Unidos e o Canadá, a partir de $1.95/month. Para uma linha +234 duradoura, escreva para [email protected]; a possibilidade depende da regulamentação local.

Os gastos saem de uma única carteira pré-paga em USD, sem plano nem mensalidade. Recarregue por cartão ou com USDT/USDC e receba uma fatura em PDF a cada recarga. Peça ao suporte para mudar uma conta de desenvolvimento para o modo sandbox e a sua integração receberá números e códigos simulados, para testar todo o caminho do webhook sem gastar saldo da carteira.

Perguntas frequentes

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

Pode. Peça um número +234 no OTP Gateway e leia o código no painel ou pela API.

Qual é o id do país da Nigéria na API da OTP Route?

Use ng como valor de country nas consultas de preço e nos pedidos de ativação.

Quanto custa receber um OTP por SMS da Nigéria?

A partir de $0.20 por código, com o valor exato dependendo do serviço e devolvido pelo endpoint de preços.

Pago se nenhum SMS chegar?

Não. Se nada chegar em 20 minutos, ou se você cancelar, o valor integral volta para a carteira.

Como devo guardar um número como 0803 123 4567?

Remova o zero inicial e salve como +2348031234567, a forma E.164 sem espaços.

Posso usar esses números em qualquer conta?

Apenas nos seus próprios produtos e contas legítimos. Siga os termos de cada serviço e a Política de Uso Aceitável da OTP Route; alguns serviços rejeitam números virtuais de vez.

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.