Obtener historial de transacciones de tipo billetera para un usuario

Obtener historial de transacciones de tipo billetera para un usuario #

Este método retorna un objeto con el histórico de transacciones de tipo billetera registradas por un usuario o comercio determinado usando su identificador único (UUID) como parámetro de consulta.

URL del endpoint #

GET /ledger-transaction-history

Parámetros de entrada #

Parámetro Tipo Descripción
user-id string El identificador único del usuario o comercio.
limit int (Opcional) El número máximo de transacciones a retornar.
offset int (Opcional) El desplazamiento para paginación de los resultados.
with_loans bool (Opcional) Indica si se deben incluir préstamos relacionados en el historial de transacciones. Valor predeterminado: False.

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": "7d7a3fb8-41d6-4f4f-8e6f-5e60e33e989c",
    "from_user": "Jane Smith",
    "from_user_id": "c628f118-2a6c-4cb7-a7b3-981042f0d146",
    "to_user": "John Doe",
    "to_user_id": "8001f741-39c0-4474-9a20-81094efb98d0",
    "status": "completed",
    "amount": 100.0,
    "date": "2023-04-25",
    "details": {},
    "reference": "",
    "loan": {
      "loan_product_name": "Personal Loan",
      "loan_type": "consumer",
      "amount": 5000.0,
      "interest_rate": 5.0,
      "term": 12,
      "status": "approved",
      "disbursed": true
    }
  }
]

Ejemplos de uso #

Python # 

import requests

url = "https://api.leancore.co/ledger-transaction-history"
params = {"user-id": "89530355-4f90-4891-a6e7-dcd74086d136"}
headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, params=params, headers=headers)
data = response.json()

if response.status_code == 200:
    transactions = data
    for transaction in transactions:
        print("Transaction ID:", transaction["id"])
        print("From User:", transaction["from_user"])
        print("To User:", transaction["to_user"])
        print("Amount:", transaction["amount"])
        print("Date:", transaction["date"])
        print("---")
else:
    print("Error:", data["message"])