Saldo Devedor dos Títulos

Cada título (recebível dentro de uma operação) tem um saldo devedor calculado e rastreado automaticamente. Os campos exatos estão na Referência Técnica.

Fórmula do saldo

current_outstanding_balance_brl é recalculado automaticamente:

principal − pagamentos − descontos + juros + multa + mora

• Pagamentos são registrados automaticamente via PIX recebido ou pelo Backoffice.
• Juros de mora e multa são aplicados diariamente pelo sistema após o vencimento.

Trilha de eventos do saldo

GET /v1/titles/{id}/balance-events retorna a auditoria completa de cada alteração no saldo:

Tipo de evento	Descrição
PAYMENT_RECEIVED	Pagamento recebido (parcial ou total)
DISCOUNT_GRANTED	Desconto concedido
LATE_FEE_APPLIED	Multa por atraso aplicada (única vez)
DEFAULT_INTEREST_ACCRUED	Juros de mora diários
DUE_DATE_EXTENDED	Prorrogação de vencimento
WRITE_OFF	Baixa contábil
MANUAL_ADJUSTMENT	Ajuste manual pelo Backoffice

Cada evento traz outstanding_before_brl, outstanding_after_brl, o delta e o gatilho (triggered_by).