Recibir códigos SMS OTP de República Checa mediante endpoints, webhooks o el panel

¿En qué endpoints se basa la API OTP de República Checa?

Todo se ejecuta contra https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_. Creas las claves en la consola de desarrolladores y una cuenta puede tener hasta 10, lo que facilita dar a staging, CI y un portátil local credenciales distintas que se pueden revocar de forma independiente. El límite de frecuencia es de 300 solicitudes por minuto por cuenta.

Una ejecución típica con +420 se ve así:

1. Obtén GET /api/v1/countries y GET /api/v1/services una vez por despliegue y guárdalos en caché. El id de país de Chequia es cz.
2. Pide GET /api/v1/prices?country=cz&service=<id> para conocer el precio en vivo de la ruta que piensas usar; cambia según el servicio y la disponibilidad.
3. Crea la activación con POST /api/v1/activations y el cuerpo JSON {"service": "<id>", "country": "cz"}. La respuesta te da un id de activación y el número que debes escribir en el formulario de registro que estás probando.
4. Espera el código, ya sea por webhook o leyendo GET /api/v1/activations/{id} con un intervalo moderado.
5. Si la prueba se aborta, libera el número con POST /api/v1/activations/{id}/cancel para que la retención vuelva al monedero de inmediato.

Llamar a GET /api/v1/balance antes de una suite grande es una forma barata de fallar rápido cuando el saldo es bajo. La referencia completa está en la documentación.

¿Cómo verifico los webhooks de las activaciones +420?

Los webhooks eliminan la necesidad de consultar periódicamente y encajan con ejecutores de pruebas en paralelo. Apunta uno de tus endpoints (la consola de desarrolladores permite 5 por cuenta) al flujo checo y suscríbelo a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud lleva una cabecera X-OTPRoute-Signature con el formato t=<unix>,v1=<hex>. Reconstruye la cadena <t>.<raw body> a partir de los bytes intactos de la solicitud, calcula HMAC-SHA256 con el secreto de ese endpoint, compara el resultado con v1 en tiempo constante y descarta todo lo que tenga una marca de tiempo demasiado antigua para ser una entrega reciente. Nuestra guía sobre cómo proteger los webhooks OTP con HMAC recorre un manejador línea por línea.

Trata los eventos como identificados por el id de activación y haz el manejador idempotente: una entrega reintentada debería encontrar la activación ya marcada como completa y devolver éxito sin más. Consultar GET /api/v1/activations/{id} sigue siendo una alternativa válida para scripts que se ejecutan donde no hay un endpoint público.

¿Qué servicios pueden enviar códigos a números checos?

La ruta checa cubre actualmente más de 1,700 servicios. Entre los nombres populares de la última instantánea figuran WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber y ChatGPT (OpenAI).

Esta lista no es fija. La disponibilidad se mueve a lo largo del día, así que el código debe leerla de la API en tiempo de ejecución en lugar de usar una tabla escrita a mano. Si un servicio que necesitas falta en un momento dado, puede reaparecer más tarde, o una ruta vecina de Europa Central puede servir para el caso de prueba.

¿Cómo se debe guardar y analizar un número de verificación checo?

La numeración checa es cerrada: los números nacionales tienen nueve dígitos y no hay prefijo troncal, así que la forma nacional y la internacional se diferencian solo por el +420 delante. Eso simplifica la normalización respecto a muchos mercados, pero los formularios siguen recibiendo espacios, un prefijo internacional 00420 o los nueve dígitos sueltos. Quita los separadores, convierte 00 en +, añade +420 cuando falte y guarda el resultado en E.164.

Los códigos de apps orientadas a Chequia suelen llegar en checo o en inglés. El texto checo usa signos diacríticos como el háček y la čárka, y algunos remitentes los eliminan para mantener el mensaje en un juego de caracteres simple, así que un analizador debe buscar el grupo de dígitos en lugar de comparar una frase completa.

Los equipos usan un número +420 para pruebas cuando lanzan un producto para clientes checos, revisan los textos de onboarding en checo o confirman que un registro regional acepta números sin cero inicial. La página de pruebas de QA describe cómo estructuran estas ejecuciones.

¿Qué debe ocurrir cuando un código checo nunca llega?

Algunos servicios rechazan los números virtuales, y algunas rutas son más lentas a ciertas horas. Un código perdido no cuesta nada: si ningún SMS llega dentro de la ventana de 20 minutos, o cancelas antes, el importe completo vuelve automáticamente al monedero.

• Deja correr la ventana antes de decidir que el intento falló.
• Comprueba si el servicio que estás probando acepta números virtuales.
• Reintenta más tarde o prueba otra ruta de país que el servicio admita.
• Espacia los intentos; repetir pedidos en bucle rápido consume el límite de frecuencia y rara vez ayuda.
• Registra el id de activación en cada fallo para que los patrones salgan a la luz entre ejecuciones.

¿Pueden usar la ruta +420 desde el panel quienes no programan?

Sí. Después de registrarte con correo electrónico y un código de 6 dígitos enviado por correo (o con el acceso de Google), abre el OTP Gateway, elige el servicio y República Checa, comprueba el precio que se muestra y haz el pedido. El número de verificación de República Checa aparece al instante; pégalo en la app y el código se muestra en la misma pantalla cuando llega. Cancelar desde el panel devuelve el importe al monedero igual que la llamada a la API.

¿Existe un número checo de larga duración y cómo se factura?

Hoy no hay un número checo de larga duración en autoservicio. Los Dedicated Numbers son un producto de EE. UU. y Canadá desde $1.95/month, con SMS entrantes y salientes además de llamadas desde el navegador; consulta números virtuales para más detalles. Si tu equipo necesita una línea +420 duradera, escribe a [email protected] y pregunta, sabiendo que la disponibilidad depende de la normativa local y no está prometida.

La facturación es un único monedero prepago en USD sin cuota mensual ni plan que elegir. Los fondos entran con tarjeta o como USDT/USDC, y cada recarga genera una factura en PDF enviada por correo. Para el trabajo de integración, una cuenta de desarrollo puede pasarse a sandbox a petición, de modo que números y códigos simulados recorran todo el flujo sin gastar fondos del monedero. El inicio de sesión en dos pasos con TOTP está disponible para la propia cuenta.

Preguntas frecuentes

¿Puedo probar el registro checo de mi app sin una SIM checa?

Sí. Pide un número +420 en el OTP Gateway para el servicio que estás probando, introdúcelo en tu app y lee el código desde el panel, la API o un webhook.

¿Cuál es el id de país de República Checa en la API de OTP Route?

Usa cz en el campo country de POST /api/v1/activations y en las consultas de precios.

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

Los códigos empiezan desde $0.20 por código, y el precio exacto de cada servicio lo devuelve GET /api/v1/prices y se muestra antes de pedir. Solo pagas si llega un código.

¿Los números checos necesitan un cero inicial?

No. Los números checos no tienen prefijo troncal, así que guárdalos como +420 seguido de los nueve dígitos nacionales.

¿Cuánto tiempo permanece abierta una activación +420?

Veinte minutos. Si no llega nada en ese tiempo, la activación caduca y el monedero se reembolsa por completo.

¿Es adecuado el enrutamiento OTP a República Checa para crear cuentas en masa?

No. OTP Route es para probar tu propio producto y operar tus propias cuentas legítimas. Mantén cada activación +420 ligada a tu propio producto o cuenta, dentro de las condiciones de cada servicio y de la Política de Uso Aceptable de OTP Route.

¿Puedo conservar el mismo número checo para inicios de sesión posteriores?

No como producto de autoservicio. Los Dedicated Numbers de larga duración existen solo en Estados Unidos y Canadá, y puedes escribir a soporte para preguntar por otros mercados.

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.