Crear transacción de billetera #
Este método permite crear una transacción entre dos usuarios o comercios existentes en el ecosistema. Se deben definir los campos del pagador y el receptor de la transacción, además de los detalles de información útil que puedan argumentar la trazabilidad del pago.
URL del endpoint #
POST /create-ledger-transaction
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 from_user_id string Identificador único (UUID) del pagador to_user_id string Identificador único (UUID) del receptor amount float Monto de la transacción date string Fecha de la transacción en formato ISO8601 status string Estado de la transacción details object Información adicional (opcional)
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": "1d58d1bc-0f84-49d1-b82f-aaf4778af577",
"from_user_id": "2fdd5591-49d4-42d9-92b2-7f3ce1c52ef5",
"to_user_id": "3f6e86de-7c9f-4a70-9076-6d8f6b66a450",
"amount": 100.5,
"date": "2023-04-26",
"from_user": "Usuario A",
"to_user": "Usuario B",
"status": "pending",
"details": {
"description": "Pago de factura",
"reference_number": "ABC123"
},
"reference": "Transaction123"
}
Ejemplos de uso #
Python #
import requests
import json
url = "https://api.leancore.co/create-ledger-transaction"
headers = {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
}
data = {
"from_user_id": "2fdd5591-49d4-42d9-92b2-7f3ce1c52ef5",
"to_user_id": "3f6e86de-7c9f-4a70-9076-6d8f6b66a450",
"amount": 100.50,
"date": "2023-04-26",
"details": {
"description": "Pago de factura",
"reference_number": "ABC123"
}
}
response = requests.post(url, headers=headers, data=json.dumps(data))
data = response.json()
if response.status_code == 200:
# Procesar los datos de la transacción creada
print(data)
else:
# Manejar el error de creación de transacción
print(data["message"])