# Colección de Postman

Postman es una plataforma que ayuda a los desarrolladores a compilar, probar y usar APIs. Una de sus principales funcionalidades es la posibilidad de importar una colección de API existente (un conjunto organizado de APIs relacionadas).

Para ayudarlo a desarrollar su integración, configure la colección de la API de Getnet en Postman siguiendo los pasos que se indican a continuación.

## Paso 1: Descargue los archivos necesarios

1. Descargue Postman desde el [siguiente enlace](https://www.postman.com/downloads/).
2. Descargue el archivo JSON de entorno de Getnet desde el [siguiente enlace](https://github.com/pagonxt/docs/blob/main/web-checkout/getnet-api-web-checkout-1.0.0.postman_environment.json).
3. Descargue la colección de la API de Getnet desde el [siguiente enlace](https://github.com/pagonxt/docs/blob/main/web-checkout/getnet-api-web-checkout-1.0.0.postman_collection.json).

---

## Paso 2: Importe el archivo de entorno

Abra la aplicación Postman. En su workspace, vaya a la sección **Environments** en la barra lateral y haga clic en **Import**.

Arrastre y suelte, o seleccione, el archivo JSON de entorno de Getnet. Después de importarlo, verá una lista de variables de entorno. Complete las siguientes claves con los valores correspondientes:

- Para la clave `host_getnet_api`, use una de las siguientes opciones:
  - [**https://api.pre.globalgetnet.com**](https://api.pre.globalgetnet.com) para el **entorno de homologación**, o  
  - [**https://api.globalgetnet.com**](https://api.globalgetnet.com) para el **entorno de producción**.
- Para la clave `client_id`, ingrese las credenciales proporcionadas por Getnet.
- Para la clave `client_secret`, ingrese las credenciales proporcionadas por Getnet.

Después de completar los campos, haga clic en **Save** para aplicar los cambios.

Para más información, consulte:  
[https://learning.postman.com/docs/sending-requests/variables/variables/](https://learning.postman.com/docs/sending-requests/variables/variables/)

---

## Paso 3: Importe el archivo de la colección

Vaya a la sección **Collections** en la barra lateral y haga clic en **Import** nuevamente. Esta vez, arrastre y suelte, o seleccione, el archivo JSON de la colección de Getnet.

Una vez importada, verá una lista estructurada con todas las solicitudes de API disponibles.

Para más información, consulte:  
[https://learning.postman.com/docs/getting-started/importing-and-exporting/importing-and-exporting-overview/#importing-data-into-postman](https://learning.postman.com/docs/getting-started/importing-and-exporting/importing-and-exporting-overview/#importing-data-into-postman)

---

## ¡Listo!

La colección está configurada para almacenar automáticamente el `access_token` después de ejecutar correctamente el endpoint de Authentication.

Al realizar cancelaciones, asegúrese de ingresar su ID de pago en el parámetro de path `payment_id`. Este valor se genera después de la autorización del pago.