Códigos de verificación de Paraguay (+595), primero la API

¿Cómo pido un número +595 desde el código?

Empieza en la consola de desarrolladores y crea una clave Bearer; las claves empiezan por or_live_ y puedes tener hasta 10, lo que facilita separar claves para staging y CI. Todas las llamadas van a https://otproute.com/api/v1.

1. Guarda en caché el catálogo de GET /api/v1/services y GET /api/v1/countries. Paraguay aparece como py.
2. Antes de cada pedido, lee GET /api/v1/prices?country=py&service=<id>. El precio y la disponibilidad son valores en vivo, no constantes.
3. Pide con POST /api/v1/activations y {"service": "whatsapp", "country": "py"}. Guarda el id de activación de la respuesta.
4. Envía el número en el flujo que estás probando.
5. Espera el webhook o consulta GET /api/v1/activations/{id}; llama a POST /api/v1/activations/{id}/cancel si la prueba se detiene antes de tiempo.

GET /api/v1/balance es útil como paso previo en un pipeline, para que un trabajo falle con claridad ante un monedero vacío en lugar de agotar el tiempo de espera. La guía de integración recorre las mismas llamadas con más contexto.

¿Qué debe hacer el manejador de webhook con un código paraguayo?

Tu endpoint recibe activation.sms_received cuando llega el mensaje, activation.expired cuando la ventana se cierra vacía y activation.cancelled tras una cancelación. Cada uno está ligado al id de activación.

• Verifica primero. Separa X-OTPRoute-Signature en t y v1, calcula HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar de la solicitud con el secreto del endpoint, y compara en tiempo constante.
• Rechaza las solicitudes obsoletas. Una marca de tiempo muy alejada de tu reloj indica una repetición o un servidor con desfase.
• Sé idempotente. Guarda el id de activación e ignora las repeticiones, para que una entrega reintentada nunca procese un código dos veces.

Se permiten hasta 5 endpoints de webhook por cuenta. Si prefieres el polling, mantén un intervalo moderado; el límite es de 300 solicitudes por minuto en toda la cuenta. La guía de webhooks con HMAC trae una lista de comprobación más completa.

¿Qué servicios están abiertos en las rutas de Paraguay?

Paraguay ofrece actualmente más de 1.600 servicios. Entre los más solicitados están WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix y ChatGPT (OpenAI). WhatsApp es el mensajero cotidiano de mucha gente en la región, por lo que suele ser el primer servicio que los equipos verifican al probar soporte basado en chat.

¿Cómo se escriben y normalizan los móviles +595?

Paraguay usa un prefijo troncal 0 para la marcación nacional, así que un móvil visto a nivel local empieza por 09. En E.164 ese 0 desaparece: la forma canónica es +595 seguido de nueve dígitos, con móviles que empiezan por 9. Normaliza al ingresar, guarda solo la forma E.164 y da formato para mostrar en el borde. Las reglas de validación que esperan una longitud fija de otro país son una causa habitual de que los usuarios paraguayos fallen al registrarse, así que incluye un número +595 en tus casos de prueba de validación.

El español y el guaraní son ambos idiomas oficiales. Los mensajes de verificación de los servicios internacionales suelen llegar en español o en inglés según la plantilla y la configuración de la cuenta. Analiza el código con un patrón de solo dígitos y mantén los cuerpos de los mensajes en UTF-8 para que las tildes y la ñ sobrevivan al registro en logs.

¿Por qué los equipos verifican cuentas en Paraguay?

Paraguay forma parte del Mercosur y está entre Argentina, Brasil y Bolivia, así que las empresas que ya operan en la región suelen añadirlo a un despliegue sudamericano. Entre los motivos típicos para probar allí están el QA de localización al español para una audiencia paraguaya, confirmar que un flujo de onboarding regional acepta números +595, equipos de operaciones que verifican perfiles de empresa para clientes locales y soporte para paraguayos en el extranjero que se registran con números de su país. La página de verificación para apps móviles describe cómo encajan estas comprobaciones en las pruebas de lanzamiento.

¿Hay una forma sin código de obtener un número de verificación de Paraguay?

Sí. En el panel, abre el OTP Gateway, elige Paraguay y un servicio, revisa el precio y confirma. Copia el número en la app y deja la activación abierta hasta que el código aparezca junto a ella. Los pedidos desde el navegador y desde la API usan el mismo monedero e historial.

¿Qué ayuda cuando un código +595 no aparece?

Da a la activación la ventana completa de 20 minutos antes de sacar conclusiones. Si se cierra vacía, el cargo vuelve automáticamente. Luego repasa las causas habituales: el servicio puede rechazar números virtuales, la ruta puede estar congestionada a esa hora, o una ruta de servicio distinta puede funcionar más tarde. No lances pedidos repetidos en un bucle cerrado; añade un retroceso entre intentos y registra los ids de activación para detectar patrones por servicio.

¿Puedo conservar un número paraguayo a largo plazo y cómo se factura?

Las líneas de largo plazo no se venden en autoservicio para Paraguay. Los Números Virtuales Dedicados existen solo en Estados Unidos y Canadá, desde $1.95/mes, por lo que una cuenta que debe seguir iniciando sesión suele alojarse en uno de ellos. Para preguntar por una línea paraguaya de largo plazo, escribe a [email protected]; la respuesta depende de la normativa local.

La facturación usa un único monedero prepago en USD: recarga con tarjeta o USDT/USDC, recibe una factura en PDF por correo y paga solo por los códigos que llegan. Las cuentas de desarrollo pueden pasarse a sandbox bajo petición para recibir números y códigos simulados. OTP Route es para probar y operar tus propios productos legítimos; respeta los términos de cada servicio y la Política de Uso Aceptable.

Preguntas frecuentes

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

Es py. Úsalo en la consulta de precios y en el cuerpo de POST /api/v1/activations.

¿Guardo los números paraguayos con el prefijo 09?

No. Quita el 0 nacional y guarda +595 seguido del número nacional de nueve dígitos.

¿Cuánto cuesta un número +595 para pruebas?

Una activación de Paraguay cuesta desde $0.20 por código según el servicio, y el monedero solo se debita por un código que realmente llega.

¿Puedo probar un flujo de registro en español para Paraguay sin una SIM local?

Sí. Pide un número de verificación de Paraguay en el OTP Gateway y lee el código en el panel o mediante la API.

¿Llegarán los códigos en guaraní?

Rara vez, si acaso. Los servicios internacionales suelen enviar texto en español o inglés, así que analiza solo los dígitos.

¿Qué pasa con mi dinero si la activación caduca?

Cuando no llega ningún SMS dentro de la ventana de 20 minutos, el importe completo vuelve automáticamente a tu monedero.

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.