Changelog da API

Seguimos SemVer. Mudanças que quebram contrato (remover campo, mudar tipo) sobem major; adições retrocompatíveis sobem minor; correções sobem patch.

Mudanças que quebrariam contrato nunca são feitas em v1. Se precisarmos, lançamos v2 e mantemos v1 por no mínimo 12 meses.

[v1] — em desenvolvimento

Estado: Em homologação interna. Ainda não disponível pra merchants externos.

Endpoints disponíveis

• POST /v1/pix/qrcode — criar cobrança PIX
• POST /v1/pix/payout — enviar PIX (saque)
• GET /v1/balance — saldo disponível
• GET /v1/transactions/:id — detalhes de uma transação

Recursos

• Autenticação via client-id + client-secret
• Idempotência obrigatória em endpoints financeiros
• Webhooks outbound com HMAC-SHA256 + retry exponencial
• Multi-splits entre merchants
• Dois ambientes: test e live

---

Quando mudarmos algo, registramos aqui com data e descrição. Nunca surpresa.

Como ser avisado

• Breaking changes: enviamos email pros merchants com 90 dias de antecedência
• Minor: email informativo
• Patch: publicado aqui sem notificação