Cómo llevar los códigos de verificación caboverdianos (+238) a tu entorno de pruebas

¿Qué endpoints intervienen en una activación +238?

Una integración de la API OTP de Cabo Verde solo necesita una lista corta de llamadas bajo https://otproute.com/api/v1. Cada solicitud lleva una clave Bearer que empieza por or_live_, generada en la consola de desarrolladores. El id de país de Cabo Verde es cv; el id de servicio es el valor api_service de la aplicación que estés probando.

1. GET /api/v1/services y GET /api/v1/countries obtienen los catálogos; guárdalos en caché durante el día.
2. GET /api/v1/prices?country=cv&service=<id> lee el precio actual e indica si hay una ruta abierta en ese momento. El inventario cambia durante el día, así que consúltalo antes de cada pedido en lugar de fijar valores en el código.
3. POST /api/v1/activations con {"service": "whatsapp", "country": "cv"} devuelve un id de activación y el número +238 que debes escribir en tu formulario de registro.
4. GET /api/v1/activations/{id} te permite sondear el código si no usas webhooks.
5. POST /api/v1/activations/{id}/cancel libera el número cuando una prueba se interrumpe, de modo que la retención vuelve al monedero.

Una llamada previa a GET /api/v1/balance permite que una batería de pruebas se detenga antes en lugar de fallar a la mitad. El límite es de 300 solicitudes por minuto por cuenta, y la referencia de la API enumera todos los campos.

¿Cómo acepto el webhook firmado de un código de Cabo Verde?

El sondeo sirve para un solo script; cuando se ejecutan varios trabajos en paralelo, un webhook es más ordenado. Registra un endpoint en la consola de desarrolladores (una cuenta puede tener cinco) y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada POST llega con un encabezado X-OTPRoute-Signature de la forma t=<unix>,v1=<hex>. Reconstruye la cadena <t>.<raw body>, fírmala con HMAC-SHA256 usando el secreto de ese endpoint y compara el resultado con v1 mediante una comparación en tiempo constante. Descarta cualquier solicitud cuya marca de tiempo tenga más de unos minutos para que una solicitud capturada no pueda reproducirse. Después, procesa todo según el id de activación: si el mismo evento llega dos veces, la segunda copia no debe cambiar nada. Nuestro artículo sobre cómo proteger webhooks OTP con HMAC cubre los casos límite.

¿Qué aplicaciones pueden enviar códigos a un número caboverdiano hoy?

El catálogo en vivo de cv cubre más de 800 servicios. Entre los populares abiertos en este momento están WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram y Netflix. Toma esa lista como una instantánea: las rutas se abren y se cierran según la capacidad de los socios, y de eso trata el enrutamiento OTP mediante una API que informa la disponibilidad en tiempo real en lugar de una página que la promete.

Si nadie del equipo programa, el panel hace el mismo trabajo. Elige el servicio, elige Cabo Verde, confirma el precio en pantalla y copia el número. El código aparece en la tarjeta de la activación cuando llega.

¿Cómo se ve un número +238 al guardarlo?

Cabo Verde usa un plan de numeración cerrado: números nacionales de siete dígitos y sin prefijo troncal, por lo que no hay un cero inicial que quitar. En E.164 un número es simplemente +238 seguido de esos siete dígitos. La normalización es, por tanto, trivial, pero la poca longitud confunde a los validadores que suponen que todo número de abonado es más largo, una causa frecuente de que un formulario rechace una entrada caboverdiana perfectamente válida. Guarda la cadena E.164, dale el formato que prefiera tu interfaz y añade un caso +238 a las pruebas unitarias de tu campo de teléfono.

El portugués es el idioma oficial, mientras que el criollo caboverdiano es lo que la mayoría habla a diario, así que comprueba cómo se muestra una plantilla OTP en portugués en un teléfono de allí. Los equipos suelen conseguir un número +238 para pruebas por la diáspora: las comunidades caboverdianas en Estados Unidos, Portugal y otras partes de Europa mantienen cuentas vinculadas a números de origen, y los productos de remesas, viajes y mensajería quieren que esos registros funcionen.

¿Qué pasa con el monedero si no llega ningún SMS en 20 minutos?

Cada activación permanece abierta durante 20 minutos. Si llega un código en esa ventana, el cargo se mantiene; si la ventana se cierra vacía, o cancelas antes, el importe completo vuelve a tu monedero sin necesidad de abrir un ticket de soporte. Cuando no llega nada:

• Deja correr la ventana en lugar de lanzar un pedido nuevo cada pocos segundos; un bucle de reintentos cerrado solo inmoviliza fondos.
• Inténtalo más tarde, o prueba el mismo flujo con otra ruta de servicio.
• Confirma que la aplicación acepta números virtuales; algunas los rechazan por política, y el reembolso existe precisamente para ese caso.
• Asegúrate de que tu formulario envió el número +238 completo y no uno truncado.

La guía para reducir las entregas fallidas de OTP profundiza en el diagnóstico.

¿Puedo conservar un número de Cabo Verde para accesos repetidos?

No de forma autoservicio. Los Números Dedicados de OTP Route, que son líneas de largo plazo con SMS entrantes y salientes, llamadas desde el navegador y reenvío por webhook, son un producto de Estados Unidos y Canadá desde $1.95/mes. No existe una línea +238 de largo plazo de autoservicio. Si tu equipo tiene una necesidad real, escribe a [email protected]; que se pueda gestionar depende de la normativa local y no está asegurado. Para una cuenta de staging que debe iniciar sesión una y otra vez, un número virtual de EE. UU. o Canadá suele ser la respuesta práctica.

¿Cómo se factura el uso y cómo se prueba antes de salir en vivo?

La facturación funciona con un único monedero prepago en USD, sin cuota mensual y sin niveles de plan. Se recarga con tarjeta o con las stablecoins USDT/USDC; cada recarga llega con una factura en PDF por correo, lo que simplifica la conciliación contable. Antes de que las claves de producción toquen el monedero, pide que cambien tu cuenta de desarrollo a sandbox: devuelve números y códigos simulados, de modo que el pedido, el webhook y la cancelación de tu cliente de la API de verificación por SMS puedan ejecutarse en CI sin gastar nada. Consulta precios y la descripción de pruebas QA. Sigue en todo momento los términos de cada servicio y la Política de Uso Aceptable de OTP Route.

Preguntas frecuentes

¿Puedo probar el registro de mi aplicación en Cabo Verde sin una SIM local?

Sí. Pide un número +238 en el OTP Gateway, introdúcelo en tu formulario de registro y lee el código en el panel, en la API o en un webhook. Nadie del equipo necesita estar en las islas.

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

Es cv. Pásalo como country en POST /api/v1/activations y en la consulta de precios.

¿Tengo que añadir un 0 antes de un número caboverdiano?

No. Cabo Verde no tiene prefijo troncal, así que la forma internacional es simplemente +238 más el número nacional de siete dígitos.

¿Cuánto cuesta un número de verificación de Cabo Verde?

Los precios del OTP Gateway empiezan desde $0.20 por código y varían según el servicio; la API y el panel muestran el precio exacto antes de pedir. Solo se te cobra si llega un código.

¿Todas las aplicaciones enviarán códigos a un número virtual caboverdiano?

No. Algunos servicios rechazan los números virtuales y las rutas cambian durante el día. Si no llega ningún código en 20 minutos, el importe se devuelve al monedero.

¿Hay un sandbox para probar la integración +238?

Sí, bajo petición. Una cuenta de desarrollo puede pasarse al modo sandbox, que devuelve números y códigos simulados para que la integración funcione de extremo a extremo sin gastar saldo.

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.