Skip to content
Changelog

Week of September 14, 2026

2 changes to the Flint API, SDKs, and docs, newest first, from September 19, 2026 to September 20, 2026. The newest changes are on the changelog.
  • API
  • Invoices
  • Refunds

Refund a credit note on a paid invoice#

Superseded by Credit-note refunds move to the refunds API.

A credit note can now return money. Until this release a note could only be allocated against an outstanding balance, so a correction to a paid invoice meant a credit note for the paperwork and a separate refund against the order. Now the note creates the refund, and the refund stays linked to it.

To issue a draft and refund it in one call, add refund to POST /v1/credit-notes/{credit_note_id}/issue. The response keeps the credit note at data and adds the refund at data.refund. For a note that is already issued, call POST /v1/credit-notes/{credit_note_id}/refunds, which returns the Refund resource. Both accept amount_money, reason, and reason_message. Leave amount_money out to refund all available credit. The money goes back to the original payment methods; payments you recorded manually are not eligible.

Both calls require a caller-chosen Idempotency-Key, and both need commerce.credit_notes.write and commerce.refunds.write. Flint keeps the key for the life of the refund. To recover a response you lost, call GET /v1/credit-notes/{credit_note_id}/refunds?idempotency_key=..., which needs both read scopes.

Credit notes carry two new fields. pending_refund_money reserves credit while a refund is unresolved, and refunded_money records what succeeded. Both reduce unallocated_money, and a failed or canceled refund releases its amount. Refunds created this way carry credit_note_id and invoice_id, and they fire the existing refund.* events. The invoice stays paid, with refund_status and refunded_money tracking the refund as before.

A credit note cannot be voided while a refund on it is pending or after one succeeds; the call returns CREDIT_NOTE_HAS_ALLOCATIONS. A refund larger than the available credit returns CREDIT_NOTE_REFUND_EXCEEDS_BALANCE, and an ineligible invoice or note returns CREDIT_NOTE_REFUND_INVALID.

These changes are additive. See Refund a paid invoice for the walkthrough.

  • API
  • Invoices
  • Tax

Invoice late fees and automatic tax on invoices#

Late fees are now part of the invoice balance. invoice.late_fee_due still fires after the grace period on the invoice's payment term, and it remains a notice. To charge it, call POST /v1/invoices/{invoice_id}/late-fees, which assesses the frozen policy against the current unpaid principal, once per invoice or per overdue schedule entry. Send invoice_schedule_entry_id for a scheduled invoice and {} for an unscheduled one.

POST /v1/invoices/{invoice_id}/late-fees/{invoice_late_fee_id}/waive waives the unpaid remainder and requires a reason, which is visible only to you. A waiver leaves collected money in place; refund it through the Refunds API.

Invoice responses carry late_fees, with each fee's calculation inputs, assessed amount, paid amount, waived amount, and outstanding amount. An assessed fee raises the outstanding balance and appears as a dated addendum on the hosted invoice and the PDF. The issued line items, tax, and original total do not change. Subscribe to invoice.late_fee_assessed and invoice.late_fee_waived to track the balance, and late_fee_assessed and late_fee_waived join the invoice event timeline.

This release supports fixed and percentage policies, without recurring fees, compounding, or tax on the fee.

Quaderno-connected automatic tax also works on invoices now. Issue freezes the calculation, and the invoice takes one payment for its full balance: a schedule for less than the balance fails with AUTOMATIC_TAX_INVOICE_INSTALLMENTS_UNSUPPORTED, and a partial payment fails with AUTOMATIC_TAX_PARTIAL_PAYMENT_UNSUPPORTED. Editing the backing order after issue fails collection with INVOICE_TAX_SNAPSHOT_STALE; void the invoice and issue it again. Use external tax for a deposit, installments, or a balance collected in pieces.