Skip to main content

Validaciones de Teléfono

Descripción​

Las Validaciones de Teléfono son el sistema central de verificación en Verifik que procesa y valida números de teléfono de usuarios durante el proceso de autenticación y registro. Piénsalas como el punto de control de seguridad que garantiza que los usuarios son quienes dicen ser, verificando la propiedad del teléfono mediante códigos de verificación seguros.

Cómo funcionan las Validaciones de Teléfono​

Cada Validación de Teléfono representa una sesión única de verificación que procesa los números ingresados por el usuario. Cuando alguien introduce su teléfono durante el registro, inicio de sesión o verificación de cuenta, Verifik crea una Validación de Teléfono para enviar un código de verificación seguro por SMS y confirmar la propiedad del teléfono del usuario.

Actualmente, las Validaciones de Teléfono soportan estos tipos:

  • validation - Proceso estándar de verificación de teléfono
  • login - Verificación de teléfono para autenticación de usuarios
  • onboarding - Verificación de teléfono para registro de nuevos usuarios
  • twoFactor - Autenticación de dos factores vía SMS

Qué registran las Validaciones de Teléfono​

Las Validaciones de Teléfono son sistemas de verificación integrales que procesan todos los aspectos de la verificación telefónica:

Información del teléfono​

  • Número de teléfono y verificación de propiedad
  • Código de país e información del operador
  • Nombre del usuario y datos de contacto
  • Asociación con proyecto y cliente

Proceso de verificación​

  • Generación y envío de contraseñas de un solo uso (OTP)
  • Estado de envío por SMS y confirmación de entrega
  • Validación del código e intentos de verificación
  • Gestión de expiración y seguridad

Características de seguridad​

  • Limitación de tasa y prevención de abuso
  • Generación y validación segura de códigos
  • Seguimiento de entrega y confirmación
  • Detección y prevención de fraude

Endpoints de la API​

Crear una Validación de Teléfono​

POST https://api.verifik.co/v2/phone-validations

Listar todas las Validaciones de Teléfono​

GET https://api.verifik.co/v2/phone-validations

Recuperar una Validación de Teléfono​

GET https://api.verifik.co/v2/phone-validations/{validationId}

Validar una Validación de Teléfono​

POST https://api.verifik.co/v2/phone-validations/{validationId}/validate

Estructura del Objeto Validación de Teléfono​

{
    "id": "phone_validation_123456789",
    "phoneNumber": "+1234567890",
    "status": "completed",
    "type": "validation",
    "verificationCode": "123456",
    "attempts": 1,
    "maxAttempts": 3,
    "expiresAt": "2024-01-15T11:30:00Z",
    "deliveryStatus": "delivered",
    "validatedAt": "2024-01-15T10:32:00Z",
    "createdAt": "2024-01-15T10:30:00Z"
}

Casos de uso​

  • Autenticación de usuarios: Verifica la propiedad del teléfono para un inicio de sesión seguro
  • Registro de cuentas: Confirma números de teléfono durante el registro
  • Autenticación de dos factores: Mejora la seguridad con verificación por SMS
  • Seguridad: Fortalece la seguridad de la cuenta mediante verificación telefónica