¿Un solo uso o largo plazo? Cómo elegir una ruta +1 787 para pruebas de verificación

¿Debería un proyecto en Puerto Rico usar el OTP Gateway o un Dedicated Number?

Empieza por cuánto tiempo tiene que vivir el número. El OTP Gateway asigna un número +1 787 para un único código, lo cual es ideal para una prueba de registro, una comprobación de localización o un trabajo de CI que verifica una vez y sigue adelante. Un Dedicated Number es una línea que conservas, adecuada para una cuenta de staging que debe volver a iniciar sesión la semana próxima o para un buzón de soporte compartido.

En el caso de Puerto Rico la elección viene prácticamente hecha. Aunque la isla es un territorio de EE. UU., sus números no forman parte del inventario de Dedicated Numbers de autoservicio; ese producto cubre Estados Unidos y Canadá, desde $1.95/mes. Si una línea del territorio continental de EE. UU. es aceptable para una cuenta recurrente, la página de números virtuales explica las opciones. Si necesitas específicamente una línea puertorriqueña de largo plazo, escribe a [email protected]; que pueda gestionarse depende de la normativa local y no está asegurado.

¿Qué llamadas de la API OTP de Puerto Rico crean y leen una activación?

La API está en https://otproute.com/api/v1 y espera claves Bearer con el prefijo or_live_. El id de país de Puerto Rico es pr.

1. Obtén los ids con GET /api/v1/services y GET /api/v1/countries, y guárdalos en caché por despliegue.
2. Consulta el precio: GET /api/v1/prices?country=pr&service=<id> devuelve la cifra actual e indica si una ruta está abierta.
3. Haz el pedido con POST /api/v1/activations, con el cuerpo {"service": "<id>", "country": "pr"}.
4. Introduce el número devuelto en el flujo que estás probando.
5. Recibe el código mediante activation.sms_received en tu webhook, o consulta GET /api/v1/activations/{id}.
6. Cancela con POST /api/v1/activations/{id}/cancel si el trabajo se detiene antes de tiempo.

Las llamadas del webhook llevan X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcula HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint, compara en tiempo constante, rechaza marcas de tiempo antiguas e ignora los eventos repetidos de un id de activación que ya hayas procesado. Cada cuenta dispone de 10 claves, 5 endpoints de webhook y 300 solicitudes por minuto. La guía de integración de la API OTP profundiza más.

¿Por qué los números +1 787 y +1 939 dan problemas en los formularios?

Puerto Rico pertenece al Plan de Numeración de América del Norte, así que sus números se parecen a los de cualquier número de EE. UU.: código de país 1, un código de área de tres dígitos (787 o el solapado 939) y siete dígitos, escritos en E.164 como +1787 o +1939 más siete dígitos.

Ese parecido causa errores reales. Algunas apps listan Puerto Rico como país propio con el código ISO PR, otras lo fusionan con Estados Unidos, y los formularios de dirección pueden esperar PR como valor de estado. Confirma que tu selector de país, tu validador de teléfono y tus campos de dirección coinciden entre sí, y que a un usuario que selecciona Puerto Rico nunca se le diga que su número +1 no es válido. Guarda los números en E.164 y deduce la región a partir del código de área, no del +1 inicial.

¿Qué servicios pueden recibir códigos SMS OTP de Puerto Rico?

La ruta de Puerto Rico incluye actualmente más de 900 servicios. Entre los remitentes populares están WhatsApp, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Amazon, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Discord, Airbnb, Netflix y Telegram. La disponibilidad cambia a lo largo del día, así que confía en la respuesta de la API en el momento del pedido antes que en cualquier lista.

Sin código, abre el OTP Gateway en el panel, elige Puerto Rico y un servicio, confirma el precio mostrado y haz el pedido. El número de verificación de Puerto Rico aparece con su cuenta atrás, y el código se muestra a su lado cuando llega el SMS.

¿Qué hago si el código no aparece en 20 minutos?

Cada activación dura 20 minutos y solo pagas cuando llega un código. Si la ventana expira vacía, o cancelas, el importe completo se devuelve automáticamente a la billetera.

Si los códigos puertorriqueños no llegan:

• Da a la activación su ventana completa antes de marcar la prueba como fallida.
• Inténtalo de nuevo un poco más tarde, o elige otra ruta de servicio.
• Confirma que el servicio acepta números virtuales; algunos los rechazan, y el reembolso está ahí para absorber ese caso.
• No lances pedidos nuevos en un bucle cerrado; añade un backoff exponencial entre intentos.

Para patrones más amplios, lee cómo reducir las entregas de OTP fallidas.

¿Por qué los equipos verifican flujos en español y en inglés para Puerto Rico?

El español y el inglés son idiomas oficiales, y el español es el que más usan a diario la mayoría de los residentes. Eso hace de Puerto Rico un lugar práctico para comprobar un onboarding bilingüe: ¿llega el SMS de verificación en español cuando la app está configurada en español?, ¿la pantalla de introducción del código admite texto con acentos?, ¿se envía la plantilla correcta cuando un usuario cambia de idioma a mitad del flujo? La isla usa el dólar estadounidense y muchas empresas de EE. UU. ya la atienden, así que las apps de pagos, las plataformas de reparto, los marketplaces y los bancos que amplían un lanzamiento en EE. UU. suelen necesitar un número +1 787 para pruebas. Haz estas comprobaciones en cuentas que controles, respeta los términos de cada servicio y mantente dentro de la Política de Uso Aceptable de OTP Route. Para automatizarlas, consulta las pruebas en CI/CD.

¿Cómo funcionan la billetera y el sandbox en las pruebas de Puerto Rico?

No hay suscripción. Una única billetera prepago en USD financia todos los pedidos, sin cuota mensual y sin plan que elegir. Recarga con tarjeta o con USDT/USDC, y cada recarga y cada compra de número genera una factura en PDF por correo. Antes de pasar a producción, pide que tu cuenta de desarrollo se cambie a sandbox, que devuelve números y códigos simulados para ensayar el flujo completo de OTP routing sin gastar fondos. Cuando estés listo, crea una cuenta con un correo y un código de 6 dígitos o con el inicio de sesión de Google, y activa la autenticación en dos pasos TOTP para el equipo.

Preguntas frecuentes

¿Puedo probar un flujo de registro de Puerto Rico sin una SIM local?

Sí. Pide un número +1 787 al OTP Gateway, introdúcelo en tu app y recoge el código en el panel o a través de la API de verificación por SMS y los webhooks.

¿La API trata a Puerto Rico como Estados Unidos?

No. Tiene su propio id de país, pr, que usas en las consultas de precios y en las solicitudes de activación en lugar del id de EE. UU.

¿Puedo comprar un Dedicated Number +1 787?

No desde el panel. Los Dedicated Numbers de autoservicio cubren solo Estados Unidos y Canadá; para una línea puertorriqueña, escribe a [email protected] para consultarlo.

¿El SMS de verificación llegará en español?

Depende del remitente y, a menudo, del idioma configurado en la app. Si tu producto admite ambos, prueba la localización en español y en inglés.

¿Qué códigos de área puedo ver en un número de Puerto Rico?

Puerto Rico usa el 787 y el 939. Recibas el que recibas, guárdalo en E.164 para que tus registros sean coherentes.

¿Cuánto cuesta un código de verificación de Puerto Rico?

Desde $0.20 por código. El precio exacto de cada servicio sale de GET /api/v1/prices y del panel, y no se cobra nada si el código nunca llega.

¿Cuántas pruebas en paralelo puedo ejecutar?

La cuenta permite 300 solicitudes por minuto y 10 claves. La mayor parte de ese presupuesto se va en polling, así que los webhooks dejan más margen para trabajos en paralelo.

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.