Cómo automatizar la verificación SMS +260 en pruebas de registro en Zambia

¿A qué endpoints llama una integración con la API OTP de Zambia?

La integración es una cadena corta de llamadas HTTPS a https://otproute.com/api/v1, cada una con Authorization: Bearer y una clave con el prefijo or_live_. El id de país de Zambia es zm.

• GET /api/v1/countries y GET /api/v1/services: datos de referencia, que se pueden guardar en caché durante un día.
• GET /api/v1/prices?country=zm&service=<id>: precio en vivo y si esa ruta puede aceptar un pedido ahora mismo.
• POST /api/v1/activations con {"service": "whatsapp", "country": "zm"}: devuelve el id de activación y un número +260.
• GET /api/v1/activations/{id}: estado y, una vez recibido, el código.
• POST /api/v1/activations/{id}/cancel: devuelve el número antes de tiempo.
• GET /api/v1/balance: ejecútalo primero para que una suite de pruebas se detenga rápido con un monedero vacío.

Genera las claves en la consola de desarrolladores, hasta 10 por cuenta; una por entorno es un patrón ordenado. El límite de la cuenta es de 300 solicitudes por minuto. Los esquemas completos están en la documentación de la API.

¿Cómo se debe escribir el webhook que recibe los códigos +260?

El polling funciona, pero cuando se ejecutan varias activaciones a la vez un webhook es más limpio. Añade hasta 5 endpoints en la consola de desarrolladores y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>. Construye la cadena <t>.<raw body>, calcula el HMAC-SHA256 con el secreto del endpoint y compáralo con v1 en tiempo constante. Usa los bytes sin procesar tal como se recibieron, rechaza las marcas de tiempo con más de unos pocos minutos de antigüedad y guarda los resultados con el id de activación como clave para que una entrega reintentada no cambie nada. Responde rápido con un 2xx y haz el trabajo lento después. Nuestra guía sobre cómo proteger los webhooks OTP con HMAC tiene más detalle, y pruebas de SMS OTP en pipelines de CI muestra dónde encaja esto en una compilación.

¿De qué servicios puede recibir códigos un número de verificación de Zambia?

La instantánea en vivo sitúa a Zambia en más de 1,100 servicios. Entre ellos: WhatsApp, Facebook, Google (Gmail y YouTube), Telegram, Instagram, TikTok, X (Twitter), LinkedIn, Uber, imo, Microsoft y Outlook, Amazon y Netflix. Como las rutas cambian hora a hora, deja que el endpoint de precios le diga a tu código qué está abierto antes de pedir.

Formato de los números de Zambia y los idiomas en que llegan los códigos

Los números de Zambia se marcan a nivel nacional con un 0 troncal y luego nueve dígitos. En formato internacional el cero desaparece, dando +260 seguido de nueve dígitos. Normaliza todo a esa forma E.164 antes de guardar, y asegúrate de que tu campo de entrada acepte tanto el estilo local que los usuarios escriben realmente como el internacional.

El inglés es el idioma oficial, y lenguas como el bemba, el nyanja, el tonga y el lozi se hablan ampliamente. El SMS de verificación normalmente llega en inglés, lo que simplifica el análisis, pero aun así busca por dígitos para que un cambio de redacción del remitente no rompa tus pruebas.

Los equipos prueban con Zambia cuando se expanden por el África austral, construyen el onboarding de productos de dinero móvil o de préstamos, o dan soporte a clientes desde un centro de operaciones regional. La página de onboarding fintech cubre ese escenario.

¿Se puede hacer lo mismo desde el panel?

Sí, y resulta práctico para comprobaciones puntuales. Inicia sesión, abre el OTP Gateway, elige el servicio y Zambia, mira el precio mostrado y haz el pedido. Introduce el número +260 en la app; el código aparece en el panel cuando llega. Cancela una activación que ya no quieras y su importe vuelve al monedero.

¿Y si el código no llega, y cuándo es mejor una línea dedicada?

Las activaciones duran 20 minutos y solo pagas cuando llega el código. Si la ventana caduca o cancelas, el importe completo se devuelve automáticamente. Algunos servicios rechazan los números virtuales, que es la razón del reembolso. Cuando un código +260 tarda: espera a que termine la ventana, inténtalo de nuevo más tarde o con otra ruta de servicio, comprueba que el servicio acepta números virtuales y evita volver a pedir en un bucle rápido.

Para una cuenta que tiene que volver a iniciar sesión o recuperar el acceso más adelante, un número de un solo uso es la herramienta equivocada. Los Números Virtuales Dedicados cumplen ese papel, pero solo en Estados Unidos y Canadá, desde $1.95/mes. OTP Route no tiene una línea zambiana de larga duración en autoservicio; si tienes una necesidad real, escribe a [email protected], teniendo en cuenta que decide la normativa local y no hay nada asegurado.

Usa los números solo para tus propios productos y cuentas legítimos, sigue las condiciones de cada servicio y recuerda que se aplica la Política de Uso Aceptable de OTP Route.

¿Cómo se factura y se prueba con seguridad una integración con Zambia?

Un único monedero prepago en USD lo financia todo; no hay cuota mensual ni plan. Recarga con tarjeta o con USDT/USDC y recibe una factura en PDF por correo cada vez. Mientras desarrollas, solicita el modo sandbox para tu cuenta de desarrollo: los números y códigos simulados te permiten ensayar todo el recorrido del enrutamiento OTP sin gasto del monedero. Las tarifas vigentes están en la página de precios.

Preguntas frecuentes

¿Qué id de país usa OTP Route para Zambia?

zm, como en POST /api/v1/activations con {"service": "telegram", "country": "zm"}.

¿Puedo recibir códigos SMS OTP de Zambia sin una tarjeta SIM zambiana?

Sí. El OTP Gateway proporciona un número +260 para pruebas, y el código te llega al panel, por webhook o mediante polling.

¿Cómo guardo correctamente los números +260?

Quita el 0 troncal nacional y guarda +260 más nueve dígitos en E.164. Aplica el formato para mostrarlo por separado.

¿Se reembolsa el dinero si WhatsApp u otro servicio rechaza el número?

Sí. Cuando no llega ningún código en 20 minutos, o cancelas, el importe se abona de vuelta a tu monedero automáticamente.

¿Puedo conservar un número de Zambia para futuros inicios de sesión?

No en autoservicio. Los números de larga duración son un producto de EE. UU. y Canadá; escribe a [email protected] para consultar sobre Zambia, sin ninguna promesa.

¿Puedo probar la integración antes de pagar códigos reales?

Sí. Pide el modo sandbox en una cuenta de desarrollo para obtener números y códigos simulados en pruebas 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.