Pagar crédito #

Este método permite procesar una transacción de pago realizada por un usuario o comercio, definiendo la información del pagador y los detalles necesarios para la trazabilidad del pago.

URL del endpoint #

POST /pay-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

id string Identificador único (UUID) del del préstamo a pagar.

nid string (Opcional) ID del usuario asociado al préstamo.

amount float Monto del pago realizado.

date string Fecha del pago en formato ISO8601.

details object Detalles adicionales del pago.

details.regular_payment bool Indica si el pago es un pago regular.

details.payment_type string Tipo de pago. Valores posibles: “automatic”, “regular_payment”, “term_decrease”, “partial_payment”, “payment_advance”, “payment_amount_decrease”, “full_payment”.

Parámetro	Tipo	Descripción
id	string	Identificador único (UUID) del del préstamo a pagar.
nid	string	(Opcional) ID del usuario asociado al préstamo.
amount	float	Monto del pago realizado.
date	string	Fecha del pago en formato ISO8601.
details	object	Detalles adicionales del pago.
details.regular_payment	bool	Indica si el pago es un pago regular.
details.payment_type	string	Tipo de pago. Valores posibles: “automatic”, “regular_payment”, “term_decrease”, “partial_payment”, “payment_advance”, “payment_amount_decrease”, “full_payment”.

Encabezados #

Encabezado	Valor
Authorization	Bearer {token}
Content-Type	application/json

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:

{
  "id": "19e30fac-1bb3-4c8f-a19a-114c67a3dde9",
  "user_id": "3a620481-9f3a-4b8d-a96f-95606fc50f6e",
  "financial_entity_id": "17b34523-8f51-4e7a-b4f8-29a051ed6801",
  "loan_product_name": "Préstamo Personal",
  "loan_type": "Personal",
  "amount": 5000.0,
  "interest_rate": 8.5,
  "interest_rate_basis": "monthly",
  "other_expenses": [],
  "term": 24,
  "payment_amount": 250.0,
  "payment_frequency": "monthly",
  "amortization": [
    {
      "payment_date": "2023-05-01",
      "principal_amount": 200.0,
      "interest_amount": 50.0,
      "total_amount": 250.0
    },
    {
      "payment_date": "2023-06-01",
      "principal_amount": 200.0,
      "interest_amount": 49.17,
      "total_amount": 249.17
    }
  ],
  "period": 1,
  "assignment_date": "2023-04-01",
  "disbursement_date": "2023-04-05",
  "cut_off_date": "2023-04-30",
  "grace_period": 0,
  "grace_period_interest_payment": false,
  "interest_free_period": 0,
  "disbursed": true,
  "additional_data": {},
  "billing_interval_type": "monthly",
  "arrear_interest_rate": 0.0,
  "arrear_interest_rate_basis": "monthly",
  "arrear_max_interest_rate": false,
  "tax_rate": 0.0,
  "status": "active",
  "initial_charges": []
}

Ejemplos de uso #

Python #

import requests
import json

url = 'https://api.leancore.co/pay-loan'
headers = {'Authorization': 'Bearer <token>'}
data = {
    "nid": "123456789",
    "id": "loan123",
    "amount": 1000,
    "date": "2023-04-26",
    "details": {
        "regular_payment": True,
        "payment_type": "automatic"
    }
}

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