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

# Colecciones de Postman

> Explica cómo importar y configurar la colección de Postman de Yuno para probar los endpoints de sandbox

Postman es una plataforma de API que ayuda a los desarrolladores a diseñar y probar APIs. Es una forma alternativa de hacer solicitudes a la API de Yuno en lugar de usar la referencia de la API en Readme.io. [Descarga Postman](https://www.postman.com/downloads/) para Linux, Windows o Mac, o úsalo desde tu navegador web.

Aquí encuentras cómo importar la colección y el entorno de Yuno. Todos los endpoints de la [referencia de la API](https://docs.y.uno/es/reference/getting-started/api-reference-overview.md) están disponibles en la colección de Postman proporcionada, para que puedas probar los servicios de Yuno en tu equipo.

> [!NOTE]
>
> **Colección de Postman**
>
> Accede a la [colección de Postman de las APIs de Yuno](https://documenter.getpostman.com/view/25083296/2sBXikpXDZ?utm_source=slack\&utm_medium=link_preview\&utm_campaign=other\&utm_content=link\&utm_term=other#173ba2dd-1dbb-466c-934c-19a4308d9d80).

## Paso 1: bifurca la colección de Postman de Yuno

Antes de probar los endpoints, debes bifurcar la colección de Yuno en tu cuenta de Postman.

1. Accede a la [colección de Postman de Yuno](https://documenter.getpostman.com/view/25083296/2sBXikpXDZ?utm_source=slack\&utm_medium=link_preview\&utm_campaign=other\&utm_content=link\&utm_term=other#173ba2dd-1dbb-466c-934c-19a4308d9d80).
2. Selecciona el siguiente botón **Run in Postman**.
3. Elige si quieres ejecutar Postman en tu navegador o con la aplicación de Postman.
4. Regístrate o inicia sesión en una cuenta de Postman.
5. Selecciona un espacio de trabajo en el que importar la colección.

> [!NOTE]
>
> **La colección y el entorno son independientes**
>
> Al bifurcar la colección solo se traen las solicitudes. El entorno (el archivo con tus claves de API y variables de cuenta) es un archivo `.json` independiente que debes importar por separado, no viene incluido con la colección bifurcada.

## Paso 2: configura las variables de entorno

Antes de comenzar a probar el endpoint, debes importar y configurar el entorno. De lo contrario, las solicitudes fallarán.

1. Descarga [`Yuno_Sandbox.postman_environment.json`](https://docs.y.uno/files/postman/Yuno_Sandbox.postman_environment.json) e impórtalo. Accede a **Environments** en el panel izquierdo y luego a **Import**.

![Panel Environments en Postman, modo claro](https://mintcdn.com/yuno-3979e326/GspgIeXMm7YcceoM/images/reference/postman-collections/image1-light.png?fit=max\&auto=format\&n=GspgIeXMm7YcceoM\&q=85\&s=bba3eb1dba4e67400469f07070da8205)

2. Selecciona el entorno **Yuno Sandbox** una vez importado.

![Entorno Yuno Sandbox seleccionado, modo claro](https://mintcdn.com/yuno-3979e326/GspgIeXMm7YcceoM/images/reference/postman-collections/image2-light.png?fit=max\&auto=format\&n=GspgIeXMm7YcceoM\&q=85\&s=1b44e1dc58e68ce3a0300c1ca9e0dbe1)

3. Actualiza los valores de las variables. Para comenzar a probar, debes actualizar al menos `public_api_key`, `private_secret_key` y `account_id`.

> [!NOTE]
>
> **Las claves de sandbox requieren el modo de prueba**
>
> En el Yuno Dashboard, configura el [chip de contexto](https://docs.y.uno/es/docs/using-yuno/account-context.md) de la barra superior en **Test** antes de copiar tus claves de API. Con el chip en **Live**, las claves tienen alcance de producción y no se autenticarán en el entorno de sandbox.

4. Define **Yuno Sandbox** como el entorno con el selector **No Environment** en la esquina superior derecha.

![Menú desplegable del selector de entorno, modo claro](https://mintcdn.com/yuno-3979e326/GspgIeXMm7YcceoM/images/reference/postman-collections/image3-light.png?fit=max\&auto=format\&n=GspgIeXMm7YcceoM\&q=85\&s=b8c7bb4267fa8d87757b4d4c9a40ddf7)

El entorno **Yuno Sandbox** tiene una extensa lista de variables que se usan en todas las solicitudes de la colección. Puedes definir sus valores a medida que pruebes nuevos endpoints.

## Paso 3: ejecuta en Postman

Después de seleccionar el entorno y definir los valores de las variables, puedes comenzar a probar el endpoint.

1. Selecciona la colección **Yuno Payments API Playground** en la pestaña Collections.
2. Elige un endpoint.

![Árbol de la colección con un endpoint seleccionado, modo claro](https://mintcdn.com/yuno-3979e326/GspgIeXMm7YcceoM/images/reference/postman-collections/image4-light.png?fit=max\&auto=format\&n=GspgIeXMm7YcceoM\&q=85\&s=4349afa09d6d1e06ba09adee556064c6)

3. Proporciona los valores necesarios para los parámetros disponibles en las pestañas **Headers** y **Body**.

![Pestaña Body con los parámetros de la solicitud, modo claro](https://mintcdn.com/yuno-3979e326/GspgIeXMm7YcceoM/images/reference/postman-collections/image5-light.png?fit=max\&auto=format\&n=GspgIeXMm7YcceoM\&q=85\&s=b38bcc8c639d25a1c1c063808fe1c53e)

4. Usa el botón **Send** para realizar la solicitud al servidor de Yuno.

![Botón Send y respuesta del servidor, modo claro](https://mintcdn.com/yuno-3979e326/GspgIeXMm7YcceoM/images/reference/postman-collections/image6-light.png?fit=max\&auto=format\&n=GspgIeXMm7YcceoM\&q=85\&s=6221fac33cfd67b0d13d158743af70b5)

> [!NOTE]
>
> **Variables de Postman**
>
> En la colección de Yuno, varios parámetros se consideran variables. Estos valores se pueden definir en el entorno o al recibir una respuesta del servidor. Las variables de Postman ayudan a probar distintos endpoints en secuencia. Los valores recibidos en una respuesta completan los parámetros del cuerpo de la siguiente solicitud.

## Recursos útiles

* [Colección de Postman de Yuno](https://documenter.getpostman.com/view/25083296/2sBXikpXDZ?utm_source=slack\&utm_medium=link_preview\&utm_campaign=other\&utm_content=link\&utm_term=other#173ba2dd-1dbb-466c-934c-19a4308d9d80)
* [`Yuno_Sandbox.postman_environment.json`](https://docs.y.uno/files/postman/Yuno_Sandbox.postman_environment.json)
* [`Yuno_Production.postman_environment.json`](https://docs.y.uno/files/postman/Yuno_Production.postman_environment.json)


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