# Ambientes

Ao integrar com a Getnet, você trabalhará com três ambientes distintos:

* **Sandbox** para desenvolvimento inicial e testes.
* **UAT** para validações finais antes da produção.
* **Produção** para transações reais. O acesso ao ambiente de Produção requer a conclusão de um processo formal de homologação.

## Sandbox

O Sandbox é um ambiente de testes self-service projetado para ajudar você a começar rapidamente. Seu objetivo é o desenvolvimento inicial, a exploração das capacidades da API e o teste de fluxos básicos de transação sem afetar dados reais.

<Callout type="warning">

Lembre-se de que o Sandbox é um ambiente de simulação e não uma representação completa do sistema de produção. Você pode gerar e gerenciar suas próprias credenciais na seção API Keys do [portal Getnet](https://www.pre.globalgetnet.com).

</Callout>

* **Objetivo:** Testar a integração da API, simular vendas e validar o fluxo de autenticação sem envolver dinheiro real ou cartões válidos.
* **Acesso:** Aberto. Você pode criar uma conta gratuitamente no portal Getnet Developers e gerar suas credenciais (client_id e client_secret) instantaneamente.
* **Base URL (Endpoint):** [https://api-sbx.globalgetnet.com](https://api-sbx.pre.globalgetnet.com)
* **Recursos:**

  * Utiliza dados fictícios (cartões de teste fornecidos na documentação).
  * Simula respostas de aprovação e recusa.
  * Não gera liquidação financeira

## UAT / Pré-produção

Na Getnet, equivalente ao UAT (User Acceptance Testing) ou pré-produção. Este ambiente é utilizado para validar se a aplicação do merchant está pronta para entrar em produção, garantindo que os fluxos de negócio (não apenas o código) estejam corretos.

* **Objetivo:** Validação final antes da produção. É aqui que merchants e desenvolvedores confirmam se as configurações da conta (filiais, tipos de pagamento habilitados) refletem o contrato real.
* **Acesso:** Restrito. As credenciais geralmente são fornecidas após o início do processo de onboarding ou mediante solicitação à equipe de suporte de integração.
* **Base URL (Endpoint):** [https://api.pre.globalgetnet.com](https://api.pre.globalgetnet.com)

<Callout type="warning">

Frequentemente, para integradores menores, a validação é feita diretamente no Sandbox e depois migrada para Produção. O ambiente de UAT é mais comum para grandes contas ou parcerias (TEF, Marketplaces) que exigem certificação.

</Callout>

## Produção

O ambiente de Produção é onde você processará transações reais e ativas para seus clientes. O acesso é concedido somente após a conclusão bem-sucedida do processo de homologação, realização dos testes finais em produção e existência de um contrato assinado. As chaves de API de Produção, altamente sensíveis, serão compartilhadas com segurança pela equipe de integração da Getnet após a aprovação final.

* **Objetivo:** Processar pagamentos reais de clientes finais.
* **Acesso:** Concedido somente após a aprovação da afiliação comercial (contrato assinado) e a validação técnica concluída.
* **Base URL (Endpoint):** [https://api.globalgetnet.com](https://api.globalgetnet.com)
* **Segurança:** Requer certificado digital e TLS 1.2. As credenciais de Produção são diferentes daquelas utilizadas nos ambientes Sandbox e UAT.

## Alterar entre ambientes

Dentro da Global API, disponibilizamos uma ferramenta de testes que permite testar transações de payloads sem a necessidade de uma interface dedicada. O objetivo é possibilitar a troca de informações diretamente por este ambiente.
Como mostrado no vídeo, é possível realizar testes em três ambientes diferentes.

<img height="480" width="852" src="https://static-devportal-ux.sensedia-eng.com/Pagonxt/production/documentations/portal-api-getnet-docs-google-chrome-2025-12-11-16-50-04-1765482762735-8ddzte65.gif" />