# Coleção do Postman

O Postman é uma plataforma que ajuda desenvolvedores a criar, testar e usar APIs. Um de seus principais recursos é a capacidade de importar uma coleção de API existente (um conjunto organizado de APIs relacionadas).

Para ajudar você a desenvolver sua integração, configure a coleção da API da Getnet no Postman usando os passos abaixo.

## Passo 1: Baixe os arquivos necessários

1. Baixe o Postman no [link a seguir](https://www.postman.com/downloads/).
2. Baixe o arquivo JSON de ambiente da Getnet no [link a seguir](https://github.com/pagonxt/docs/blob/main/web-checkout/getnet-api-web-checkout-1.0.0.postman_environment.json).
3. Baixe a coleção da API da Getnet no [link a seguir](https://github.com/pagonxt/docs/blob/main/web-checkout/getnet-api-web-checkout-1.0.0.postman_collection.json).

---

## Passo 2: Importe o arquivo de ambiente

Abra o aplicativo Postman. No seu workspace, acesse a seção **Environments** na barra lateral e clique em **Import**.

Arraste e solte, ou selecione, o arquivo JSON de ambiente da Getnet. Após importá-lo, você verá uma lista de variáveis de ambiente. Preencha as seguintes chaves com os valores adequados:

- Para a chave `host_getnet_api`, use uma das opções a seguir:
  - [**https://api.pre.globalgetnet.com**](https://api.pre.globalgetnet.com) para o **ambiente de homologação**, ou  
  - [**https://api.globalgetnet.com**](https://api.globalgetnet.com) para o **ambiente de produção**.
- Para a chave `client_id`, insira as credenciais fornecidas pela Getnet.
- Para a chave `client_secret`, insira as credenciais fornecidas pela Getnet.

Após preencher os campos, clique em **Save** para aplicar as alterações.

Para mais detalhes, consulte:  
[https://learning.postman.com/docs/sending-requests/variables/variables/](https://learning.postman.com/docs/sending-requests/variables/variables/)

---

## Passo 3: Importe o arquivo de coleção

Acesse a seção **Collections** na barra lateral e clique em **Import** novamente. Desta vez, arraste e solte, ou selecione, o arquivo JSON da coleção da Getnet.

Após a importação, você verá uma lista estruturada com todas as requisições de API disponíveis.

Para mais detalhes, 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)

---

## Pronto!

A coleção está configurada para armazenar automaticamente o `access_token` após a execução bem-sucedida do endpoint de autenticação.

Ao realizar cancelamentos, certifique-se de inserir o ID do pagamento no parâmetro de caminho `payment_id`. Esse valor é gerado após a autorização do pagamento.