Saltar al contenido principal
Una Transacción mueve valor entre Cuentas en un Ledger. Créala solo cuando el Activo, la cuenta de origen, la cuenta de destino y cualquier Ruta Contable requerida estén listos.

​
Antes de empezar

Confirma que:
  • Las Cuentas de origen y destino existen en el Ledger seleccionado.
  • Ambas Cuentas usan el Activo seleccionado para la Transacción.
  • Conoces el alias de cada Cuenta, incluido el prefijo @.
  • Las cuentas de origen permiten enviar y las cuentas de destino permiten recibir.
  • Si Validate Routes está habilitado, la Transacción coincide con una Ruta Contable existente.

​
Crear la Transacción

1
Desde la página Transactions, haz clic en el botón New Transaction.
2
Se abrirá el modal New Transaction. Selecciona el tipo de transacción que quieres crear:
  • Simple 1:1 - Transacciones con un origen y un destino
  • Complex n:n - Transacciones con más de un origen o destino
3
Tras seleccionar el tipo de transacción, se abre la página New Transaction con un formulario paso a paso:
1

Transaction Data

Completa la información básica de la transacción:
  • (Opcional) Añade una Description para la transacción
  • (Opcional) Especifica un Accounting route group para clasificación
  • Introduce el Value (importe) a transferir
  • Selecciona el Asset que se usará en la transacción
2
Haz clic en Next para avanzar al paso de selección de cuentas.
3

Source and Destination

Especifica las cuentas involucradas:
  • Busca la cuenta de origen por alias y selecciónala
  • Busca la cuenta de destino por alias y selecciónala
  • Para transacciones complejas, puedes añadir múltiples orígenes y/o destinos
Debes usar el alias de la cuenta para realizar transacciones. Asegúrate de guardarlo al crear la cuenta.Si lo olvidas, puedes encontrarlo editando la información de la cuenta.
4
Haz clic en Next para avanzar al paso de operaciones.
5

Operations

Revisa y ajusta los detalles de la operación:
  • En transacciones simples (1:1), los importes se completan automáticamente
  • En transacciones complejas (n:n), especifica el importe para cada origen (débito) y destino (crédito)
  • Expande cada operación para añadir descripciones y metadatos opcionales
En las transacciones complejas, la suma de todos los importes de origen debe ser igual a la suma de todos los importes de destino.
4
Cuando toda la información sea correcta, haz clic en el botón Go to Review.
5
Se mostrará una página de revisión con un resumen de toda la información de la transacción:
  • Valor y Activo de la transacción
  • Cuentas de origen y destino
  • Operaciones individuales de débito y crédito
  • Registros de metadatos (si los hay)
6
Revisa la información cuidadosamente. Si todo es correcto:
  • Haz clic en Send Transaction para enviar y ver los detalles de la transacción
  • Haz clic en Send and Create another para enviar e iniciar inmediatamente una nueva transacción
7
Al tener éxito, serás redirigido a la página de detalles de la transacción mostrando el resumen, los datos y el estado.

​
Guía de campos

CampoQué introducirEjemplo
Transaction typeElige Simple 1:1 para un origen y un destino, o Complex n:n para múltiples orígenes o destinos.Simple 1:1
DescriptionDescripción de negocio opcional del movimiento.Customer payment to merchant
Accounting route groupClasificación opcional de ruta cuando tu configuración usa validación o agrupación de rutas.Pix Transfer Route
ValueImporte total a mover. En transacciones complejas, los totales de origen deben ser iguales a los de destino.100.00
AssetActivo usado por la Transacción. Debe coincidir con las Cuentas seleccionadas.BRL
Source accountAlias de la cuenta que será debitada. Incluye el prefijo @.@customer_123
Destination accountAlias de la cuenta que será acreditada. Incluye el prefijo @.@merchant_456
Operation amountImporte asignado a cada operación de origen o destino. Requerido en transacciones complejas.100.00
Metadata KeyNombre opcional de campo para clasificación o integración.externalReference
Metadata ValueValor para la clave de metadatos.order_98765

​
Tipos de transacción explicados

​
Simple Transaction (1:1)

Úsala para transferencias directas entre dos cuentas:
  • Una cuenta de origen (débito)
  • Una cuenta de destino (crédito)
  • Mismo importe debitado y acreditado
Ejemplo: Transferir $100 del Customer A al Merchant B.

​
Complex Transaction (n:n)

Úsala para transacciones que involucran múltiples partes:
  • Múltiples cuentas de origen (débitos) y/o múltiples cuentas de destino (créditos)
  • Los importes pueden distribuirse entre cuentas
  • El total de débitos debe ser igual al total de créditos
Ejemplos:
  • Pago con tarifas:
    • El cliente paga $103
    • El comercio recibe $100
    • La cuenta de tarifas recibe $3
  • Pago consolidado: Múltiples clientes financian un único pago a proveedor
Los campos en la pestaña Metadata son abiertos. No hay claves ni valores predefinidos. Usa nombres de claves consistentes en toda tu Organización, como externalReference, orderId o channel, para vincular las Transacciones con los sistemas de origen para conciliación y auditoría.

​
Qué hacer a continuación

Tras enviar la Transacción, revisa la página de detalles y confirma el estado, la operación de origen, la operación de destino y los saldos de las cuentas.

Crear una Transaction con JSON

Crea una Transacción programáticamente con el endpoint JSON.

Recuperar una Transaction

Inspecciona el estado y las operaciones de la Transacción mediante la API.