Kuenta Docs

Appearance

Líneas de Crédito ​

Las líneas de crédito en Kuenta te permiten definir los parámetros y condiciones para otorgar créditos a tus clientes.

Tipos de líneas de crédito ​

1. Línea de crédito simple ​

  • Monto fijo
  • Plazo definido
  • Tasa de interés única

2. Línea de crédito rotativa ​

  • Monto máximo disponible
  • Renovación automática
  • Tasas variables según uso

3. Línea de crédito por producto ​

  • Montos específicos por tipo de producto
  • Condiciones personalizadas
  • Scoring específico

Configuración de una línea de crédito ​

1. Información básica ​

json
{
  "name": "Línea de Crédito Personal",
  "type": "simple",
  "currency": "COP",
  "maxAmount": 10000000,
  "minAmount": 100000,
  "term": {
    "min": 3,
    "max": 24,
    "unit": "months"
  }
}

2. Configuración de tasas ​

json
{
  "interestRate": {
    "type": "fixed",
    "value": 1.5,
    "period": "monthly"
  },
  "fees": {
    "administration": 0.5,
    "latePayment": 2.0
  }
}

3. Reglas de aprobación ​

json
{
  "minScore": 650,
  "maxDebtRatio": 0.4,
  "requiredDocuments": ["identification", "incomeProof", "bankStatement"]
}

Endpoints de la API ​

Crear línea de crédito ​

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

{
  "name": "Línea de Crédito Personal",
  "type": "simple",
  "currency": "COP",
  "maxAmount": 10000000,
  "minAmount": 100000,
  "term": {
    "min": 3,
    "max": 24,
    "unit": "months"
  }
}

Listar líneas de crédito ​

http
GET /v1/credit-lines
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

Obtener detalles de una línea ​

http
GET /v1/credit-lines/{id}
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

Simulación de créditos ​

Endpoint de simulación ​

http
POST /v1/credit-lines/{id}/simulate
Content-Type: application/json
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

{
  "amount": 5000000,
  "term": 12,
  "termUnit": "months"
}

Respuesta de simulación ​

json
{
  "monthlyPayment": 458333,
  "totalInterest": 500000,
  "totalPayment": 5500000,
  "amortizationTable": [
    {
      "period": 1,
      "payment": 458333,
      "principal": 416667,
      "interest": 41667,
      "balance": 4583333
    }
    // ... más periodos
  ]
}

Próximos pasos ​

Soporte ​

Si necesitas ayuda con la configuración de líneas de crédito: