Cómo montar una prueba de verificación +592 con webhooks y polling

¿Cómo diseño un flujo de API OTP de Guyana basado en webhooks?

Para cualquier cosa más allá de una comprobación puntual, deja que la plataforma te envíe los códigos en lugar de preguntar una y otra vez. En la consola de desarrolladores, añade un endpoint HTTPS (una cuenta puede tener 5) y suscríbelo a activation.sms_received, además de activation.expired y activation.cancelled, para que tu ejecutor de pruebas se entere de los callejones sin salida tan rápido como de los éxitos.

Trata cada solicitud entrante como no fiable hasta que supere la verificación:

• Lee la cabecera X-OTPRoute-Signature, que tiene el formato t=<unix>,v1=<hex>.
• Une la marca de tiempo, un punto y el cuerpo de la solicitud sin modificar, y calcula el HMAC-SHA256 de esa cadena con el secreto del endpoint.
• Compara tu digest con v1 en tiempo constante y descarta la solicitud si la marca de tiempo es antigua.
• Busca el id de la activación en el evento; si ya lo procesaste, devuelve éxito y no hagas nada más.

Esa última regla mantiene el manejador idempotente, de modo que una reentrega tras un fallo de red nunca confunda la prueba. Hay un tratamiento más largo en captura de OTP por webhook.

¿Qué endpoints e ids usa un pedido +592?

Autentícate con una clave Bearer de la consola de desarrolladores; las claves activas empiezan por or_live_ y cada cuenta puede tener hasta 10. La URL base es https://otproute.com/api/v1, y el id de país de Guyana es gy.

Una ejecución típica consulta primero GET /api/v1/prices?country=gy&service=<id>, porque el precio y la disponibilidad de esta ruta son valores en directo y no constantes. Después envía POST /api/v1/activations con {"service": "<id>", "country": "gy"} y recibe un número +592 junto con un id de activación. Sin webhook, el ejecutor hace polling a GET /api/v1/activations/{id} cada pocos segundos, muy por debajo del tope de 300 solicitudes por minuto. Un paso de limpieza llama a POST /api/v1/activations/{id}/cancel cuando la prueba se aborta, y una llamada previa a GET /api/v1/balance detiene la suite pronto si el monedero está bajo. Los ids de servicio salen de GET /api/v1/services; el centro para desarrolladores tiene ejemplos de cliente para esta API de verificación por SMS.

¿Cómo se formatean los números +592 para guardarlos?

Guyana usa el código de país 592 y números nacionales de siete dígitos sin prefijo troncal que eliminar, así que la forma E.164 es simplemente +592 seguido de esos siete dígitos. La gente suele escribir los dígitos en un grupo de tres y otro de cuatro.

Sin un cero inicial que quitar, la normalización se reduce a borrar espacios y guiones y añadir el código de país cuando el usuario escribe solo los dígitos locales. Un error frecuente es un formulario que supone que todo número sudamericano tiene prefijo de área, o que fija una longitud mínima superior a siete dígitos, y así rechaza entradas guyanesas válidas. Un número +592 para pruebas lo deja al descubierto enseguida. Guarda la cadena E.164 y aplica el formato local solo al mostrarla.

¿Qué servicios pueden recibir códigos SMS OTP de Guyana, y puedo pedirlos manualmente?

La ruta de Guyana lista más de 900 servicios. Entre los más solicitados están WhatsApp, Facebook, Instagram, Google (Gmail y YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft y Outlook, Discord, Netflix y Claude. Esa lista es una instantánea del catálogo en directo, así que confirma a través de la API o del panel antes de planificar una prueba en torno a un remitente concreto.

Para los compañeros que no escriben código, el panel hace el mismo trabajo. Inicia sesión, abre el OTP Gateway, elige Guyana y un servicio, revisa el precio y haz el pedido. El número de verificación de Guyana aparece junto a una cuenta atrás de 20 minutos, y el código se muestra a su lado cuando llega.

¿Qué debe hacer una prueba cuando el código +592 se retrasa o no llega?

Una activación permanece abierta 20 minutos. Solo pagas si el código llega dentro de esa ventana; si caduca o la cancelas, el importe completo vuelve al monedero sin ningún ticket de soporte.

Un manejo razonable en una ejecución automatizada:

1. Espera a que termine la ventana antes de dar la prueba por fallida, salvo que tu test tenga un límite de tiempo estricto; en ese caso, cancela de forma explícita.
2. Reintenta más tarde, o cambia a otra ruta de servicio si la API la ofrece.
3. Comprueba si el servicio de destino acepta números virtuales; algunos los rechazan, y el reembolso cubre exactamente ese caso.
4. Espacia los reintentos con una espera progresiva en lugar de repetir pedidos en un bucle cerrado.

La guía sobre el enrutamiento de OTP por país explica cómo elegir rutas alternativas.

¿Por qué los equipos prueban los flujos de registro en Guyana?

Guyana es el único país sudamericano con el inglés como idioma oficial, y Georgetown alberga la Secretaría de la CARICOM, por lo que a menudo aparece en lanzamientos que tratan a la Comunidad del Caribe como un único mercado. Un sector energético marino en rápido crecimiento ha atraído a contratistas y proveedores internacionales, mientras que una gran diáspora en Estados Unidos, Canadá y el Reino Unido mantiene activas con números +592 las apps de remesas, mensajería y viajes. El criollo guyanés se habla ampliamente en el día a día, pero los textos de verificación suelen llegar en inglés. Para QA, eso orienta el esfuerzo hacia la introducción del número, los selectores de país y la redacción del consentimiento de SMS, más que hacia textos traducidos. Mantén cada comprobación en cuentas que tu organización posea, respeta los términos de cada servicio y recuerda que la Política de Uso Aceptable de OTP Route cubre todos los pedidos.

¿Puedo conservar una línea de Guyana y cómo se factura el uso?

No se ofrecen números de largo plazo de autoservicio para Guyana. Los Números Dedicados de OTP Route cubren solo Estados Unidos y Canadá, desde $1.95/mes. Para una línea +592, escribe a [email protected] y el equipo comprobará qué permite la normativa local, sin ninguna promesa.

El pago se hace con un único monedero prepago en USD: sin cuota mensual, sin plan, recargas con tarjeta o USDT/USDC, y una factura en PDF por correo por cada una. Una cuenta de desarrollo puede pasarse a sandbox bajo petición, de modo que las pruebas de integración se ejecuten con números y códigos simulados y no toquen el saldo. Las tarifas por servicio aparecen en la página de precios.

Preguntas frecuentes

¿Puedo probar el registro de mi app en Guyana sin una SIM de un operador guyanés?

Sí. Pide un número +592 en el OTP Gateway para tu servicio, introdúcelo en tu flujo y el código aparece en el panel o llega a tu webhook. Los precios empiezan en $0.20 por código.

¿Qué id de país usa la API para Guyana?

Es gy, que se usa tanto en la consulta de precios como en el cuerpo de la solicitud de activación.

¿Tengo que quitar un cero inicial de los números de Guyana?

No. Guyana no tiene prefijo troncal, así que la forma E.164 es +592 seguido del número de siete dígitos.

¿En qué idioma llegan los mensajes de verificación +592?

Normalmente en inglés, el idioma oficial. Aun así, el remitente controla la redacción y puede seguir el idioma configurado en la app.

¿Hay reembolso si el servicio nunca envía el SMS?

Sí, y es automático. Si pasan 20 minutos sin código, o cancelas, el importe completo vuelve a tu monedero.

¿Puedo probar toda la integración sin gastar dinero?

Pide a soporte que pase tu cuenta de desarrollo a sandbox. Devuelve números y códigos simulados, así que las llamadas a la API y los webhooks se pueden ejercitar de principio a fin.

¿Hay un número +592 de largo plazo disponible?

No como producto de autoservicio. Los Números Dedicados se venden solo en Estados Unidos y Canadá; escribe a [email protected] para preguntar por Guyana.

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.