Saltar al contenido principal
POST
No ejecutes un reembolso mientras otro está en curso. Espera a que la operación actual termine antes de iniciar una nueva.
Este endpoint te permite emitir un reembolso para un pago existente. Si especificas un amount, se creará un reembolso parcial. Si omites el amount, se procesará un reembolso total del pago original.
Pagos con una promoción de YunoUn reembolso se calcula sobre lo que pagó el cliente, amount.value menos discount_amount. Un reembolso total devuelve ese monto, y un amount superior a lo que queda por reembolsar se rechaza con 400 INVALID_PARAMETERS. Consulta Promotions.
Pagos aprobados parcialmentePara un pago con tarjeta enviado con payment_method.detail.card.partial_approval: true y aprobado por menos de lo solicitado, los reembolsos se limitan a amount.authorized. Un reembolso total devuelve amount.authorized, y un amount superior a lo que queda de ese monto se rechaza con 400 INVALID_PARAMETERS.
Los reembolsos solo se pueden crear para cargos que aún no han sido reembolsados. El monto reembolsado se devolverá al método de pago original usado en la transacción. Ten en cuenta que esta solicitud requiere un X-Idempotency-Key. Consulta la página Authentication para obtener más información.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido
X-Idempotency-Key
string
header
predeterminado:<Your X-Idempotency-Key>
requerido

Parámetros de ruta

id
string
requerido

El identificador único del pago (UUID, 36 caracteres).

transaction_id
string
requerido

El identificador único de la transacción (UUID, 36 caracteres).

Cuerpo

application/json
merchant_reference
string
requerido

Identificación de la transacción de pago definida por el comercio (MAX 255; MIN 3).

description
string

Descripción del reembolso. (MAX 255; MIN 3).

reason
enum<string>

Indica el motivo del reembolso. Si se define, los valores posibles son DUPLICATE, FRAUDULENT, REQUESTED_BY_CUSTOMER y REVERSE. Usa REVERSE para solicitar una reversión automática de los fondos del destinatario cuando hay un destinatario involucrado en la transacción.

Opciones disponibles:
DUPLICATE,
FRAUDULENT,
REQUESTED_BY_CUSTOMER,
REVERSE
amount
object

Especifica el objeto de monto para el reembolso. Solo es obligatorio para reembolsos parciales.

split_marketplace
object[]

Array de objetos de split marketplace

simplified_mode
boolean

Determina si Yuno debe intentar reembolsar automáticamente un pago después de un error o rechazo inicial. Cuando se establece en true, Yuno reintenta el proceso si el primer intento falla. Por defecto, es false. Accede a Reintentos de transacciones para más detalles.

response_additional_data
object

Especifica datos adicionales requeridos para la respuesta de la transacción

customer_payer
object

Indica el objeto customer de los pagos.

payment_method
object

Especifica el objeto de método de pago para los pagos.

Respuesta

201

id
string
Ejemplo:

"f2d6884a-f737-4565-ae32-ff60b19089e3"

account_id
string
Ejemplo:

""

description
string
Ejemplo:

"Duplicate"

country
string
Ejemplo:

"US"

status
string
Ejemplo:

"REFUNDED"

sub_status
string
Ejemplo:

"REFUNDED"

merchant_order_id
string
Ejemplo:

"AAB01-432245"

created_at
string
Ejemplo:

"2025-04-14T17:51:45.179645Z"

updated_at
string
Ejemplo:

"2025-04-14T17:52:07.908698Z"

amount
object
discount_amount
object

El descuento total de la promoción de Yuno aplicada al pago: la suma de las líneas YUNO_PROMOTION de additional_data.order.discounts. No aparece cuando no se aplicó ninguna promoción. El monto cobrado es amount.value menos este valor, y está en transactions.amount. Consulta Promociones.

checkout
object
payment_method
object
customer_payer
object
additional_data
any
transactions
object
transactions_history
any
metadata
array
fraud_screening
any
Ejemplo:

""

subscription_code
any
routing_rules
any
simplified_mode
boolean
predeterminado:true
Ejemplo:

false