Saltar al contenido principal
En esta guía encontrarás instrucciones paso a paso para capturar manualmente un pago creado previamente en Yuno.
Captura automática diferidaSi prefieres que Yuno capture automáticamente los pagos después de un tiempo determinado, puedes configurar delayed_capture_settings al crear el pago. Obtén más información en la guía Flujo de cancelación y captura.
Qué pagos puedes capturarSolo se pueden capturar los pagos con estado PENDING. Consulta la página Estado del pago para obtener más detalles sobre los posibles estados del pago.Si el pago ya está en estado SUCCEEDED, ya fue capturado y no queda nada por capturar. Este es el caso de las compras (capture: true) y de las autorizaciones (capture: false) enviadas a un proveedor que solo admite captura inmediata. En este segundo caso, Yuno crea la transacción de captura por ti y devuelve el pago como SUCCEEDED con sub_status = CAPTURED, por lo que puedes omitir la llamada de captura.

Requisitos

Para capturar un pago, debes:
  • Acceder a tus credenciales de API en el Dashboard de Yuno, que consisten en:
    • public-api-key
    • private-secret-key
  • Tener los datos de identificación del pago que recibiste después de crearlo con el endpoint Create Payment:
    • id: El identificador único del pago, obtenido del parámetro id después de crear el pago.
    • transaction_id: El identificador único de la transacción, obtenido del parámetro transaction.id después de crear el pago.
Explora las colecciones de Postman de YunoYuno ofrece colecciones de Postman que puedes usar para replicar los casos de uso de forma local.
Opciones de capturaEsta guía cubre la captura manual mediante el endpoint de la API. Para otras opciones de captura, como:
  • Captura en tiempo real (compra inmediata)
  • Captura diferida (captura automática después de un tiempo)
Consulta la guía Flujo de cancelación y captura.

Captura un pago

Solo puedes capturar un pago si tiene el estado PENDING. Usa el endpoint Capture Payment para capturar el pago. Para identificar el pago que se va a capturar, debes proporcionar su id y el transaction_id. Además, debes indicar el monto que se va a capturar mediante el objeto amount en el cuerpo de la solicitud:
  • Captura completa: Deja el monto vacío.
  • Captura parcial: Proporciona el valor que se va a capturar mediante el parámetro amount.
Pagos con una promoción de YunoEl monto autorizado es lo que paga el cliente, amount.value menos discount_amount, por lo que una captura completa toma ese monto. Consulta Promociones.
Para confirmar que capturaste el pago correctamente, verifica que los parámetros de la respuesta del endpoint Capture Payment contengan los siguientes valores:
  • type = CAPTURE
  • status = SUCCEEDED
  • payment.status = SUCCEEDED
  • payment.sub_status = CAPTURED/PARTIALLY_CAPTURED
Si la respuesta contiene los valores anteriores, la captura fue exitosa.

Pago que ya está en un estado final

Si llamas al endpoint de captura con un pago que ya no está en estado PENDING (por ejemplo, ya fue capturado, reembolsado o cancelado), el endpoint devuelve HTTP 400 con el código INVALID_STATUS:
Interpreta este código como “no se aplican más operaciones a este pago” y no reintentes la captura. Para conocer el estado actual del pago, usa el endpoint Retrieve payment.

Revisa el estado del pago

Si, por algún motivo, necesitas confirmar la captura del pago:

Ver también