> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Cancela pagos

> Muestra cómo cancelar manualmente un pago pendiente con el endpoint Cancel Payment.

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

> [!NOTE]
>
> **Cancelación automática diferida**
>
> Si prefieres que Yuno cancele automáticamente las autorizaciones después de un tiempo determinado, puedes configurar `delayed_cancel_settings` al crear el pago. Esto ayuda a mejorar la experiencia del cliente al liberar automáticamente los fondos retenidos. Obtén más información en la guía [Flujo de cancelación y captura](https://docs.y.uno/docs/payment-features/Cancel-and-capture-flow.md).

> [!WARNING]
>
> **Pagos cancelables**
>
> Solo se pueden cancelar los pagos con estado **PENDING**. Consulta la página [Estado del pago](https://docs.y.uno/es/docs/basic-concepts/payments-1.md) para obtener más detalles sobre los posibles estados del pago.

## Requisitos

Para cancelar un pago, debes:

* Acceder a tus [credenciales de API](https://docs.y.uno/es/docs/using-yuno/settings/developers-credentials.md) 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](https://docs.y.uno/es/reference/payments/create-payment.md):
  * `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.

> [!NOTE]
>
> **Explora las colecciones de Postman de Yuno**
>
> Yuno ofrece [colecciones de Postman](https://docs.y.uno/reference/getting-started/postman-collections.md) que puedes usar para replicar los casos de uso de forma local.

## Cancela un pago

Solo puedes cancelar un pago si tiene el estado PENDING. Usa el [endpoint Cancel Payment](https://docs.y.uno/reference/payments/cancel-payment.md) para cancelar el pago. Para identificar el pago que se va a cancelar, debes proporcionar su `id` y el `transaction_id`.

Para confirmar que cancelaste el pago correctamente, verifica que los parámetros de la respuesta del [endpoint Cancel Payment](https://docs.y.uno/reference/payments/cancel-payment.md) contengan los siguientes valores:

* `type = CANCEL`
* `status = SUCCEEDED`
* `payment.status = CANCELED`
* `payment.sub_status = CANCELED`

Si la respuesta contiene los valores anteriores, la cancelación fue exitosa.

### Revisa el estado del pago

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

* Usa [Retrieve Payment by ID](https://docs.y.uno/reference/payments/retrieve-payment-by-id) o [Retrieve Payment by merchant\_order\_id](https://docs.y.uno/reference/payments/retrieve-payment-by-merchant-order-id.md) 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](https://docs.y.uno/docs/webhooks/configure-webhooks.md) para aprender a configurar webhooks en Yuno.

## Ver también

* [Captura pagos](https://docs.y.uno/es/docs/direct-integration-use-cases/capture-payments.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.