Números de verificación marfileños +225 para QA, lanzamientos y operaciones regionales

¿Qué cambió en los números de teléfono marfileños y cómo se deben guardar?

Costa de Marfil pasó de números de abonado de ocho dígitos a diez a principios de 2021, así que los datos de prueba y las reglas de validación escritos antes de esa fecha son una fuente habitual de fallos silenciosos. Un número nacional actual tiene diez dígitos, y los móviles empiezan por 01, 05 o 07.

El detalle que pilla desprevenidos a los ingenieros: ese cero inicial no es un prefijo troncal. Forma parte del número de abonado y se mantiene en la forma internacional, de modo que un móvil marfileño se ve como +225 07 xx xx xx xx en E.164.

• Guarda la cadena completa, +225 más los diez dígitos, y añade espacios solo al mostrarla.
• Desactiva cualquier regla genérica que elimine un cero inicial en entradas +225; produce un valor de nueve dígitos que ninguna red enrutará.
• Trata una entrada de ocho dígitos como heredada y pide al usuario que la vuelva a introducir en lugar de adivinar el prefijo que falta.
• Mantén actualizada tu biblioteca de números de teléfono, porque los metadatos del plan de numeración de África Occidental cambian de vez en cuando.

¿Por qué los equipos de producto y QA prueban con números +225?

Abiyán es el centro comercial del África Occidental francófona, lo que hace de Costa de Marfil una primera parada frecuente cuando una empresa se expande a la parte francófona de la región. Motivos típicos para incluir un número +225 para pruebas en el plan:

• Lanzamiento de mercado: confirmar que el registro, el acceso y la recuperación funcionan de extremo a extremo con un número local antes de que arranque el marketing.
• QA de localización: el francés es el idioma oficial, así que los textos de verificación de apps globales suelen llegar en francés, o en inglés cuando la configuración regional de la cuenta lo indica. Analiza los dígitos en lugar de buscar una frase fija.
• Onboarding de monederos y pagos: el dinero móvil está muy extendido, y muchos productos financieros tratan el número de teléfono como la identidad principal del cliente. La guía de onboarding fintech cubre ese patrón.
• Operaciones regionales: los equipos que dan soporte a mercados vecinos como Senegal suelen ejecutar sus comprobaciones marfileñas desde la misma batería de pruebas.

¿Qué servicios pueden entregar un código a un número marfileño?

El catálogo en vivo de Costa de Marfil lista más de 800 servicios. Entre las rutas populares de la captura actual figuran WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal y Viber.

El inventario cambia a lo largo del día, así que toma cualquier lista como punto de partida y pregunta a la API qué se puede pedir ahora mismo. El precio de un par concreto también puede variar de un servicio a otro, y por eso se cotiza en vivo en lugar de imprimirse en una tabla.

¿Cómo es en la práctica el flujo de la API OTP de Costa de Marfil?

Apunta tu cliente HTTP a https://otproute.com/api/v1 y autentícate con una clave Bearer or_live_ de la consola de desarrolladores; para los pedidos marfileños el id de país es ci.

Una ejecución de pruebas suele empezar con GET /api/v1/balance, para que un monedero agotado haga fallar el trabajo desde el principio. Después, GET /api/v1/prices?country=ci&service=<id> confirma el precio actual y si hay disponibilidad para ese par. El pedido en sí es POST /api/v1/activations con un cuerpo como {"service": "whatsapp", "country": "ci"}; la respuesta trae un id de activación y el número +225 que debes escribir en tu propia app.

A partir de ahí puedes consultar GET /api/v1/activations/{id} o, mejor para baterías en paralelo, suscribir un webhook a activation.sms_received, activation.expired y activation.cancelled. Cada entrega va firmada en la cabecera X-OTPRoute-Signature (t=<unix>,v1=<hex>): recalcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compara en tiempo constante y descarta las marcas de tiempo antiguas. El recorrido por HMAC y la documentación de la API profundizan más. El límite es de 300 solicitudes por minuto por cuenta, de sobra para un arnés de pruebas de API de verificación por SMS.

¿Puede pedir un número +225 alguien que no programa?

Sí. El personal de operaciones y las agencias suelen preferir el panel, que sigue las mismas reglas de enrutamiento OTP que la API.

1. Crea una cuenta en registro con tu correo y un código de 6 dígitos, o con Google.
2. Añade fondos al monedero en USD.
3. Elige Costa de Marfil y luego el servicio que verificas; el precio aparece antes de confirmar.
4. Copia el número en el campo de teléfono de la app y solicita el código.
5. El SMS aparece en la tarjeta de la activación en cuanto se recibe.

La activación permanece abierta 20 minutos. Si no llega nada, o cancelas antes, el importe completo se devuelve automáticamente al monedero.

¿Qué probar cuando no llega un código marfileño?

Los códigos que no llegan suelen tener una causa ordinaria, así que repasa esto antes de escalar:

• Algunos servicios rechazan los números virtuales para ciertos países o tipos de cuenta; el reembolso existe justo para ese caso.
• Deja que termine la ventana de 20 minutos en lugar de cancelar al minuto, ya que algunos remitentes ponen los mensajes en cola.
• Inténtalo de nuevo más tarde, o con el mismo servicio en la ruta de otro país si tu prueba lo permite.
• No repitas pedidos cada pocos segundos; espaciar los reintentos protege tanto tu monedero como la ruta.

Respeta siempre los términos de cada servicio; la Política de Uso Aceptable de OTP Route se aplica a cada pedido.

¿Hay una línea marfileña de larga duración y cómo funciona la facturación?

No hay un número de larga duración en autoservicio para Costa de Marfil. Las líneas dedicadas son un producto de EE. UU. y Canadá desde $1.95/month; si tu equipo necesita una línea marfileña duradera, escribe a [email protected] para consultarlo, sabiendo que la disponibilidad depende de la normativa local y puede no ser posible.

La facturación es de pago por uso desde un único monedero prepago en USD, sin cuota mensual y sin plan que elegir. Los presupuestos de pruebas marfileños se pueden cargar con tarjeta o en USDT/USDC, y la factura en PDF que sigue a cada depósito llega a la bandeja de entrada del titular de la cuenta. Para el trabajo de integración, una cuenta de desarrollo puede pasar a sandbox bajo petición, de modo que todo el flujo devuelva números y códigos simulados sin tocar los fondos del monedero. Las tarifas vigentes están en la página de precios.

Preguntas frecuentes

¿Puedo probar el registro marfileño de mi app sin una SIM local?

Sí. Pide un número +225 para el servicio que pruebas en el OTP Gateway, introdúcelo en tu formulario de registro y lee el código en el panel o a través de la API.

¿Debo quitar el cero después de +225 al guardar un número?

No. Desde el cambio de 2021, el cero inicial forma parte del número marfileño de diez dígitos y debe conservarse en el almacenamiento E.164.

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

Es ci. Úsalo en el campo country al llamar a POST /api/v1/activations o al consultar precios.

¿Me cobran si el código marfileño nunca llega?

No. Solo pagas cuando llega el código; una activación caducada o cancelada se reembolsa por completo a tu monedero.

¿En qué idioma estará el SMS de verificación?

Lo decide el servicio remitente, pero el francés y el inglés son los más habituales en cuentas marfileñas, así que extrae el código numérico en lugar de buscar texto.

¿Puedo conservar el mismo número +225 para futuros inicios de sesión?

No como producto de autoservicio, porque cada número del OTP Gateway cubre un solo código. Los números dedicados de larga duración solo se ofrecen al instante en EE. UU. y Canadá; para Costa de Marfil puedes escribir a soporte para consultarlo.

¿Cómo evito gastar fondos del monedero mientras construyo la integración?

Pide el modo sandbox en una cuenta de desarrollo. Devuelve números y códigos simulados para que pruebes webhooks y consultas de extremo a extremo.

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.