# PerfectPay API

> API de integração para produtores e afiliados: consulta de vendas, assinaturas, tracking e invoice, e recebimento de PostBack (webhook).

Autenticação: header `Authorization: Bearer <token>`. Token de integração (painel: Ferramentas > API) ou token pessoal (`POST /api/auth/login`).

## Especificação
- [OpenAPI (JSON)](/docs/api.json): especificação completa e canônica (machine-readable).
- [Documentação (UI)](/docs/api): referência navegável dos endpoints.
- [PostBack / Webhook](/docs/api/webhooks): payload e eventos do webhook de saída.

## Endpoints
- POST /api/auth/login — Login (retorna token pessoal).
- POST /api/v1/sales/get — Buscar vendas (filtros por data/status/produto).
- POST /api/v1/tracking/create — Criar tracking de uma venda.
- POST /api/v1/tracking/get — Buscar tracking de uma venda.
- POST /api/v1/invoice/create — Criar invoice (nota fiscal).
- POST /api/v1/invoice/get — Buscar invoices.
- POST /api/v1/subscriptions/get — Buscar assinaturas.

## Detalhes
- [Descrições completas](/llms-full.txt): endpoints, parâmetros e respostas inline.