Autenticação e ambientes

Ambientes previstos

Ambiente	Uso
Sandbox/homologação	Desenvolvimento e certificação da integração
Produção	Dados e operações reais após homologação

URLs definitivas, disponibilidade e processo de credenciamento serão fornecidos quando o backend estiver disponível.

Autenticação alvo

Integrações devem usar OAuth 2.0/OIDC, com credenciais fora do código e rotação. Aplicações de usuário seguem fluxo de sessão seguro; não se deve copiar as credenciais mock da demonstração.

Authorization: Bearer <token-de-acesso>
Content-Type: application/json
X-Correlation-Id: <uuid>
Idempotency-Key: <uuid>

Idempotency-Key é obrigatório para operações financeiras ou de criação que não podem ser duplicadas. Nunca registre tokens ou segredos em logs.