Obtener créditos de un usuario de una Fintech

Obtener créditos de un usuario de una Fintech #

Este método permite obtener los créditos de un usuario perteneciente a una Fintech según su número de identificación.

URL del endpoint #

POST /fintech-user-loans

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
financialEntityId str ID de la entidad financiera
userNID str Número de identificación del usuario

Encabezados #

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

Respuesta esperada #

La respuesta contendrá los créditos del usuario de la Fintech.

  • En caso de éxito, la respuesta tendrá el código de estado 200 y contendrá los siguientes datos:
{
  "id": ["ID del usuario"],
  "name": ["Nombre del usuario"],
  "lastname": ["Apellido del usuario"],
  "business_name": ["Nombre de la empresa"],
  "status": ["Estado del usuario"],
  "loans": [
    {
      "id": ["ID del crédito"],
      "amortization": ["Amortización del crédito"],
      "period": ["Período del crédito"],
      "assignment_date": ["Fecha de asignación del crédito"],
      "cut_off_date": ["Fecha de corte del crédito"],
      "payment_date": ["Fecha de pago del último período"]
    }
  ]
}
  • En caso de error, se devolverá una respuesta con el código de estado correspondiente y un mensaje de error.

Ejemplos de uso #

Python # 

import requests
import json

url = "https://api.leancore.co/fintech-user-loans"
headers = {
    "Authorization": "Bearer [Token de acceso]"
}
payload = {
    "financialEntityId": "ID de la Fintech",
    "userNID": "Número de identificación del usuario"
}

# Realizar la solicitud POST
response = requests.post(url, headers=headers, json=payload)

# Obtener la respuesta en formato JSON
data = response.json()

# Procesar la respuesta
if response.status_code == 200:
    # Éxito: acceder a los datos del usuario y sus créditos
    user_id = data["id"]
    user_name = data["name"]
    user_lastname = data["lastname"]
    business_name = data["business_name"]
    user_status = data["status"]
    loans = data["loans"]
    # Procesar los datos de cada crédito
    for loan in loans:
        loan_id = loan["id"]
        amortization = loan["amortization"]
        period = loan["period"]
        assignment_date = loan["assignment_date"]
        cut_off_date = loan["cut_off_date"]
        payment_date = loan["payment_date"]
        # Realizar acciones con los datos del crédito
    # Realizar acciones con los datos del usuario y créditos
else:
    # Error: mostrar mensaje de error
    error_message = data["message"]
    print(f"Error {response.status_code}: {