Getnet DocsGetnet Docs

Ambientes

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

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.

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.

  • 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

  • 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

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.

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