Kuenta Docs

Appearance

Flujos de Validación ​

Los flujos de validación en Kuenta te permiten definir el proceso de verificación y aprobación de créditos de manera personalizada.

Tipos de validación ​

1. Validación de identidad ​

  • Verificación biométrica
  • Validación documental
  • Verificación de datos personales

2. Validación crediticia ​

  • Scoring crediticio
  • Verificación de ingresos
  • Análisis de capacidad de pago

3. Validación de documentos ​

  • Verificación de autenticidad
  • Validación de firmas
  • Comprobación de información

Configuración de un flujo de validación ​

1. Estructura básica ​

json
{
  "name": "Flujo de Crédito Personal",
  "type": "credit",
  "steps": [
    {
      "id": "identity_validation",
      "type": "identity",
      "required": true,
      "order": 1
    },
    {
      "id": "credit_check",
      "type": "credit",
      "required": true,
      "order": 2
    },
    {
      "id": "document_validation",
      "type": "document",
      "required": true,
      "order": 3
    }
  ]
}

2. Configuración de reglas ​

json
{
  "rules": {
    "identity_validation": {
      "minScore": 80,
      "requiredDocuments": ["id", "proof_of_address"],
      "biometricRequired": true
    },
    "credit_check": {
      "minScore": 650,
      "maxDebtRatio": 0.4,
      "requiredDocuments": ["income_proof", "bank_statement"]
    },
    "document_validation": {
      "requiredSignatures": ["borrower", "co_signer"],
      "notaryRequired": false
    }
  }
}

Endpoints de la API ​

Crear flujo de validación ​

http
POST /v1/validation-flows
Content-Type: application/json
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

{
  "name": "Flujo de Crédito Personal",
  "type": "credit",
  "steps": [
    {
      "id": "identity_validation",
      "type": "identity",
      "required": true,
      "order": 1
    }
  ]
}

Listar flujos de validación ​

http
GET /v1/validation-flows
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

Obtener detalles de un flujo ​

http
GET /v1/validation-flows/{id}
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

Webhooks de validación ​

Eventos disponibles ​

json
{
  "events": [
    "validation.started",
    "validation.step.completed",
    "validation.step.failed",
    "validation.completed",
    "validation.failed"
  ]
}

Ejemplo de payload ​

json
{
  "event": "validation.step.completed",
  "data": {
    "flowId": "flow_123",
    "stepId": "identity_validation",
    "status": "completed",
    "score": 85,
    "timestamp": "2024-03-20T10:00:00Z"
  }
}

Próximos pasos ​

Soporte ​

Si necesitas ayuda con la configuración de flujos de validación: