Cómo llevar los códigos de verificación argentinos (+54) a tu integración

¿Cuáles son las cuatro llamadas de API detrás de una activación +54?

Todo vive bajo https://otproute.com/api/v1 y se autentica con una clave Bearer que empieza por or_live_. Las claves se emiten en la consola de desarrolladores; una cuenta puede tener hasta 10 y registrar 5 endpoints de webhook, con un tope de 300 solicitudes por minuto.

1. Cotízalo. Llama a GET /api/v1/prices?country=ar&service=<id> para que tu código conozca el coste en vivo antes de comprometer fondos del monedero. El id de país de Argentina es ar.
2. Pídelo. Envía POST /api/v1/activations con el cuerpo JSON {"service": "whatsapp", "country": "ar"}, cambiando el id por el servicio que necesite tu prueba. La respuesta trae un id de activación y el número +54 que debes escribir en la app bajo prueba.
3. Espéralo. Consulta GET /api/v1/activations/{id} a un intervalo razonable o deja que el webhook activation.sms_received te avise de que el código ya llegó.
4. Libéralo antes si hace falta. POST /api/v1/activations/{id}/cancel termina una activación que ya no quieres y devuelve el dinero al monedero.

Si quieres ver los ids antes de fijarlos en el código, GET /api/v1/services y GET /api/v1/countries listan lo que la plataforma ofrece en cada momento. El material de referencia completo está en la documentación.

¿Cómo hago fiable el receptor de webhooks para códigos argentinos?

Cada entrega incluye una cabecera X-OTPRoute-Signature con la forma t=<unix>,v1=<hex>. Reconstruye la cadena "<t>.<raw body>", calcula HMAC-SHA256 sobre ella con el secreto de ese endpoint y compara el resultado con v1 mediante una función de tiempo constante. Descarta cualquier solicitud cuya marca de tiempo sea antigua, porque una firma vieja pero válida es exactamente lo que parece un ataque de repetición.

Además de activation.sms_received, suscríbete a activation.expired y activation.cancelled para que un ejecutor de pruebas nunca se quede esperando un número que ya se cerró. Trata cada evento como identificado por el id de activación y escribe tu manejador de modo que una segunda entrega del mismo evento no cambie nada. El artículo sobre firmar y verificar webhooks de OTP explica la lógica de comparación con más detalle.

¿Con qué apps puedo verificar un número argentino?

La instantánea actual de Argentina lista más de 2,000 servicios. Entre los que suelen usar los equipos de producto y QA argentinos están:

• Mensajería: WhatsApp, Telegram, Signal, Discord
• Cuentas y productividad: Google (Gmail y YouTube), Microsoft y Outlook, LinkedIn, ChatGPT (OpenAI)
• Redes sociales y vídeo: Instagram, TikTok
• Comercio y movilidad: Amazon, Uber, Airbnb, Netflix

Esta lista cambia durante el día, y por eso la API informa de la disponibilidad en vivo en lugar de una tabla estática. Consulta GET /api/v1/services pensando en el país ar antes de que arranque un trabajo programado de CI, y falla rápido con un mensaje claro si tu servicio de destino falta temporalmente.

¿Por qué los móviles argentinos hacen tropezar a los validadores de teléfono?

Argentina tiene uno de los planes de numeración más inusuales de la región. A nivel nacional se escribe un 0 troncal antes del código de área y, en los móviles, un 15 antes de los dígitos del abonado, de modo que un celular de Buenos Aires puede aparecer como 011 15 seguido de ocho dígitos. En el formato internacional E.164 ambos desaparecen y se inserta un 9 justo después del código de país: +54 9 11 y luego el número de abonado de ocho dígitos.

Esa diferencia importa a quien almacena números de teléfono. Normaliza todo a E.164 antes de guardar, elimina el 0 y el 15 al recibir la entrada y añade el 9 en los móviles. Un validador que solo comprueba la longitud aceptará sin problema un valor +54 11 de estilo fijo que no puede recibir SMS. Usa el número exactamente como lo devuelve la API en lugar de reformatearlo tú mismo.

Los códigos enviados a números argentinos suelen llegar en español, a menudo con una frase como "Tu código es" alrededor de los dígitos. Extrae el código numérico con un patrón en vez de buscar la redacción, ya que las plantillas cambian. Los equipos prueban aquí cuando se lanzan en Latinoamérica, revisan textos en español rioplatense (las formas locales con vos difieren del español de manual), gestionan operaciones regionales o atienden a argentinos que viven en el extranjero y aun así se registran con una SIM +54.

¿Puede pedir un número +54 alguien que no programa?

Sí. El personal de soporte, crecimiento y agencias puede hacerlo todo desde el navegador:

1. Crea una cuenta en registro con un correo y un código de 6 dígitos, o con el inicio de sesión de Google.
2. Añade fondos al monedero.
3. Abre el OTP Gateway, elige Argentina y luego el servicio que estás probando.
4. Comprueba el precio mostrado, confirma y copia el número +54 en la pantalla de verificación de la app.
5. Observa la activación; el código aparece ahí en cuanto se recibe.

El panel y la API usan el mismo monedero y las mismas activaciones, así que un desarrollador puede retomar un número que un compañero pidió a través de su id de activación.

El código argentino no llegó. ¿Y ahora qué?

Cada activación permanece abierta 20 minutos. Si no llega nada, o cancelas antes, el importe completo vuelve al monedero automáticamente, de modo que una ruta silenciosa te cuesta tiempo, no dinero. La velocidad de entrega depende del servicio y de la ruta, así que dale a la ventana una oportunidad razonable antes de darla por fallida.

Después repasa esta breve lista:

• Solicita el código de nuevo desde dentro de la app una vez y luego deja correr la ventana.
• Prueba más tarde en el día, o pide por otra ruta para el mismo servicio.
• Confirma que el servicio acepta números virtuales; algunos los rechazan, y por eso existe el reembolso automático.
• Evita repetir pedidos en un bucle cerrado desde CI. Añade un retroceso progresivo y un tope de reintentos.

Nuestro artículo sobre cómo reducir las entregas fallidas de OTP cubre más patrones para rutas argentinas. Mantén cada prueba dentro de los términos de cada servicio; también se aplica la Política de Uso Aceptable de OTP Route.

¿Podemos conservar una línea argentina y cómo se paga?

Hoy no existe un número argentino de largo plazo de autoservicio. Si tu equipo necesita una línea +54 persistente, escribe a [email protected] y describe el caso de uso; que se pueda gestionar depende de la normativa local y no está asegurado. Los Números Virtuales Dedicados, que conservas mientras se renuevan y que reenvían los SMS entrantes a tu webhook, son un producto de Estados Unidos y Canadá desde $1.95/month.

La facturación funciona con un único monedero prepago en USD, sin cuota mensual y sin plan que elegir. Recarga con tarjeta o con USDT/USDC, y cada recarga genera una factura en PDF por correo. Los detalles están en la página de precios. Antes de gastar fondos reales, pide que tu cuenta de desarrollo pase a sandbox, que devuelve números y códigos simulados para que ensayes todo el flujo de Argentina de principio a fin.

Preguntas frecuentes

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

Es ar. Pásalo en el campo country de POST /api/v1/activations y en la cadena de consulta de GET /api/v1/prices.

¿Debo añadir el 9 cuando escribo el número +54 en una app?

Usa el número exactamente como lo devuelve OTP Route. En tu propia base de datos, guarda los móviles argentinos en formato E.164, que incluye el 9 después de +54 y elimina el 0 y el 15 nacionales.

¿Cuánto cuesta recibir un SMS OTP de Argentina?

Desde $0.20 por código, según el servicio. La cifra exacta la devuelve GET /api/v1/prices y se muestra antes de que confirmes un pedido.

¿Puedo probar el registro argentino de mi app sin una SIM local?

Sí. Pide una activación de Argentina para tu propia app o para el servicio de terceros de tu prueba, introduce el número +54 y lee el código en el panel o desde tu webhook.

¿Funcionará el mismo número +54 para un inicio de sesión el mes que viene?

No. Un número del gateway cubre un único código en 20 minutos. Para cuentas que deben seguir recibiendo códigos, la opción adecuada es un Número Dedicado en EE. UU. o Canadá.

¿En qué idioma llegará el texto de verificación argentino?

Normalmente en español, aunque depende del remitente y de la configuración de idioma de la cuenta. Extrae los dígitos en lugar de fiarte de las palabras que los rodean.

¿Es aceptable consultar periódicamente en lugar de usar webhooks?

Sí. Consulta GET /api/v1/activations/{id} a un intervalo moderado y mantente muy por debajo del límite de 300 solicitudes por minuto por cuenta.

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.