Requisitos
Para reembolsar un pago, necesitas:- Acceder a tus credenciales de API en el Yuno Dashboard, que constan de:
public-api-keyprivate-secret-key
- Tener los datos de identificación del pago recibidos después de crearlo con el endpoint Create Payment y los datos de captura de la operación de captura ejecutada con el endpoint Capture Payment:
id: el identificador único del pago, que se obtiene del parámetroiddespués de crear el pago.transaction_id: el identificador único de la transacción. Obtendrás esta información de una fuente distinta, según cómo hayas capturado el pago.- Si creaste y capturaste el pago con una sola operación, obtienes el
transaction_iddel parámetrotransaction.iddespués de crear el pago con el endpoint Create Payment. - Si realizaste la autorización y luego la captura del pago, usarás el
transaction_iddel parámetroidque recibes después de capturar el pago con el endpoint Capture Payment. - Si consultas el pago más tarde con el endpoint Retrieve Payment by ID, toma del arreglo
transactionselidde la transacción cuyotypeseaPURCHASEoCAPTURE. Elidde una transacciónREFUNDno se puede usar para reembolsar.
- Si creaste y capturaste el pago con una sola operación, obtienes el
Explora las colecciones de Postman de YunoYuno ofrece colecciones de Postman que puedes usar para replicar los casos de uso de forma local.
Reembolsar un pago
Si inicias un reembolso, se devolverá el dinero de un cobro creado anteriormente que aún no se haya reembolsado. El monto se acreditará al método de pago original con el que se realizó el cobro. Yuno ofrece tres endpoints para reembolsar un pago. Comparten el mismo cuerpo de solicitud, y cada llamada requiere un encabezadoX-Idempotency-Key con un valor nuevo en cada intento:
- Refund Payment: reembolsa una transacción específica. Envía el
iddel pago y eltransaction_id. Úsalo cuando quieras controlar exactamente qué transacción se reembolsa. - Cancel or Refund a Payment: funciona a nivel del pago, por lo que no se necesita
transaction_id. Yuno cancela el pago si no se ha capturado y lo reembolsa si ya se capturó. El camporeasones obligatorio. - Cancel or Refund a Payment with Transaction: aplica la misma decisión automática a un
transaction_idespecífico.
amount en el cuerpo de la solicitud:
- Reembolso total: deja
amountvacío. - Reembolso parcial: envía el valor del reembolso con el parámetro
amount.
Pagos con una promoción de YunoUn reembolso se calcula sobre lo que pagó el cliente, es decir,
amount.value menos discount_amount. Un reembolso total devuelve ese monto y pasa el pago a REFUNDED, y un amount superior al que queda por reembolsar se rechaza con 400 INVALID_PARAMETERS. Consulta Promotions.Resultados del reembolso
La respuesta contiene una nueva transacción contransaction.type = REFUND. Usa su status para interpretar el resultado del reembolso:
SUCCEEDED: el proveedor aceptó el reembolso. En un reembolso total, el pago pasa astatus = REFUNDEDysub_status = REFUNDED. En un reembolso parcial, el pago mantienestatus = SUCCEEDEDy susub_statuscambia aPARTIALLY_REFUNDED.PENDING: el proveedor confirma el reembolso de forma asíncrona. El pago muestrastatus = REFUNDEDysub_status = PENDING_PROVIDER_CONFIRMATIONhasta que llegue la confirmación. Usa webhooks o los endpoints de consulta para obtener el estado final, como se describe en Verificar el estado del pago.DECLINEDoERROR: el proveedor, o el emisor del titular de la tarjeta, rechazó el reembolso. No se mueven fondos y el pago mantiene sustatusysub_statusanteriores. Revisa elresponse_codey elresponse_messagede la transacción para conocer el motivo. Una vez resuelta la causa, vuelve a enviar el reembolso con un nuevoX-Idempotency-Key, o establecesimplified_modeentrueen la solicitud para que Yuno reintente el reembolso automáticamente, como se describe en Transaction Retries.
Comportamiento que depende del proveedorQue un reembolso se confirme de forma síncrona o quede en
PENDING, que se permitan reembolsos parciales y varios reembolsos sobre la misma transacción, y durante cuánto tiempo después de la compra se acepta un reembolso, todo depende del proveedor que procesó el pago. Muchos adquirentes de tarjetas procesan un reembolso como una transacción en línea contra la cuenta del titular de la tarjeta y responden de inmediato con un estado final, lo que también significa que el emisor puede rechazarlo. Si tu integración depende de alguno de estos comportamientos, confírmalos con Yuno para los proveedores de tu enrutamiento.Tiempo de procesamiento del reembolsoEl tiempo de procesamiento de los reembolsos varía según el tipo de pago. En modo de prueba, los reembolsos se procesan al instante en el entorno de Sandbox. Si tu conexión de sandbox apunta al entorno de pruebas del propio proveedor, el reembolso se envía a ese entorno y requiere antes una compra de prueba exitosa.
Verificar el estado del pago
Si, por algún motivo, necesitas confirmar el reembolso del pago:- Usa Retrieve Payment by ID o Retrieve Payment by merchant_order_id para obtener información detallada sobre el pago.
- También puedes configurar webhooks para recibir notificaciones de cada evento. Consulta la guía de Webhooks para aprender a configurar webhooks en Yuno.