API de verificación por SMS de Nigeria (+234) para equipos de QA, fintech y lanzamiento

¿Qué endpoints debo llamar para recibir un OTP nigeriano?

Todo vive bajo https://otproute.com/api/v1 y se autentica con una clave Bearer que empieza por or_live_. El id de país de Nigeria es ng. Una integración típica hace cuatro llamadas:

1. GET /api/v1/prices?country=ng&service=<id> para confirmar el precio actual antes de comprometerte.
2. POST /api/v1/activations con {"service": "<id>", "country": "ng"} para reservar un número +234. Guarda el id de activación devuelto; cada llamada posterior y cada evento de webhook se identifica con él.
3. GET /api/v1/activations/{id} para leer el estado y, una vez entregado, el código.
4. POST /api/v1/activations/{id}/cancel si tu prueba falla antes de tiempo y ya no necesitas el número.

GET /api/v1/balance resulta útil como comprobación previa en CI, de modo que una suite nocturna falle rápido si el monedero está bajo. La guía de integración de la API de OTP recorre la misma secuencia con manejo de errores.

¿Una suite de pruebas en Lagos debe hacer polling o usar webhooks?

El polling basta para unas pocas ejecuciones manuales. Cuando un pipeline pide varios números +234 en paralelo, los webhooks son más limpios. Registra uno de tus cinco endpoints en la consola de desarrolladores y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud incluye X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcula HMAC-SHA256 sobre la marca de tiempo, un punto y el cuerpo sin procesar usando el secreto de tu endpoint, compara en tiempo constante y descarta la solicitud si la marca de tiempo es antigua. Guarda los ids de activación ya procesados para que un evento reenviado no dispare tu prueba dos veces. El artículo sobre cómo proteger los webhooks de OTP con HMAC trae una lista de comprobación más completa. Mantén el tráfico total por debajo de 300 solicitudes por minuto y cuenta, algo holgado si te apoyas en eventos y no en polling intensivo.

¿Qué servicios están disponibles en las rutas +234?

La ruta ng lista actualmente más de 2.700 servicios. Entre los más solicitados están WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon y ChatGPT (OpenAI). El inventario cambia a lo largo del día según nuestros socios de operadores actualizan su oferta, así que consulta la disponibilidad en vivo en lugar de suponer que un servicio visto ayer sigue ahí.

¿Por qué los equipos necesitan un número de verificación de Nigeria?

Nigeria es uno de los mercados de fintech y apps de consumo más activos de África, y muchos productos tratan el número de teléfono como identidad principal. Eso convierte el paso del SMS en una parte crítica del onboarding de billeteras, apps de préstamos, transporte, reparto y redes sociales. Los equipos fuera del país usan un número +234 para pruebas y así confirmar que el flujo de registro, el temporizador de reenvío y los textos de error se comportan como lo haría con un usuario local.

El inglés es el idioma oficial, por lo que los mensajes de verificación suelen llegar en inglés, lo que simplifica la lógica de aserciones en las pruebas automatizadas. Los equipos de fintech, en particular, deberían ver la página de onboarding fintech para entender cómo encaja con las verificaciones de identidad que OTP Route no sustituye.

¿Cómo se escriben los números móviles nigerianos?

El código de país es +234 y el prefijo troncal es 0. Los nigerianos suelen escribir un móvil con once dígitos que empiezan por cero, como 0803 123 4567; en formato internacional el cero desaparece y queda +234 803 123 4567. Guarda el valor en E.164 (+234803...), acepta el formato local de once dígitos al ingresarlo y elimina el 0 inicial antes de guardar. Un validador que solo comprueba la longitud total aceptará sin problema +2340803..., una causa frecuente de envíos fallidos en producción.

¿Puedo pedir un número nigeriano desde el panel?

Sí. Regístrate con un código por correo o con Google, añade fondos al monedero, abre el OTP Gateway, elige Nigeria y el servicio, y confirma el precio mostrado. El número está listo de inmediato y el código aparece junto al pedido cuando llega.

Si no llega, deja correr la ventana de 20 minutos; solo pagas si el código llega, y los pedidos vencidos o cancelados se reembolsan automáticamente. Después prueba con un pedido nuevo un poco más tarde, prueba otra ruta como Ghana si tu prueba lo permite y comprueba si el servicio rechaza números virtuales. Evita lanzar pedidos nuevos en un bucle cerrado.

¿Y las líneas nigerianas de largo plazo, la facturación y el sandbox?

OTP Route no tiene un número nigeriano de largo plazo de autoservicio. Los Números Dedicados solo se venden para Estados Unidos y Canadá, desde $1.95/mes. Para una línea +234 duradera, escribe a [email protected]; que se pueda ofrecer depende de la regulación local.

El gasto sale de un único monedero prepago en USD, sin plan ni cuota mensual. Recarga con tarjeta o con USDT/USDC y recibe una factura en PDF por cada recarga. Pide a soporte que pase una cuenta de desarrollo a modo sandbox y tu integración recibirá números y códigos simulados, para que pruebes todo el recorrido del webhook sin gastar fondos del monedero.

Preguntas frecuentes

¿Puedo probar el flujo de registro nigeriano de mi app sin una SIM local?

Sí. Pide un número +234 en el OTP Gateway y lee el código en el panel o a través de la API.

¿Cuál es el id de país de Nigeria en la API de OTP Route?

Usa ng como valor de país en las consultas de precios y en las solicitudes de activación.

¿Cuánto cuesta recibir un OTP por SMS de Nigeria?

Desde $0.20 por código; el importe exacto depende del servicio y lo devuelve el endpoint de precios.

¿Pago si no llega ningún SMS?

No. Si no llega nada en 20 minutos, o si cancelas, el importe completo vuelve al monedero.

¿Cómo debo guardar un número como 0803 123 4567?

Quita el cero inicial y guárdalo como +2348031234567, la forma E.164 sin espacios.

¿Se pueden usar estos números para cualquier cuenta?

Solo para tus propios productos y cuentas legítimos. Respeta los términos de cada servicio y la Política de Uso Aceptable de OTP Route; algunos servicios rechazan por completo los números virtuales.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.