# Visão Geral da API LURI v2

Bem-vindo à documentação oficial da **API LURI v2**. Nossa plataforma oferece infraestrutura financeira BaaS (Banking as a Service) e meios de pagamento para emissão e gestão de **Boletos Bancários**, **Boletos Híbridos (Boleto + Pix)**, **Cobranças Pix (`static`, `cob`, `cobv`)**, **Contas Digitais (Saldos e Extratos)**, **Sellers** e **Webhooks em Tempo Real**.

---

## Regras Gerais e Convenções da API

1. **Formato de Comunicação**: Todas as requisições e respostas utilizam JSON (`Content-Type: application/json; charset=utf-8`) sobre HTTPS (TLS 1.2+).
2. **Convenção de Valores em "Centavos" (Inteiros)**:
   - Nos endpoints de cobrança (`/v2/charge` e `/v2/charge/pix`) e nos webhooks `boleto.*` e `pix.*`, todos os valores monetários e percentuais (`amount`, `late_fee_amount`, `late_fee_percentage`, `interest_amount`, `interest_percentage`, `abatement_amount`, `discount[].amount`) são representados como **números inteiros com 2 casas decimais implícitas** (sem ponto ou vírgula).
   - *Exemplos*: `15000` = R$ 150,00; `200` = R$ 2,00 ou 2,00%; `100` = R$ 1,00 ou 1,00%.
3. **Autenticação e Escopos (`Basic Auth` vs. `JWT RS256`)**:
   - **Basic Auth**: Aceito nos endpoints de cobrança (`/v2/charge`, `/v2/charge/pix`), impressão (`/v2/print`), `/v2/sellers`, `/v2/leads`, `/v2/webhooks` e no cadastro inicial de chave pública (`POST /v2/auth/public-keys`).
   - **JWT RS256 (`Bearer Token`)**: Aceito em todos os endpoints da API e **obrigatório** para consulta de contas/extratos (`/v2/accounts`), gestão de chaves públicas (`GET/DELETE /v2/auth/public-keys`) e recebimento de webhooks de movimentação em conta (`account.*`).
4. **Suporte Nativo a Agentes de IA (`llms.txt`)**:
   - Esta documentação disponibiliza os arquivos [`llms.txt`](llms.txt) e [`llms-full.txt`](llms-full.txt) em Markdown puro otimizado para LLMs (Cursor, Claude, ChatGPT, GitHub Copilot), além de botões **"Copiar p/ IA"** em cada seção e endpoint.