Saltar al contenido principal
En esta guía encontrarás instrucciones para reembolsar un pago creado previamente en Yuno.

Requisitos

Para reembolsar un pago, necesitas:
  • Acceder a tus credenciales de API en el Yuno Dashboard, que constan de:
    • public-api-key
    • private-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ámetro id despué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_id del parámetro transaction.id despué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_id del parámetro id que 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 transactions el id de la transacción cuyo type sea PURCHASE o CAPTURE. El id de una transacción REFUND no se puede usar para reembolsar.
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 encabezado X-Idempotency-Key con un valor nuevo en cada intento:
  • Refund Payment: reembolsa una transacción específica. Envía el id del pago y el transaction_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 campo reason es obligatorio.
  • Cancel or Refund a Payment with Transaction: aplica la misma decisión automática a un transaction_id específico.
Además, debes indicar el monto que se va a reembolsar con el objeto amount en el cuerpo de la solicitud:
  • Reembolso total: deja amount vací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.
Un reembolso a la vezNo inicies un nuevo reembolso sobre la misma transacción mientras otro anterior siga en curso. Espera a que el reembolso anterior llegue a un estado final (SUCCEEDED, DECLINED o ERROR) antes de enviar el siguiente.

Resultados del reembolso

La respuesta contiene una nueva transacción con transaction.type = REFUND. Usa su status para interpretar el resultado del reembolso:
  • SUCCEEDED: el proveedor aceptó el reembolso. En un reembolso total, el pago pasa a status = REFUNDED y sub_status = REFUNDED. En un reembolso parcial, el pago mantiene status = SUCCEEDED y su sub_status cambia a PARTIALLY_REFUNDED.
  • PENDING: el proveedor confirma el reembolso de forma asíncrona. El pago muestra status = REFUNDED y sub_status = PENDING_PROVIDER_CONFIRMATION hasta 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.
  • DECLINED o ERROR: el proveedor, o el emisor del titular de la tarjeta, rechazó el reembolso. No se mueven fondos y el pago mantiene su status y sub_status anteriores. Revisa el response_code y el response_message de la transacción para conocer el motivo. Una vez resuelta la causa, vuelve a enviar el reembolso con un nuevo X-Idempotency-Key, o establece simplified_mode en true en 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: