Crear transacción

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