# RunaTrack

> API única de pagamentos (Pix, boleto, cartão). O cliente integra uma vez; a gateway por trás (Beehive, Velani, Pingu, Pague-X, FreePay) é escolhida no painel. Valores em centavos. Autenticação: Authorization: Bearer hub_live_... (somente servidor).

## Documentação
- [Guia de integração (Markdown)](https://localhost:3003/docs.md): autenticação, criar/consultar cobrança, webhook com validação de assinatura, rastreamento (UTMs), conversões (Meta/TikTok/Google), erros, limites e diferenças entre gateways.
- [OpenAPI 3.0](https://localhost:3003/openapi.json): contrato da API para geração de clientes.

## Resumo
- POST https://localhost:3003/api/v1/charges cria a cobrança; GET https://localhost:3003/api/v1/charges/{id} consulta (com ?events=1 traz a timeline).
- POST https://localhost:3003/api/v1/tracking/sales registra uma venda feita em OUTRO checkout (idempotente pela `reference`): entra na receita, no ROAS por funil e nas conversões. A consulta é o mesmo GET /api/v1/charges/{id}, com o id `ext_...` que a criação devolve.
- Webhook para o seu sistema: { event: "charge.updated", charge } assinado com x-hub-signature (HMAC-SHA256 do corpo com o seu segredo).
- Rastreamento no navegador: <script src="https://localhost:3003/t.js" data-tid="..." data-pk="pk_..." async></script> (ou /c/s.js atrás de proxy no seu domínio).
- Limite: 120 requisições por minuto por cliente em cada endpoint de escrita (POST charges e POST tracking/sales). Ao passar: 429 com `Retry-After` em segundos.
- Variáveis de ambiente do projeto do cliente: HUB_URL=https://localhost:3003, HUB_API_KEY, HUB_WEBHOOK_SECRET.
- Teste primeiro com a gateway "Simulado (teste)" no painel.