Crear crédito #

Permite crear un crédito y asociarlo a un lead o usuario.

URL del endpoint #

POST /create-loan

Parámetros de entrada #

Los parámetros deben enviarse en el cuerpo de la solicitud HTTP en formato JSON. A continuación, se detallan los parámetros requeridos:

Parámetro	Tipo	Descripción
user_id	string	Identificador único (UUID) del usuario asociado al préstamo.
financial_entity_id	string	Identificador único (UUID) de la entidad financiera en la que se creará el préstamo.
interest_rate_basis	string	Base de tasa de interés para el préstamo (“annual” o “monthly”).
loan_type	string	Tipo de préstamo (“rotative”, “free-investment” o “ipc_indexed”).
amount	float	Monto del préstamo.
interest_rate	float	Tasa de interés del préstamo.
arrear_interest_rate	float	Tasa de interés moratorio del préstamo (solo para préstamos rotativos).
payment_frequency	string	Frecuencia de pago del préstamo (“weekly”, “biweekly”, “monthly”, “bimonthly”, “quarterly” o “annually”).
term	int	(Opcional): Número de períodos del préstamo (solo para préstamos no rotativos).
payment_amount	float	(Opcional): Monto de pago del préstamo (solo para préstamos no rotativos).
other_expenses	list	Lista de gastos adicionales asociados al préstamo (opcional).
assignment_date	string	Fecha de asignación del préstamo en formato ISO 8601.
cut_off_date	string	Fecha de corte del préstamo en formato ISO 8601.
grace_period	int	Período de gracia del préstamo (opcional).
interest_free_period	int	Período de interés libre del préstamo (opcional).
billing_interval_type	string	Tipo de intervalo de facturación del préstamo (“to_cutoff_date” o “monthly”).
tax_rate	float	Tasa de impuestos del préstamo.

Encabezados #

Respuesta esperada #

El método devuelve una respuesta en formato JSON con los siguientes campos:

• En caso de éxito, la respuesta tendrá el código de estado 200 y contendrá los siguientes datos:

{
  "loan_id": "abc123",
  "user_id": "user123",
  "financial_entity_id": "entity456",
  "loan_type": "personal",
  "amount": 10000,
  "interest_rate": 8.5,
  "term": 12,
  "payment_amount": 900,
  "payment_frequency": "monthly",
  "other_expenses": [
    {
      "name": "insurance",
      "amount": 100
    },
    {
      "name": "processing_fee",
      "amount": 50
    }
  ],
  "assignment_date": "2023-04-26T10:00:00Z",
  "cut_off_date": "2024-04-26T10:00:00Z"
}

Ejemplos de uso #

Python #

import requests

url = "https://api.leancore.co/create-loan"
headers = {
    "Authorization": "Bearer <token>"
}
payload = {
    "user_id": "123456",
    "financial_entity_id": "789012",
    "interest_rate_basis": "monthly",
    ...
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(data)