Capturar Pagos

En esta guía encontrarás instrucciones paso a paso para capturar manualmente un pago creado previamente en Yuno.

📘

Captura Automática Retardada

Si prefieres que Yuno capture automáticamente los pagos tras un retraso especificado, puedes configurar delayed_capture_settings al crear el pago. Más información en Cancelar y capturar flujo .

🚧

¿Qué pagos puedes capturar?

Sólo pagos con PENDING pueden capturarse. Consulta la página de estado depago para obtener más detalles sobre los posibles estados de pago .

Requisitos

Para capturar un pago, debes:

• Accede a tus Credenciales de API en el Yuno Dashboard, que consta de:
  • public-api-key
  • private-secrete-key
• Tener los datos de identificación de pago recibidos después de crear el pago utilizando el endpoint de Crear pago:
  • 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 Postman Collections de Yuno

Yuno proporciona Postman Collections que puedes usar para replicar los casos de uso localmente.

💡

Opciones de captura

Esta guía cubre la captura manual mediante el endpoint la API. Para otras opciones de captura

• Captación en tiempo real (compra inmediata)
• Captura retardada (captura automática tras un retardo)

Consulta la guía Cancelar y capturar flujo.

Capturar un pago

Puedes capturar un pago solo si tiene el estado PENDIENTE. Usa el Punto final de captura de pago para capturar el pago. Para identificar el pago que se va a capturar, debe proporcionar su id y el transaction_idAdemás, es necesario informar la cantidad a capturar utilizando el objeto. amount en el cuerpo de la solicitud:

• Reembolso completo: dejar el importe vacío.
• Reembolso parcial: Proporcione el valor del reembolso usando el parámetro amount.

Para confirmar que has capturado correctamente el pago, comprueba si los parámetros de la respuesta endpoint Capturar pago contienen 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.

Verifique el estado del pago

Si, por algún motivo, necesita confirmar la cancelación del pago:

• Utilice Recuperar pago por ID o Recuperar pago por merchant_order_id para obtener información detallada sobre el pago.
• Alternativamente, configura webhooks para recibir notificaciones de cada evento. Consulte la guía Webhooks para aprender a configurar webhooks en Yuno.