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 #

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"])