Códigos de verificación +351 programáticos para lanzamientos en Portugal

¿Qué endpoints intervienen en una verificación con un número +351?

La URL base es https://otproute.com/api/v1 y cada solicitud lleva una clave Bearer que empieza por or_live_. El id de país de Portugal es pt.

1. GET /api/v1/countries y GET /api/v1/services te dan los ids; guárdalos en caché durante cada ejecución de pruebas.
2. GET /api/v1/prices?country=pt&service=<id> devuelve el precio actual y si la ruta está abierta.
3. POST /api/v1/activations con {"service": "telegram", "country": "pt"} reserva el número y devuelve un id de activación.
4. GET /api/v1/activations/{id} informa del estado y del código, si prefieres hacer polling.
5. POST /api/v1/activations/{id}/cancel libera un número que tu prueba ya no necesita.
6. GET /api/v1/balance permite que un pipeline se detenga a tiempo cuando el saldo de la billetera es bajo.

Los límites de la cuenta son 10 claves de API, 5 endpoints de webhook y 300 solicitudes por minuto. Los esquemas completos están en la referencia de la API.

¿Cómo entregan los webhooks firmados los códigos portugueses a nuestro servicio?

Registra un endpoint HTTPS en la consola de desarrolladores y suscríbete a activation.sms_received, activation.expired y activation.cancelled. Cada POST incluye X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Para verificarlo, reconstruye la cadena <t>.<raw body>, calcula HMAC-SHA256 con el secreto del endpoint y compáralo con v1 mediante una comparación en tiempo constante. Rechaza las solicitudes con una marca de tiempo demasiado antigua, para que una petición capturada no pueda reutilizarse. Guarda el id de activación de cada evento e ignora cualquier repetición; así el handler es seguro cuando se reintentan las entregas. El patrón se explica paso a paso en captura de OTP mediante webhooks.

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

Portugal muestra más de 2,000 servicios en la instantánea actual. Entre los de uso frecuente están WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord y Signal.

El conjunto cambia a lo largo del día según nuestros socios de red (carriers) reasignan capacidad. Por eso debe ser el endpoint de precios, y no un archivo de configuración estático, el que decida si una prueba se ejecuta.

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

Portugal suele aparecer pronto en los planes de expansión por la UE. Lisboa y Oporto albergan a muchos equipos de producto e ingeniería, y numerosas empresas usan Portugal como base europea. Hay además un motivo de localización: el portugués europeo (pt-PT) se distingue del brasileño en ortografía, vocabulario y formas de tratamiento, así que un flujo traducido para Brasil puede sonar extraño a alguien en Portugal. Ejecutar una verificación real con un número +351 permite a los revisores ver juntos el texto en pt-PT, el SMS que llega y las pantallas que lo rodean.

Bajo el RGPD, mantener los números de teléfono del personal fuera de las cuentas de prueba y compartidas también es buena minimización de datos. Un número de un solo uso por comprobación significa menos identificadores personales en tus sistemas de QA. La guía de pipelines de CI muestra cómo incorporarlo a cada build.

¿Cómo se formatean y almacenan los números +351?

Portugal no tiene prefijo troncal: los números tienen nueve dígitos y se marcan igual en el ámbito nacional y en formato internacional tras +351. Los móviles empiezan por 9, mientras que los fijos geográficos empiezan por 2. Guárdalos en E.164, rechaza todo lo que no tenga nueve dígitos después del código de país y elimina los espacios que los usuarios añaden al escribir grupos de tres.

Los códigos entrantes suelen llegar en portugués o en inglés, según el remitente y el idioma configurado en la cuenta. Tu extractor de códigos debe buscar los dígitos, no una frase fija.

¿Puede un compañero hacerlo sin código y qué pasa si no llega el SMS?

En el panel, abre el OTP Gateway, elige Portugal y un servicio, comprueba el precio en vivo y haz el pedido. Pega el número en tu app y espera el código en la página de la activación.

La ventana dura 20 minutos y solo pagas si el código llega; de lo contrario, el importe completo vuelve automáticamente a la billetera. Cuando falta un código:

• Deja que termine la ventana en lugar de cancelar tras unos segundos.
• Confirma que el servicio acepta números virtuales en ese flujo.
• Reintenta más tarde, o prueba la misma pantalla con otra ruta de servicio.
• Espera entre intentos en lugar de repetir pedidos en un bucle cerrado.

¿Existe una línea dedicada portuguesa y cómo funciona la facturación?

OTP Route no vende números dedicados de autoservicio en Portugal. Los Dedicated Virtual Numbers existen solo para Estados Unidos y Canadá, desde $1.95/mes; para una línea +351 de largo plazo, escribe a [email protected], sabiendo que la disponibilidad depende de la normativa local y no está asegurada. Consulta en qué se diferencian los números temporales y los dedicados.

El pago es de prepago según uso desde una billetera en USD, sin cuotas mensuales ni planes, que se recarga con tarjeta o con USDT/USDC, y cada recarga incluye una factura en PDF. Las cuentas de desarrollo pueden pasarse a sandbox bajo petición para probar con números y códigos simulados. Respeta los términos de cada servicio; se aplica la Política de Uso Aceptable de OTP Route.

Preguntas frecuentes

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

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

¿Los números de teléfono portugueses usan un prefijo troncal como un 0 inicial?

No. Los números portugueses tienen nueve dígitos y no llevan prefijo troncal, así que la forma E.164 es +351 seguido de esos nueve dígitos.

¿Puedo probar un flujo de registro en pt-PT sin una tarjeta SIM portuguesa?

Sí. Un número +351 de prueba del OTP Gateway recibe el código, que lees en el panel o a través de la API.

¿Cuánto cuesta un número de verificación de Portugal?

Desde $0.20 por código; el precio exacto depende del servicio y se muestra antes de hacer el pedido.

¿Pagaré por una activación +351 que no recibe nada?

No. Las activaciones expiradas o canceladas se reembolsan íntegramente a tu billetera.

¿Puedo alquilar un número portugués para inicios de sesión continuos?

No en autoservicio. Las líneas de largo plazo son un producto de EE. UU. y Canadá; escribe a soporte si necesitas una línea +351.

¿Debo usar polling o webhooks para los códigos portugueses?

Los webhooks escalan mejor para trabajos en paralelo, mientras que el polling de GET /api/v1/activations/{id} sirve para runners que no pueden aceptar tráfico entrante.

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.