Cobrança com vencimento

Informe due_date na criação da cobrança e ela passa a ser com vencimento (type: "due"):

{
  "amount": "500.00",
  "due_date": "2026-10-15",
  "days_after_due": 30,
  "payer": { "name": "Maria Souza", "document": "12345678909" },
  "fine": { "type": "percent", "value": "2.00" },
  "interest": { "type": "percent_per_month", "value": "1.00" },
  "discount": { "type": "percent_until_dates", "dates": [{ "until": "2026-10-10", "value": "5.00" }] },
  "external_ref": "mensalidade-2026-10"
}

• Pagador obrigatório (nome e CPF/CNPJ). Sem expires_in: a cobrança vale até due_date + days_after_due.
• Vencimento em fim de semana ou feriado bancário nacional é prorrogado para o primeiro dia útil (due.effective_due_date); multa e juros contam a partir daí.
• Multa (fine): fixed ou percent, uma vez após o vencimento.
• Juros (interest): amount_per_day, percent_per_day, percent_per_month ou percent_per_year, em dias corridos ou úteis (business_days: true).
• Desconto (discount): até 3 datas (fixed_until_dates / percent_until_dates) ou por dia de antecipação (amount_per_day_early / percent_per_day_early).
• Abatimento (rebate): fixed ou percent, em qualquer data.

Quanto o cliente paga

Quem calcula o valor final é o banco do pagador, na data do pagamento. A cobrança traz due.amount_due_today como estimativa; o pagamento traz components com a composição real:

"components": { "original": "500.00", "interest": "1.67", "fine": "10.00", "discount": "0.00", "rebate": "0.00" }

No sandbox, teste datas com simulate_payment e paid_on:

curl -X POST ".../v1/sandbox/charges/ch_…/simulate_payment" -H "Authorization: Bearer $PIX_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" -d '{"paid_on": "2026-10-20"}'