Validaciones de Teléfono

¿Qué es una Validación de Teléfono?

Una Validación de Teléfono es una sesión OTP para un número. Verifik envía un código de un solo uso por SMS o WhatsApp, y luego confirmas el código que ingresa el usuario.

Ciclo típico:

1. Enviar — crear una Phone Validation y entregar el OTP
2. Verificar — enviar el mismo teléfono + OTP para marcar la sesión como validada

Consulta todos los campos en El objeto Validación de Teléfono.

Reglas de tiempo

Regla	Valor por defecto
OTP válido durante	10 minutos (expiresAt en la respuesta de envío)
Ventana de reenvío	~2 minutos entre envíos para el mismo teléfono + gateway (409 otp_recently_sent)
Omitir ventana	Create manual con "force": true

Envía y muestra siempre el countryCode junto al phone nacional (ej. +57 3001234567) para que el usuario sepa a qué destino llegó el mensaje.

---

Elige tu ruta de integración

Ruta A — Independiente / Smart Tools (sin proyecto)

Úsala cuando envías OTPs desde tu backend o desde Smart Tools → Mensajes de WhatsApp / SMS, sin un proyecto de Smart Enroll o Smart Access.

Paso	Endpoint
1. Enviar OTP	POST /v2/phone-validations/manual
2. Verificar OTP	PUT /v2/phone-validations

• No requiere project / projectFlow
• El source del registro es "manual"
• Se cobran créditos de comunicación tras un envío exitoso
• title opcional (máx. 15 caracteres) define el nombre de empresa en la plantilla

Tu app                      API Verifik
──────                      ───────────
POST /manual  ───────────►  OTP enviado
                            status: sent

PUT  /phone-validations ─►  OTP verificado
  { phone, countryCode, otp }   status: validated

Ruta B — Proyecto / App Registration (Smart Enroll y Access)

Úsala cuando el OTP forma parte de un flujo de registro o login ligado a un proyecto.

Paso	Endpoint
1. Enviar OTP	POST /v2/phone-validations/app-registration
2. Verificar OTP	PUT /v2/phone-validations

---

Índice de endpoints

Acción	Método y ruta	Docs
Enviar OTP independiente	POST /v2/phone-validations/manual	Crear una Validación de Teléfono manual
Verificar OTP	PUT /v2/phone-validations	Validar una Validación de Teléfono
Listar	GET /v2/phone-validations	Listar todas las Validaciones de Teléfono
Obtener una	GET /v2/phone-validations/{id}	Recuperar una Validación de Teléfono
Precios SMS y WhatsApp	—	Precios SMS y WhatsApp

Autenticación

Todos los endpoints requieren Authorization: Bearer {YOUR_ACCESS_TOKEN} y Content-Type: application/json.