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

# Ambientes

> URLs base, ambientes disponíveis e como configurar sua integração

# Ambientes

A Zipdin oferece dois ambientes para diferentes estágios da integração.

<Tip>
  Recomendamos parametrizar as URLs base na sua integração, pois pode ocorrer
  variação da URL. Evite fixar o endereço diretamente no código.
</Tip>

## Ambientes Disponíveis

<Tabs>
  <Tab title="Homologação">
    **Para desenvolvimento e testes de integração.**

    | Atributo   | Valor                             |
    | ---------- | --------------------------------- |
    | URL Base   | `https://hml.zipdin.com.br`       |
    | Dados      | Fictícios (CPFs de teste)         |
    | Token TTL  | 1 hora                            |
    | Pagamentos | Simulados (não gera TED/PIX real) |

    <Tip>
      Use CPFs de teste: `11111111111`, `22222222222`, `33333333333`
    </Tip>
  </Tab>

  <Tab title="Produção">
    **Ambiente real com dados e transações reais.**

    | Atributo   | Valor                       |
    | ---------- | --------------------------- |
    | URL Base   | `https://api.zipdin.com.br` |
    | Dados      | Reais                       |
    | Token TTL  | 1 hora                      |
    | Pagamentos | Reais (TED/PIX)             |
    | SLA        | 99.9% uptime                |

    <Warning>
      Operações em produção são irreversíveis. Propostas criadas
      iniciam o fluxo real de crédito.
    </Warning>
  </Tab>
</Tabs>

## Credenciais por Ambiente

Cada ambiente possui credenciais independentes:

```bash theme={null}
# Homologação
CLIENT_ID=hml_abc123
CLIENT_SECRET=hml_secret_xyz

# Produção
CLIENT_ID=prod_abc123
CLIENT_SECRET=prod_secret_xyz
```

<Note>
  Credenciais de produção são entregues apenas após validação técnica
  completa no ambiente de homologação.
</Note>

## Checklist de Go-Live

Antes de migrar para produção, verifique:

<Steps>
  <Step title="Testes em Homologação">
    Fluxo completo testado (criação → pagamento) em homologação
  </Step>

  <Step title="Webhooks configurados">
    URLs de webhook respondendo corretamente
  </Step>

  <Step title="Tratamento de erros">
    Retry com backoff implementado para falhas transitórias
  </Step>

  <Step title="Idempotência">
    Operações idempotentes para evitar duplicação
  </Step>

  <Step title="Validação técnica">
    Aprovação do time de integrações Zipdin
  </Step>
</Steps>