Inicio rápido

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

Si aún no tienes tu cuenta Empresa en Soyio, contacta a nuestro equipo para obtener una cuenta de prueba desde nuestra página de contacto.

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_info

{
  "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 y RDC31 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": "P15D",
  "duration_basis": "business_days",
  "data_subject": "customer",
  "title": "Autorización consulta información crediticia",
  "text": "Autorizo consultar mi información crediticia en el Registro de Deuda Consolidada para evaluar mi solicitud de crédito de consumo. Este consentimiento tiene una vigencia de 15 días hábiles.",
  "data_requirements": [
    {
      "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.

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

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"
  }'

JavaScript

const response = await fetch('https://api.soyio.id/api/v1/redec/consent_actions', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${YOUR_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    action_token: 'at_abc123...',
    entity_nin: '12.345.678-9',  // RUT del usuario
    executive_nin: '98.765.432-1',  // RUT del ejecutivo (opcional)
    user_reference: 'cliente_123'  // ID interno (opcional)
  })
});

const data = await response.json();
console.log('Consentimiento REDEC registrado:', data.consent_action);

Python

import requests

response = requests.post(
    'https://api.soyio.id/api/v1/redec/consent_actions',
    headers={
        'Authorization': f'Bearer {YOUR_API_KEY}',
        'Content-Type': 'application/json'
    },
    json={
        'action_token': 'at_abc123...',
        'entity_nin': '12.345.678-9',  # RUT del usuario
        'executive_nin': '98.765.432-1',  # RUT del ejecutivo (opcional)
        'user_reference': 'cliente_123'  # ID interno (opcional)
    }
)

data = response.json()
print('Consentimiento REDEC registrado:', data['consent_action'])

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. Obligatorio cuando la entidad aún no existe en Soyio (usuario nuevo); para usuarios existentes puedes omitirlo solo si envías entity_id

6. Confirma el registro exitoso

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

Respuesta exitosa

{
  "consent_action": {
    "id": "consact_1B2M2Y8AsgTpgAmY7PhCfg",
    "entity_id": "ent_5F6Q6C2EwkXtkEpB1TlGjk",
    "user_reference": "cliente_123",
    "consent_template_id": "ctmpl_cYTjMLgWE3MvUa3RKwgXEg",
    "consent_template_name": "Crédito de Consumo REDEC",
    "consent_template_version": 1,
    "channel": "digital",
    "kind": "grant",
    "data_use": "finance",
    "selected_scopes": [
      {
        "scope_type": "product",
        "scope_id": "prod_1B2M2Y8AsgTpgAmY7PhCfg",
        "scope_version": 1
      }
    ],
    "contextual_data": {
      "ip": "192.168.1.1",
      "user_agent": "Mozilla/5.0",
      "url": "https://tu-app.cl/credito"
    },
    "redec_data": {
      "redec_id": "A1b2C3d4E5f6G7h8I9j0",
      "executive_nin": "98.765.432-1",
      "audio_reference": null,
      "audio_hash": null
    },
    "created_at": "2026-01-15T10:30:00Z"
  }
}

Campos clave de la respuesta:

Campo	Uso
redec_data.redec_id	Identificador REDEC del consentimiento. Obligatorio para registrar accesos RDC31
consent_template_id / consent_template_version	Auditoría: identifica la plantilla y versión utilizada
selected_scopes	Scopes específicos otorgados; determina a qué productos aplica el consentimiento
contextual_data	Datos contextuales capturados (IP, user agent, URL) para evidencia de auditoría CMF
redec_pdf_hash	Hash SHA256 del recibo PDF. Puede no estar disponible si el PDF aún no se ha generado

redec_pdf_hash puede no estar disponible

En la respuesta inmediata del POST, redec_pdf_hash y redec_receipt_pdf pueden venir como null o no estar presentes porque el PDF se genera en segundo plano.

Para obtener el hash una vez disponible, tienes dos opciones:

• Suscribirse al webhook consent_action.redec_receipt_generated
• Consultar GET /api/v1/redec/consent_actions/{id} después de unos segundos

Revisa la guía de Recibos PDF REDEC para más detalles.

action_token y entity_nin son parámetros de entrada y no se devuelven en la respuesta. El executive_nin se retorna dentro de redec_data, no al nivel superior. Los campos agreement_id y evidence_id no se incluyen al crear la acción; para obtenerlos, consulta la acción con GET /api/v1/redec/consent_actions/:id.

7. Flujo completo de evaluación crediticia

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

Press enter or space to select a node.You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Próximos pasos

• Cómo funciona REDEC - Entiende el modelo de datos y flujo completo
• Registra consentimientos - Guía completa del endpoint REDEC
• RDC30 - Crea reportes para la CMF y programa reportes periódicos automáticos
• RDC31 - Registra accesos exitosos y genera el reporte semanal de accesos bajo consentimiento
• Configuración - Configura REDEC en tu cuenta con opciones avanzadas

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 RDC30 y RDC31.