# Postman collection

Postman is a software platform that helps developers, build, test and use APIs. Among its benefits and features, there is the possibility to import an existing API collection (an organized set of related APIs) to work with it. In order to help you develop your integration, we encourage you to use Postman and to setup our GetNet’s API collection following these steps:

## Prerequisites

Before you begin, ensure you have:

Download Postman software from the [following link](https://www.postman.com/downloads/).
Download the GetNet’s environment json file and API Collection from the [following link](https://github.com/pagonxt/docs/tree/main/regional-api).

## Step 1: Import the environment file
Open the Postman app, and within your workspace, click on the *Environments* section in the sidebar menu, and then click on the *Import* button.
Next, drop or select the GetNet’s environment json file. Once selected, you should be able to see a list of environment variables where you need to fill in the following keys with their corresponding values:

* For the ***host\_getnet\_api*** key, fill it with one of the following options: [**https://api.pre.globalgetnet.com**](https://api.pre.globalgetnet.com) **for the homologation** environment or [**https://api.globalgetnet.com**](https://api.globalgetnet.com) **for the production** environment.
* For the ***client\_id key***, fill it with the credentials provided by GetNet.
* For the ***client\_secret*** key, fill it with the credentials provided by GetNet.
  Then, remember to save your changes by clicking the *Save* button.

For more information, please refer to [https://learning.postman.com/docs/sending-requests/variables/variables/](https://learning.postman.com/docs/sending-requests/variables/variables/)

## Step 2: Import the collection file
Click on the *Collections* section in the sidebar menu. Once again, click on the *Import* button, but this time, drag or select the GetNet collection json file. As a result, you should see a structured list of files with every available API request.

Please note that there is one collection file per country. This means that when importing a collection into your Postman workspace, all necessary configurations required to operate in a specific country will already be applied.

The collection is set to automatically persist the ***access\_token*** value upon successful execution of the Authentication endpoint. When working with captures or cancellations, remember to enter your payment ID in the ***payment\_id*** field of the request payload, which should be obtained after payment authorization.

For more information, please refer to [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)