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.Requisitos
Para capturar un pago, debes:- Acceder a tus credenciales de API en el Dashboard de Yuno, que consisten en:
public-api-keyprivate-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ámetroiddespués de crear el pago.transaction_id: El identificador único de la transacción, obtenido del parámetrotransaction.iddespué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)
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 suid 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.type = CAPTUREstatus = SUCCEEDEDpayment.status = SUCCEEDEDpayment.sub_status = CAPTURED/PARTIALLY_CAPTURED
Pago que ya está en un estado final
Si llamas al endpoint de captura con un pago que ya no está en estadoPENDING (por ejemplo, ya fue capturado, reembolsado o cancelado), el endpoint devuelve HTTP 400 con el código INVALID_STATUS:
Revisa el estado del pago
Si, por algún motivo, necesitas confirmar la captura 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.