# Ambientes

A Monetarie disponibiliza dois ambientes isolados para integração.

## Produção

| Atributo | Valor |
|----------|-------|
| **Base URL** | `https://api.monetarie.com` |
| **ISPB** | `46026562` |
| **Descrição** | Transações reais no SPI/BACEN. Movimentação financeira efetiva. |

```
https://api.monetarie.com/api/external/...
```

## Homologação

| Atributo | Valor |
|----------|-------|
| **Base URL** | `https://api-h.monetarie.com` |
| **ISPB** | `46026562` |
| **Descrição** | Ambiente de testes com dados isolados. Transações não afetam saldos reais. |

```
https://api-h.monetarie.com/api/external/...
```
::: tip Homologação
Use o ambiente de homologação para desenvolver e testar sua integração antes de operar em produção. As credenciais são diferentes entre ambientes.
:::

## Credenciais

As credenciais (`client_id` e `client_secret`) são fornecidas pelo seu gerente de conta durante o processo de cadastro. Cada ambiente possui credenciais próprias e independentes.

::: warning Credenciais são exclusivas por ambiente
Credenciais de homologação não funcionam em produção e vice-versa. Nunca compartilhe suas credenciais com terceiros.
:::

## Segurança

| Recurso | Detalhes |
|---------|----------|
| **HTTPS obrigatório** | TLS 1.2 ou superior em todas as conexões |
| **HSTS** | HTTP Strict Transport Security habilitado |
| **AWS WAF** | Firewall de aplicação web protegendo a API |
| **IP Whitelist** | Obrigatória para cada API Key |
| **HMAC-SHA512** | Assinatura por requisição em endpoints transacionais |

## Requisitos de Integração

- Todas as requisições devem usar **HTTPS**
- A API Key é permanente -- não expira. Configure IPs na whitelist para segurança
- Requisições transacionais (cash-in, cash-out, refund, webhooks) exigem **HMAC-SHA512**
- Valores monetários: **entrada** em centavos (R$ 1,00 = `100`), **resposta** em unidades base (R$ 1,00 = `10000`)
- Respostas seguem o padrão `{"worked": true/false, ...}`
- Nunca use ponto flutuante para valores monetários -- sempre inteiros

## Rate Limiting

| Tipo | Limite |
|------|--------|
| Por IP (autenticado) | 90.000 requisições/minuto |
| Por IP (sem autenticação) | 5 requisições/minuto |
| Webhooks por conta | Até 5 URLs |

Headers de rate limit na resposta:

```
X-RateLimit-Limit: 60000
X-RateLimit-Remaining: 59997
Retry-After: 3  (apenas quando 429)
```

::: tip Suporte
Para dúvidas sobre integração, entre em contato com o suporte técnico pelo canal disponibilizado no seu contrato.
:::