# Guias de Integração

Guias técnicos organizados por tema. Leia na ordem sugerida para uma primeira integração, ou vá direto ao tópico que precisa.

## Fundamentos

- [Visão geral](/parceiros/guides/visao-geral) — arquitetura, fluxo de dados e papéis
- [Autenticação](/parceiros/guides/autenticacao) — Basic Auth, header x-parceiro-id e descoberta de identidade
- [Modos de operação](/parceiros/guides/modos-operacao) — diferença entre FILTRADO e TOTAL


## Operações principais

- [Liquidação](/parceiros/guides/liquidacao) — criar pedidos, confirmar e cancelar
- [Webhooks](/parceiros/guides/webhooks) — receber eventos, verificar assinatura e tratar retentativas
- [Idempotência](/parceiros/guides/idempotencia) — chaves de idempotência e comportamento em duplicatas


## Referência operacional

- [Rate limits](/parceiros/guides/rate-limits) — limites por credencial e comportamento em 429
- [Erros](/parceiros/guides/erros) — catálogo de códigos, causas e ações recomendadas