> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kavropay.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Escopos de Permissão

> Controle granular de acessos por chave de API (princípio de menor privilégio).

| Escopo              | Descrição                                                                  | Endpoints Permitidos                                                            |
| ------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `payments:write`    | Permite gerar novas cobranças e QR Codes PIX.                              | `POST /v1/charges`, `POST /v1/payments`                                         |
| `payments:read`     | Permite consultar status de cobranças, clientes, histórico e saldo.        | `GET /v1/charges/*`, `GET /v1/status`, `GET /v1/customers/*`, `GET /v1/balance` |
| `withdrawals:write` | Permite solicitar saques/transferências PIX de saída para chaves externas. | `POST /v1/withdrawals`                                                          |
| `withdrawals:read`  | Permite listar e consultar o histórico de saques efetuados.                | `GET /v1/withdrawals/*`                                                         |

<CardGroup cols={2}>
  <Card title="Anterior: Autenticação" icon="arrow-left" horizontal href="/autenticacao" />

  <Card title="Próximo: Formato de Valores & Metadata" icon="arrow-right" horizontal href="/parametros" />
</CardGroup>