Revertir una Transacción
Utilice este endpoint para revertir una transacción existente generando automáticamente una nueva en la dirección opuesta a la original.
La nueva transacción se vincula a la original usando el campo parentTransactionId, asegurando la trazabilidad completa entre ambas operaciones.
Importante: Solo las transacciones con estado APPROVED pueden ser revertidas. Si la transacción original ya tiene un padre (es decir, ya fue revertida), la solicitud será rechazada. On success this endpoint creates the reversing transaction and returns 201 Created with the created transaction payload.
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.
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.
El identificador único de la transacción que desea recuperar.
Respuesta
Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.
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.
The unique identifier of the parent/original transaction for reversals. This field is populated by the server when a transaction is reverted and should be treated as read-only by clients.
The unique identifier of the Organization.
El identificador único del Ledger.
Description of the transaction.
Specifies the Transaction Route associated with the transaction.
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'.