Integrar un flujo de verificación por SMS de Egipto (+20) en la API de OTP Route

¿Qué solicitudes necesita realmente una integración con la API OTP de Egipto?

Siete endpoints lo cubren todo, todos bajo https://otproute.com/api/v1 y todos autenticados con una clave Bearer con prefijo or_live_. Genera una clave por entorno en la consola de desarrolladores; una cuenta puede tener hasta 10.

1. Carga el catálogo con GET /api/v1/services y GET /api/v1/countries. El id de país de Egipto es eg y rara vez cambia, así que guardarlo en caché es correcto.
2. Antes de cada pedido, pide GET /api/v1/prices?country=eg&service=<id> para conocer el precio y la disponibilidad actuales. La disponibilidad se mueve durante el día, así que trata esta respuesta como un dato fresco, no como configuración.
3. Crea la activación con POST /api/v1/activations y un cuerpo como {"service": "whatsapp", "country": "eg"}. Recibes un id de activación y el número +20 que debes escribir en la pantalla bajo prueba.
4. Recoge el código desde un webhook o llamando a GET /api/v1/activations/{id}.
5. Si una prueba se aborta, libera el pedido con POST /api/v1/activations/{id}/cancel para que los fondos vuelvan de inmediato.

Un rápido GET /api/v1/balance al inicio de cada suite permite a un trabajo de CI detenerse pronto en lugar de fallar a mitad. El límite es de 300 solicitudes por minuto por cuenta, lo que deja margen para consultar varias activaciones en paralelo. Los ejemplos completos de solicitudes están en la documentación para desarrolladores.

¿Cómo consumo los códigos +20 desde un webhook firmado en lugar de consultar periódicamente?

Consultar periódicamente funciona para una prueba local; un webhook encaja mejor cuando un pipeline ejecuta muchas activaciones egipcias a la vez. Añade un endpoint en la consola de desarrolladores (cinco por cuenta) y suscríbelo a activation.sms_received, además de activation.expired y activation.cancelled, para que tu trabajo sepa cuándo dejar de esperar.

Cada solicitud lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstruye la cadena <t>.<raw body>, calcula HMAC-SHA256 con el secreto del endpoint y compárala con v1 mediante una comprobación en tiempo constante. Rechaza todo lo que tenga una marca de tiempo caducada y calcula el hash de los bytes exactamente como se recibieron, no de un objeto analizado y vuelto a codificar.

Trata el id de activación como clave de idempotencia: guarda el evento una vez, ignora las repeticiones y devuelve rápido un 2xx. La guía de captura de OTP por webhook recorre una versión de este manejador respaldada por una cola.

¿Qué servicios pueden entregar códigos a un número de verificación de Egipto?

La instantánea en vivo de Egipto incluye más de 1,600 servicios en total. Entre los populares que los equipos prueban con números +20 están WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon y LinkedIn.

Esa lista es una vista en un momento dado, no una promesa. Un servicio que tiene números esta mañana puede estar escaso esta tarde, y por eso el endpoint de precios informa la disponibilidad junto con el coste. Algunos servicios también rechazan por completo los números virtuales; cuando eso ocurre, la regla de reembolso descrita más abajo te cubre.

¿Cómo debe una app guardar y validar los móviles egipcios?

Egipto usa el código de país +20 y un prefijo troncal nacional 0. A nivel local, un móvil se escribe con once dígitos que empiezan por 01, mientras que en la forma internacional el cero desaparece y siguen diez dígitos después del +20. Unos cuantos hábitos evitan la mayoría de los errores:

• Guarda solo E.164, como +201XXXXXXXXX, y da formato para mostrar en el momento de renderizar.
• Quita el cero troncal cuando un usuario escribe 01… con el país ya establecido en Egipto; de lo contrario acabas con un valor inválido +2001….
• Normaliza los dígitos. Quienes usan teclados árabes pueden escribir numerales arábigo-índicos, así que conviértelos a dígitos ASCII antes de validar y antes de comparar un OTP introducido.

El árabe es el idioma oficial, así que muchos servicios envían los códigos a los usuarios egipcios en árabe, mientras que otros usan el inglés por defecto. Si tu analizador extrae el código con una expresión regular, pruébalo tanto con cuerpos de mensaje de derecha a izquierda como con los ingleses.

¿Puede el equipo de operaciones pedir un número egipcio sin escribir código?

Sí. No toda comprobación necesita un script, y los compañeros de soporte o de crecimiento pueden usar el mismo OTP Gateway desde el navegador:

1. Regístrate con tu correo y el código de 6 dígitos, o con Google.
2. Recarga el monedero y abre el OTP Gateway.
3. Elige Egipto y el servicio; el precio se muestra antes de confirmar.
4. Copia el número +20 en la app y espera a que el código aparezca en pantalla.

La activación es idéntica a un pedido por API, así que una comprobación manual y una automatizada se comportan igual.

¿Qué pasa si el código +20 nunca aparece?

Cada activación permanece abierta durante 20 minutos. Si no llega ningún SMS en ese tiempo, o cancelas antes, el importe completo vuelve automáticamente a tu monedero, de modo que un número silencioso nunca te cuesta nada.

Cuando los códigos siguen fallando:

• Deja correr la ventana antes de decidir que falló; el tiempo de entrega depende del servicio y de la ruta.
• Confirma que el servicio acepta números virtuales. Algunos los rechazan, y ninguna elección de enrutamiento cambia eso.
• Inténtalo de nuevo un poco más tarde, o con una ruta vecina si tu prueba no depende de un número egipcio.
• Evita repetir pedidos en bucle rápido. Deja un intervalo creciente entre pedidos y conserva cada id de activación en tus registros.

Nuestras notas sobre cómo reducir las entregas fallidas de OTP profundizan en la política de reintentos.

¿Por qué prueban los equipos de producto con números egipcios?

Egipto es uno de los mercados de habla árabe más grandes, por lo que es una primera parada natural para los equipos que localizan un producto al árabe. Un número +20 real ejercita las partes que los emuladores omiten: el selector de país, el manejo del cero troncal, las plantillas de SMS en árabe y el diseño de derecha a izquierda en la pantalla de introducción del código.

Los equipos de operaciones regionales también usan el enrutamiento OTP para confirmar que un flujo de registro sigue funcionando para clientes egipcios después de una versión, y las empresas que atienden a egipcios residentes en el extranjero comprueban que un número +20 se acepta también fuera del país.

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

No existe un número de larga duración en autoservicio para Egipto. Las líneas dedicadas son un producto solo de Estados Unidos y Canadá, desde $1.95/month; si necesitas una línea egipcia continua, escribe a [email protected] y el equipo podrá decirte si es posible según la normativa local, sin promesa de que lo sea.

La facturación es un monedero prepago en USD sin cuota mensual ni plan que elegir. Los fondos entran con tarjeta o como USDT/USDC, y cada recarga va seguida de una factura en PDF enviada por correo. Mientras construyes la integración puedes pedir el modo sandbox en una cuenta de desarrollo, que devuelve números y códigos simulados sin tocar los fondos del monedero. Las tarifas actuales están en la página de precios.

Preguntas frecuentes

¿Puedo comprobar el OTP de registro egipcio de mi app sin una tarjeta SIM egipcia?

Sí. Pide un número +20 en el OTP Gateway, introdúcelo en tu formulario de registro y lee el código en el panel o desde la API, todo sin una SIM local.

¿Qué id de país usa la API de OTP Route para Egipto?

Egipto es eg. Pásalo al endpoint de precios y en el cuerpo de POST /api/v1/activations.

¿Pago por un número +20 si el SMS nunca llega?

No. Si no llega ningún código en 20 minutos, o cancelas la activación, el importe completo se devuelve automáticamente a tu monedero.

¿Debo conservar el cero inicial al guardar un móvil egipcio?

No. El 0 es un prefijo troncal nacional; quítalo y guarda el número en formato E.164 empezando por +20.

¿Puedo iniciar sesión de nuevo el mes que viene con el mismo número de prueba egipcio?

No de forma fiable. Cada número del OTP Gateway sirve para un único código de verificación, y las líneas dedicadas en autoservicio existen solo para EE. UU. y Canadá, así que planifica en consecuencia las cuentas que necesiten inicios de sesión repetidos.

¿Puedo usar números egipcios para abrir muchas cuentas en una plataforma?

No. OTP Route es para probar y operar tus propias cuentas y productos legítimos; respeta las condiciones de cada servicio y la Política de Uso Aceptable.

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.