Partial Payments

Partial payments allow you to record installment collections against a single invoice. This is useful when a client pays in milestones or when split bank transfers are received.

Pro Plan or higher

Partial payments are available starting on the Pro plan.

Record a Partial Payment

1. Open the invoice in question
2. Click Record payment
3. Enter the amount received
4. Optionally, add the payment date and payment method

Frihet automatically updates:

• Cumulative paid amount (paidAmount): sum of all recorded payments
• Invoice status: changes to partial while an outstanding balance remains
• Remaining balance: displayed in the invoice detail view

Status Flow

Status	Condition
sent	Invoice sent, no payments recorded
partial	At least one payment recorded, but the total does not cover the full invoice amount
paid	The sum of payments equals or exceeds the invoice total

Status transitions happen automatically — no manual status change is needed.

Payment History

Every invoice with partial payments displays a complete history:

• Date of each payment
• Amount
• Payment method
• User who recorded the payment

The history is immutable (audit trail) and is included in exports.

Notifications

When a partial payment is recorded:

• The invoice.updated event fires in webhooks; if the payment settles the invoice, invoice.paid fires too
• The dashboard reflects the update in collection metrics

API

The POST /v1/invoices/:id/paid endpoint accepts partial payments along with the paidDate field. The invoice status updates automatically based on the cumulative paid amount.

---

Related: Collections and payments · Deposits and advances · REST API