Reenviar Código de Verificación (OTP)

Reenvía el código de verificación al número especificado. Puedes cambiar el canal (SMS, WhatsApp, voz) y reiniciar el código con `reset_code=true`. Si el usuario no recibe el SMS, usa el parámetro `voice=true` para realizar una llamada en lugar de enviar un SMS.

post/otp/resend

Authorizations

apikeystringheaderrequired

Body

application/json

phone_numberstringrequired

Número de teléfono a verificar, formato: XXXXXXXXXX (10 dígitos).

country_codestringrequired

Código de país. Por estandarización, siempre se debe enviar `52` que es el código correspondiente a México.

companystringrequired

Nombre de la compañía mostrada al usuario en el mensaje de verificación.

templateenum

Letra de la plantilla SMS a utilizar. Las variables `{{company}}` y `{{code}}` se reemplazan automáticamente. Por defecto `a`. **Plantillas disponibles:** | Letra | Contenido del mensaje | |-------|----------------------| | **a** | "{{company}} El codigo de verificacion es: {{code}}" | | **b** | "Ingresa el siguiente codigo en tu app de {{company}} para validar tu cuenta: {{code}}" | | **c** | "Ingresa el codigo {{code}} para activar tu cuenta de {{company}}" | | **d** | "El codigo de autenticacion para {{company}} es: {{code}}" | | **e** | "Captura el codigo {{code}} para activar tu cuenta {{company}}" | | **f** | "{{company}} Tu codigo es: {{code}}" | | **g** | "Tu codigo de confirmacion {{company}} es: {{code}}" | | **h** | "{{code}} es tu codigo de verificacion de {{company}}" | | **i** | "{{code}} es tu codigo para iniciar sesion en {{company}}" | | **j** | "Tu codigo de activacion para {{company}} es el {{code}}" | | **k** | "{{company}}: {{code}} es tu codigo de seguridad" | | **l** | "Tu codigo de verificacion {{company}} es: {{code}} No compartas este codigo con nadie." | | **m** | "Tu codigo {{company}} es: {{code}}" | | **n** | "Usa la clave {{code}} para ingresar a {{company}}" | Usa `formal_tone: true` para cambiar el trato de "tú" a "usted" sin alterar la plantilla.

enum:abcdefghijklmn
formal_toneboolean

Define el trato gramatical del mensaje. `false` = trato informal (tú). `true` = trato formal (usted). Por defecto `false`.

code_lengthinteger

Longitud del código de verificación (4 a 10 caracteres). Se ignora si no se solicita reinicio del código.

expiration_datestring· date-time

Fecha de expiración para el código de verificación. Por defecto 24 hrs. Máximo 3 días. Formato: `YYYY-MM-DD HH:mm:ss`.

localeenum

Idioma de la respuesta. `es` = Español, `en` = Inglés. Por defecto `es`.

enum:esen
reset_codeboolean

Reinicia el código de verificación. `true` = genera un nuevo código aleatorio. `false` = conserva el mismo código. Por defecto `false`.

voiceboolean

Canal de voz para enviar el código. `true` = realiza una llamada telefónica con voz robótica. `false` = envía por SMS. Por defecto `false`.

whatsappboolean

Envía el código de verificación a través de WhatsApp. Requiere una instancia de WhatsApp configurada y activa. Si no está disponible, se envía por SMS (fallback).

showcodeenum

Devuelve el código de verificación generado en la respuesta. `1` = Mostrar, `0` = No mostrar. Por defecto `0`.

enum:01
code_typeenum

Tipo de código generado. Requiere `reset_code=true` para cambiar el tipo. `alphanumeric` = letras y números, `numeric` = solo números, `letters` = solo letras.

enum:alphanumericnumericletters
senderstring

Nombre del remitente personalizado (hasta 11 caracteres alfanuméricos). Si no lo tienes contratado, este parámetro se ignora.

referenceboolean

Devuelve la referencia del mensaje enviado en la respuesta. Por defecto `true`.

Response

200Código reenviado exitosamente
successboolean
messagestring

Mensaje de estado

statusinteger
codestring

Código de respuesta

total_messagesinteger

Número de mensajes enviados

numberstring

Número de teléfono del destinatario con código de país

creditnumber

Créditos consumidos

referencestring

ID único de referencia del mensaje

verification_codestring

Código de verificación (solo cuando showcode=1)

fallbackboolean

True si ocurrió fallback de WhatsApp o Voz a SMS

400Error de validación o lógica de negocio
successboolean

Siempre `false` para respuestas de error

messagestring

Descripción del error en español

statusinteger

Código HTTP de la respuesta

codestring

Código de error estructurado (`{dominio}_{número}`). Identifica de forma única la causa del error para manejo programático.

401No autorizado — API Key no provista, inválida o expirada
successboolean

Siempre `false`

messagestring

Descripción del error de autenticación en español

statusinteger

Código HTTP

codestring

Código de error de autenticación (`auth_01`, `auth_05`, `auth_06`, `auth_07`, `auth_99`)

403Prohibido — La dirección IP no está autorizada para acceder (IP whitelist)
successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error: `auth_04` (IP no autorizada en whitelist)

429Demasiadas peticiones — Límite de rate limit excedido (100 mensajes/segundo producción, 100/día sandbox)
successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error de rate limit

500Error interno del servidor
successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error interno

request_idstring· uuid

Identificador único de la petición. Inclúyelo al contactar a soporte.