Comece por aqui

Convenções

Valores, datas, papéis e o formato padrão de erro da API.

Valores

Centavos (inteiro) em cobranças (`amount`), links (`amount`), saldo (`value`) e transferências (`value`). Ex.: 15035 = R$ 150,35.
Reais (decimal) apenas em QR Codes (`value`, `original_value`). Ex.: 50.0 = R$ 50,00.

Datas de vencimento usam YYYY-MM-DD. Instantes (criação, atualização, expiração de link) usam ISO 8601 em UTC.

role	Acesso
PARTNER	Operação da própria conta: cobranças, links, Pix, lotes.
MASTER	Tudo do PARTNER, mais criação de parceiros.

JSON

{
  "error": "Dados inválidos.",
  "details": {}
}

Sempre JSON. `details` aparece em validação (Zod) ou quando a malha de pagamentos devolve contexto extra.