Saltar al contenido principal

Inicio rápido

Registra tu primera acción de consentimiento REDEC​

Esta guía te llevará paso a paso para registrar una acción de consentimiento que cumple con los requisitos de REDEC (NCG 540).

Pre-requisitos​

Antes de comenzar, asegúrate de tener:

  • Cuenta Empresa en Soyio con credenciales de API
  • Módulo REDEC habilitado en la configuración de tu cuenta
Importante

Si aún no tienes tu cuenta Empresa en Soyio, contacta a nuestro equipo para obtener una cuenta de prueba completando el siguiente formulario.

Paso a paso​

1. Configura tu empresa para REDEC​

Antes de registrar consentimientos, configura el módulo REDEC en tu cuenta:

a) Establece el código REDEC de tu empresa

El código REDEC es asignado por la CMF a tu institución financiera. Configúralo en la información de tu empresa:

PATCH /api/v1/company
{
  "redec_code": 123456
}

b) Habilita el módulo REDEC

Activa el módulo REDEC en la configuración de consentimiento de tu empresa:

PATCH /api/v1/config
{
  "consent": {
    "redec_enabled": true
  }
}
Código REDEC obligatorio

El código REDEC (numérico) es requerido para generar reportes RDC30 válidos. Asegúrate de usar el código correcto asignado por la CMF.

2. Crea un producto con redec_kind​

Primero, crea un producto que clasifica el tipo de crédito según la CMF. El producto debe tener un redec_kind:

POST /api/v1/products
{
  "name": "Crédito de Consumo",
  "redec_kind": "consumer_credits"
}

Valores válidos de redec_kind:

  • commercial_credits - Créditos comerciales
  • consumer_credits - Créditos de consumo
  • housing_credits - Créditos hipotecarios
  • financial_operations - Operaciones financieras
  • acquired_debt_instruments - Instrumentos de deuda adquiridos
  • contingent_credits - Créditos contingentes
  • freely_available_credit_line_limits - Límites de líneas de crédito de libre disposición

La respuesta incluirá el product_id:

Respuesta
{
  "product": {
    "id": "prod_abc123...",
    "name": "Crédito de Consumo",
    "redec_kind": "consumer_credits"
  }
}

3. Crea una plantilla de consentimiento REDEC-compliant​

Usa el endpoint específico de REDEC para crear plantillas. Este endpoint valida automáticamente el cumplimiento REDEC:

Requisitos obligatorios:

  1. Data uses permitidos: Solo puedes usar estos dos:

    • finance.credit_risk_assessment (Evaluación de riesgo crediticio)
    • finance.commercial_risk_assessment (Evaluación de riesgo comercial)

  2. Product ID: Debes referenciar un producto con redec_kind válido

POST /api/v1/redec/consent_templates
{
  "name": "Consentimiento REDEC - Crédito de Consumo",
  "duration": "P24M",
  "title": "Autorización consulta información crediticia",
  "text": "Autorizo consultar mi información crediticia para evaluar mi solicitud de crédito de consumo.",
  "data_requirements": [
    {
      "data_category": "user.government_id.national_identification_number",
      "data_uses": ["finance.credit_risk_assessment"]
    },
    {
      "data_category": "user.financial",
      "data_uses": ["finance.credit_risk_assessment"]
    }
  ],
  "product_id": "prod_abc123..."
}

4. Captura el consentimiento del usuario​

Captura el consentimiento usando el SDK de Soyio o tu propia interfaz con la plantilla REDEC que creaste. Esto generará un action_token.

Consejo

Si no estás familiarizado con la captura de consentimiento, revisa primero la guía de captura de consentimientos.

5. Registra la acción de consentimiento REDEC​

Usa el endpoint específico de REDEC para registrar la acción con el RUT del usuario:

curl -X POST https://api.soyio.id/api/v1/redec/consent_actions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_token": "at_abc123...",
    "entity_nin": "12.345.678-9",
    "executive_nin": "98.765.432-1",
    "user_reference": "cliente_123"
  }'

Parámetros clave:

  • action_token: Token generado al capturar el consentimiento
  • entity_nin: RUT del usuario (obligatorio para REDEC)
  • executive_nin: RUT del ejecutivo que gestionó la solicitud (opcional)
  • user_reference: Identificador del usuario en tu sistema (opcional)

6. Confirma el registro exitoso​

La API retornará la acción de consentimiento creada:

Respuesta exitosa
{
  "consent_action": {
    "id": "ca_redec_abc123...",
    "action_token": "at_abc123...",
    "entity_id": "ent_xyz789...",
    "entity_nin": "12.345.678-9",
    "executive_nin": "98.765.432-1",
    "user_reference": "cliente_123",
    "created_at": "2026-01-15T10:30:00Z",
    "agreement_id": "agr_...",
    "evidence_id": "ev_..."
  }
}

7. Flujo completo de evaluación crediticia​

Este es el flujo típico para una solicitud de crédito:

Próximos pasos​

No olvides programar tus reportes

Configura reportes periódicos automáticos semanales para cumplir con los requisitos de sincronización de la CMF. Aprende cómo en la guía de reportes.