Crear una Transacción de Salida
Utilice este endpoint para iniciar una transacción de salida, abstrayendo el proceso de mover fondos desde cuentas internas del Ledger hacia el mundo externo.
En lugar de requerir todos los detalles de la transacción, solo necesita proporcionar las cuentas de origen. Según el activo proporcionado, el sistema incluye automáticamente la cuenta externa correspondiente en la sección distribute de la transacción.
Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Encabezados
El token de autorización. Este encabezado es requerido si su entorno tiene Access Manager habilitado.
El tipo de medio del recurso. El valor recomendado es application/json.
Un identificador único utilizado para rastrear y seguir cada solicitud.
Una clave única que garantiza la idempotencia de la transacción. Si no se proporciona, el sistema genera automáticamente un hash SHA-256 basado en el cuerpo de la solicitud. Las claves están delimitadas por organización y ledger.
Siempre valide el header de respuesta X-Idempotency-Replayed para distinguir transacciones nuevas de reproducciones en caché.
Consulte Reintentos e idempotencia para mejores prácticas.
El tiempo de vida (TTL) de la clave de idempotencia, definido en segundos. Si no se proporciona, el valor predeterminado es 300 segundos (5 minutos). Solo se usa el TTL de la primera solicitud; cambiarlo en reintentos no tiene efecto.
Consulte Reintentos e idempotencia para más detalles.
Parámetros de ruta
El identificador único de la Organización asociada al Ledger.
El identificador único del Ledger asociado.
Cuerpo
The chart of accounts group name which categorizes this transaction under a specific group.
Transaction code for reference.
100Indicates whether the transaction should follow a two-step process: authorization followed by execution. When set to true, the transaction is created in a pending state, reserving funds (on_hold) without immediately moving them. A subsequent commit is required to finalize the transfer.
A description for the transaction.
Especifica la Ruta de Transacción asociada a la transacción. Importante: Cuando la validación de Enrutamiento de Transacciones está habilitada para su Ledger, este campo se vuelve obligatorio y debe coincidir con un id existente de sus Rutas de Transacción configuradas. Sin embargo, cuando la validación está deshabilitada (comportamiento predeterminado), este campo es opcional y acepta cualquier cadena de formato libre.
El identificador único (UUID) de la Ruta de Transacción a asociar con esta transacción.
La fecha en que se realizó la transacción. Se usa para agregar transacciones pasadas. Debe ser una fecha en el pasado.
An object containing information about the transaction that will be sent.
An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.
Respuesta
Indica que el recurso fue creado exitosamente y la operación se completó como se esperaba.
La respuesta incluye el header X-Idempotency-Replayed.
Si el valor es false, la transacción fue recién procesada. Si el valor es true, la respuesta es una repetición de una solicitud procesada anteriormente.
Consulte Reintentos e idempotencia para más detalles.
The unique identifier of the transaction.
El identificador único de la transacción padre/original para reversiones. Este campo es completado por el servidor cuando una transacción es revertida y debe ser tratado como solo lectura por los clientes.
The unique identifier of the Organization.
El identificador único del Ledger.
Description of the transaction.
Specifies the Transaction Route associated with the transaction.
El identificador único de la Ruta de Transacción aplicada a esta transacción.
The transaction status (pending, completed, reversed).
The sent amount.
The name of the asset used in the operation.
The name of the chart-of-accounts group.
The list of accounts used as source.
The list of accounts used as destination.
Timestamp of creation (UTC).
Timestamp of last update (UTC).
Timestamp of soft deletion, if applicable (UTC).
An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.