> ## 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.

# Webhooks

> Explica cómo los webhooks de Yuno notifican a tu sistema los cambios de estado de pagos y eventos.

Un webhook es la forma en que Yuno notifica a tu sistema sobre eventos, como un pago autorizado o una suscripción renovada, mediante un `POST` HTTP a una URL que configuras, en lugar de que tu sistema tenga que consultar periódicamente si hay novedades.

![Diagrama del flujo de notificación de webhooks entre Yuno y tu sistema](https://mintcdn.com/yuno-3979e326/OXm4Cjavq6YgX3ks/images/reference/webhooks-1/image1.png?fit=max\&auto=format\&n=OXm4Cjavq6YgX3ks\&q=85\&s=a3f70cbec082ad47649b4a09fa7b0ccc)

Consulta la [descripción general de webhooks](https://docs.y.uno/docs/webhooks.md) para conocer el comportamiento de las entregas, cómo configurar uno desde el dashboard o la API, y el catálogo completo de eventos.


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