Verificar Código OTP

Verifica el código de verificación que el usuario ingresó. Una vez validado correctamente, el número queda verificado.

post/otp/verify

Authorizations

apikeystringheaderrequired

Body

application/json

phone_numberstringrequired

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

verification_codestringrequired

El código de verificación que el usuario recibió y capturó en tu aplicación.

localeenum

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

enum:esen

Response

200Usuario verificado exitosamente

successboolean

messagestring

Mensaje de estado

statusinteger

codestring

Código de respuesta

400Error de validación

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.