# EvoPay API

Gateway de pagamentos Pix para criação de cobranças (cash-in), saques (cash-out) e gerenciamento de transações.

## Documentação

- Base URL: https://pix.evopay.cash/v1
- Autenticação: Header `API-Key: SEU_TOKEN` (UUID v4)
- Dashboard / tokens: https://app.evopay.cash/settings/tokens
- Documentação completa: https://docs.evopay.cash

## Guias

- [Introdução](https://docs.evopay.cash/guide/introduction) — Base URL, formatos, IDs, taxas (TaxRule: taxValue, taxType, minAmount, maxAmount), erros
- [Autenticação](https://docs.evopay.cash/guide/authentication) — Header API-Key, como obter token, boas práticas
- [Webhooks](https://docs.evopay.cash/guide/webhook) — Payloads de depósito e saque, política de entrega única
- [Schemas](https://docs.evopay.cash/guide/schemas) — Enums e objetos: TransactionStatus, TransactionType, Transaction, QrCodeInfo
- [Para IAs](https://docs.evopay.cash/guide/for-ais) — Prompt base e arquivos llms.txt / llms-full.txt

## Referência da API

- [Conta](https://docs.evopay.cash/reference/account) — GET /v1/account, GET /v1/account/balance, GET /v1/account/transactions
- [Pix / Depósitos](https://docs.evopay.cash/reference/pix) — POST /v1/pix, GET /v1/pix, POST /v1/pix/qr-code/read, GET /v1/pix/qr-code/{transactionId}
- [Saques](https://docs.evopay.cash/reference/withdraw) — POST /v1/withdraw, POST /v1/withdraw/qrcode

## Arquivo completo

Para contexto completo (guias + OpenAPI YAML): https://docs.evopay.cash/llms-full.txt