Ambientes

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

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.

Ambientes Disponíveis

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)

Use CPFs de teste: 11111111111, 22222222222, 33333333333

Ambiente real com dados e transações reais.

Operações em produção são irreversíveis. Propostas criadas iniciam o fluxo real de crédito.

Cada ambiente possui credenciais independentes:

# Homologação
CLIENT_ID=hml_abc123
CLIENT_SECRET=hml_secret_xyz

# Produção
CLIENT_ID=prod_abc123
CLIENT_SECRET=prod_secret_xyz

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

Antes de migrar para produção, verifique:

Testes em Homologação

Fluxo completo testado (criação → pagamento) em homologação

Webhooks configurados

URLs de webhook respondendo corretamente

Tratamento de erros

Retry com backoff implementado para falhas transitórias

Idempotência

Operações idempotentes para evitar duplicação

Validação técnica

Aprovação do time de integrações Zipdin