- Reembolsos referenciados: revierten un solo pago capturado por Yuno mediante la API. Es el flujo estándar de reembolso por atención al cliente.
- Reembolsos por lotes: procesan hasta 1,000 reembolsos a la vez al cargar un CSV en el Yuno Dashboard. Los equipos de operaciones los usan para eventos de retiro de productos, barridos por fraude y reembolsos masivos.
- Reembolsos sin referencia: envían fondos a un método de pago sin referenciar un pago original de Yuno. Consulta Reembolsos sin referencia más abajo.
Flujos de reembolso que Yuno admite
Reembolso referenciado (individual, mediante API)
Un reembolso referenciado devuelve el dinero de un pago capturado por Yuno. Llamas aPOST /v1/payments/{id}/refunds con el id del pago, el transaction_id que se va a reembolsar y un objeto amount opcional. Deja amount vacío para un reembolso total, o especifica un value y una currency para un reembolso parcial. El reembolso se acredita al mismo método de pago con el que se realizó el cobro original.
Cuando un reembolso referenciado es exitoso, el pago principal pasa a status = REFUNDED / sub_status = REFUNDED, y se agrega una nueva transacción con transaction.type = REFUND y transaction.status = SUCCEEDED. Los webhooks se envían como de costumbre.
Reembolso por lotes (masivo, mediante Dashboard)
La función de reembolso por lotes del Yuno Dashboard permite que tu equipo procese reembolsos de varias transacciones al mismo tiempo, lo que ahorra tiempo y trabajo manual. Cada fila del CSV cargado referencia un pago existente de Yuno. Cómo usarla- Ve a All payments → Batch refunds → Upload.
- Descarga la plantilla de ejemplo y complétala. Columnas obligatorias:
Payment IDTransaction IDAmount to refundCurrencyMerchant referenceReason: uno deDUPLICATE,FRAUDULENT,REQUESTED_BY_CUSTOMER
- Carga el CSV. Yuno valida cada fila y pone los reembolsos en cola.
- Supervisa el progreso en All payments → Batch refunds → Overview.
Reembolso sin referencia (crédito independiente, mediante API)
Un reembolso sin referencia, también llamado crédito o reembolso independiente, devuelve fondos a un método de pago sin referenciar un pago original de Yuno. Es esencial cuando el cobro que se reembolsa se realizó fuera de Yuno, o cuando el comercio necesita enviar un crédito promocional o de cortesía. El resto de esta página explica de principio a fin cómo funcionan los reembolsos sin referencia.Reembolsos sin referencia
Los reembolsos sin referencia de Yuno son una solución de API diseñada para emitir reembolsos directamente a un método de pago sin referenciar una transacción de pago original. En la terminología de gateway, esto corresponde a la operaciónoperation_type: "Credit".
Te permite enviar fondos a una tarjeta, cuenta bancaria, mandato o billetera que no necesariamente se cobró a través de Yuno, y unifica más de 28 proveedores de pago detrás de un único contrato de API.
Cómo funcionan los reembolsos sin referencia
Un reembolso sin referencia pasa por una pequeña máquina de estados que replica el ciclo de vida estándar de pagos de Yuno.CREATED: Yuno guarda el reembolso después de validar la solicitud y enrutarla a un proveedor compatible.PENDING: el proveedor aceptó el reembolso y espera la liquidación asíncrona (compensación ACH, liquidación SEPA, etc. pagado).- Estados finales:
SUCCEEDED: los fondos se confirmaron en el método de pago de destino (ya sea con liquidación síncrona, por ejemplo Stripe, o con liquidación asíncrona mediante un webhook del proveedor).FAILED: el proveedor rechazó el reembolso, devolvió los fondos, se encontró con OFAC/sanciones, superó el SLA o hubo cualquier otro error irrecuperable. El detalle está enprovider.response_codeyprovider.response_message.
status:
Uso de los reembolsos sin referencia de Yuno
Para emitir un reembolso sin referencia, llama al endpointPOST /v1/unreferenced-refunds con:
account_id,merchant_order_id,description,country,amount- Un
payment_methodque describa el destino (token almacenado, tarjeta sin tokenizar, transferencia bancaria o billetera) - Un bloque
customer_payercon la identidad del destinatario (obligatorio para ACH / SEPA / PayPal, para cumplir con los controles de OFAC y AML) - Opcionalmente,
provider_data.idpara fijar un gateway específico
201 Created con un id con el prefijo urf_*, y se enviará un webhook cuando el reembolso llegue a su estado final.