> ## Documentation Index
> Fetch the complete documentation index at: https://docs.z2pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes

> Sandbox × Produção: URLs base, como acessar o ambiente de testes e o que muda entre eles.

A Z2Pay tem dois ambientes totalmente separados: **Sandbox** (testes) e **Produção**.

<CardGroup cols={2}>
  <Card title="Sandbox" icon="flask-conical">
    Ambiente de testes. Nenhum dinheiro real é movimentado; os pagamentos são simulados de forma
    **determinística**. Use para desenvolver e validar sua integração.
  </Card>

  <Card title="Produção" icon="building">
    Ambiente real, conectado às adquirentes. Movimenta dinheiro de verdade.
  </Card>
</CardGroup>

## URLs base

A API da Z2Pay fica em um host, versionado em `/v1`:

| Ambiente     | URL base                           |
| ------------ | ---------------------------------- |
| **Sandbox**  | `https://api.sandbox.z2pay.com/v1` |
| **Produção** | `https://api.z2pay.com/v1`         |

Outros endereços da plataforma:

|                                          | Sandbox                               | Produção                |
| ---------------------------------------- | ------------------------------------- | ----------------------- |
| **Páginas hospedadas** (checkout/fatura) | `https://pay.sandbox.z2pay.com`       | `https://pay.z2pay.com` |
| **Dashboard**                            | acesso via botão "Ambiente de testes" | `https://app.z2pay.com` |

<Note>
  As chaves de API são específicas de cada ambiente. Uma chave de sandbox **não** funciona em
  produção e vice-versa. Veja [Autenticação](/pt-BR/autenticacao).
</Note>

<Note>
  Se a sua integração usa os subdomínios antigos (`billing-api.*`, `checkout-api.*`), eles seguem
  funcionando, mas estão **depreciados** — migre para a base acima.
</Note>

## Como acessar o sandbox

1. Faça login no **Dashboard de produção** (`https://app.z2pay.com`).
2. No menu de perfil, clique em **"Ambiente de testes"**.
3. Aguarde a configuração automática do seu sandbox (na primeira vez).
4. Você é redirecionado já logado no Dashboard de sandbox, onde encontra suas **credenciais de teste**
   e o painel de simulação de pagamentos.

## O que muda no sandbox

O sandbox **simula** os pagamentos de forma **determinística**, sem acionar as adquirentes reais. Isso torna os
testes previsíveis:

* **Cartão:** o desfecho (aprovado/recusado/falha) é definido pelos **últimos 4 dígitos** do número.
  Veja [Cartões de teste](/pt-BR/sandbox/cartoes).
* **PIX e boleto:** a liquidação é controlada por uma configuração por método (`instant`, `auto` ou
  `manual`), com a opção de forçar cenários por valor. Veja [PIX e boleto de teste](/pt-BR/sandbox/pix-boleto).
* **Chargeback:** pode ser simulado. Veja [Simular eventos](/pt-BR/sandbox/simular).

<Tip>
  Comece **sempre** pelo sandbox. Quando sua integração estiver redonda, basta trocar a URL base e
  a API key para produção — o contrato da API é idêntico.
</Tip>