Crear transacción #
Este método permite crear una transacción entre dos usuarios o comercios existentes en el ecosistema. Se deben proporcionar los detalles del pagador y el receptor de la transacción, así como cualquier información adicional relevante que pueda respaldar la trazabilidad del pago.
URL del endpoint #
POST /create-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": "<id_transaccion>",
"from_user_id": "<id_pagador>",
"to_user_id": "<id_receptor>",
"amount": "<monto>",
"date": "<fecha>",
"from_user": "<nombre_pagador>",
"to_user": "<nombre_receptor>",
"status": "<estado>",
"details": {
"field1": "value1",
"field2": "value2"
},
"reference": "<referencia>"
}
Ejemplos de uso #
Python #
import requests
import json
url = "https://api.leancore.co/create-transaction"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
data = {
"from_user_id": "<id_pagador>",
"to_user_id": "<id_receptor>",
"amount": 100.0,
"date": "2023-04-26",
"status": "pending",
"details": {
"field1": "value1",
"field2": "value2"
}
}
response = requests.post(url, headers=headers, data=json.dumps(data))
transaction = response.json()
print("Transaction ID:", transaction["id"])
print("From User:", transaction["from_user"])
print("To User:", transaction["to_user"])
print("Amount:", transaction["amount"])