Variáveis de Ambiente

🔧 Referência Completa

Servidor e Aplicação

Variável	Padrão	Descrição
PORT	3000	Porta do servidor
NODE_ENV	development	Ambiente de execução
LOG_LEVEL	info	Nível de log (debug, info, warn, error)

Banco de Dados

Variável	Padrão	Descrição
DATABASE_URL	sqlite:./database/payments.sqlite	URL do banco
DB_POOL_MIN	2	Conexões mínimas do pool
DB_POOL_MAX	10	Conexões máximas do pool

Cache e Redis

Variável	Padrão	Descrição
REDIS_URL	redis://localhost:6379	URL do Redis
CACHE_TTL	3600	TTL padrão do cache (segundos)

Provedores de Pagamento

Stripe

Variável	Obrigatório	Descrição
STRIPE_SECRET_KEY	Sim	Chave secreta do Stripe
STRIPE_WEBHOOK_SECRET	Sim	Secret para validação de webhooks
STRIPE_API_VERSION	Não	Versão da API (padrão: 2023-10-16)

PayPal

Variável	Obrigatório	Descrição
PAYPAL_CLIENT_ID	Sim	Client ID do PayPal
PAYPAL_CLIENT_SECRET	Sim	Client Secret do PayPal
PAYPAL_BASE_URL	Não	URL base (sandbox/live)

MercadoPago

Variável	Obrigatório	Descrição
MERCADOPAGO_ACCESS_TOKEN	Sim	Token de acesso
MERCADOPAGO_WEBHOOK_SECRET	Sim	Secret para webhooks

Segurança

Variável	Obrigatório	Descrição
JWT_SECRET	Sim	Chave para assinar JWTs
REFRESH_SALT	Sim	Salt para refresh tokens
ENCRYPTION_KEY	Sim	Chave AES-256 (32 chars)

Rate Limiting

Variável	Padrão	Descrição
RATE_LIMIT_WINDOW_MS	3600000	Janela de rate limit (ms)
RATE_LIMIT_MAX_REQUESTS	1000	Máximo de requests por janela

CORS

Variável	Padrão	Descrição
CORS_ORIGIN	*	Origens permitidas
CORS_CREDENTIALS	false	Permitir credentials

Monitoramento

Variável	Padrão	Descrição
PROMETHEUS_ENABLED	true	Habilitar métricas
METRICS_PORT	9090	Porta para métricas
HEALTH_CHECK_TIMEOUT	5000	Timeout dos health checks (ms)

📝 Exemplo .env

# Servidor
PORT=3000
NODE_ENV=production

# Banco de Dados
DATABASE_URL=postgresql://user:pass@localhost:5432/payments

# Stripe
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...

# PayPal
PAYPAL_CLIENT_ID=your_client_id
PAYPAL_CLIENT_SECRET=your_client_secret

# MercadoPago
MERCADOPAGO_ACCESS_TOKEN=your_access_token

# Segurança
JWT_SECRET=your-super-secret-jwt-key-here
REFRESH_SALT=your-refresh-salt-here
ENCRYPTION_KEY=your-32-character-encryption-key-here

# Cache
REDIS_URL=redis://localhost:6379

# Rate Limiting
RATE_LIMIT_MAX_REQUESTS=1000
RATE_LIMIT_WINDOW_MS=3600000

# CORS
CORS_ORIGIN=https://yourdomain.com
CORS_CREDENTIALS=true

# Monitoramento
PROMETHEUS_ENABLED=true
METRICS_PORT=9090

---

Documentação atualizada: December 2024