Saltar al contenido principal
POST
Reverse Standalone Transfer
Revierte total o parcialmente una transferencia PLATFORM_TO_RECIPIENT, según su estado y el monto reversible restante. Una transferencia principal RECIPIENT_TO_PLATFORM no se puede revertir: tanto las solicitudes de reversión total como parcial devuelven 400 INVALID_PARAMETERS. Para devolver una comisión cobrada por separado, crea una nueva transferencia con direction: PLATFORM_TO_RECIPIENT. La respuesta HTTP de la reversión describe la transferencia principal después de la reversión y no incluye direction. Usa GET para leer la dirección sin cambios de la transferencia principal. La notificación de la reversión incluye la dirección PLATFORM_TO_RECIPIENT de la transferencia principal.

Autorizaciones

PUBLIC-API-KEY
string
header
requerido
PRIVATE-SECRET-KEY
string
header
requerido

Encabezados

X-Idempotency-Key
string
requerido

Clave única para la idempotencia de la solicitud.

Parámetros de ruta

transfer_id
string
requerido

El ID único del flujo de transferencia que se revertirá.

Cuerpo

application/json
account_id
string
requerido

El identificador único de la cuenta.

reason
string
requerido

El motivo de la reversión. Obligatorio: la API devuelve 400 INVALID_PARAMETERS ("The field 'reason' is required.") cuando falta.

amount
object
description
string

Una descripción legible de la reversión.

merchant_reference
string

Identificador único del comercio para dar seguimiento a esta reversión.

Respuesta

Reversión procesada

La transferencia padre después de una reversión. La dirección está disponible mediante GET, no en esta respuesta.

id
string
Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

recipient_id
any
amount
any
status
string
Ejemplo:

"REVERSED_PARTIAL"

reason
any
description
any
merchant_reference
any
provider_data
object | null
created_at
any
updated_at
any
transactions
any