Added
Multi-installment invoices are now available in the Company API v2
November 4th, 2026 by Integrations Squad
You can now split a customer invoice into several installments, each with its own deadline, amount and accepted payment methods.
New endpoints
- List the installments of a customer invoice: deadline, amounts, remaining amount, status and payment methods.
- Mark an installment as paid.
| Method | Endpoint |
|---|---|
GET | /api/external/v2/customer_invoices/{customer_invoice_id}/installments |
PUT | /api/external/v2/customer_invoices/{customer_invoice_id}/installments/{id}/mark_as_paid |
New installments parameter
installments parameterYou can now send installments on:
- Create a customer invoice:
POST /api/external/v2/customer_invoices - Import an invoice with file attached:
POST /api/external/v2/customer_invoices/import - Import an e-invoice:
POST /api/external/v2/customer_invoices/e_invoices/imports - Import and convert to an e-invoice:
POST /api/external/v2/customer_invoices/e_invoices/import_and_convert
Each installment takes a deadline, an amount and optional payment_methods (transfer, e_transfer, credit_card, sepa, cheque, cash, lcr, pro_account_pos).
You can also add, update or delete installments on:
- Update a customer invoice:
PUT /api/external/v2/customer_invoices/{id} - Update an imported customer invoice:
PUT /api/external/v2/customer_invoices/{id}/update_imported
"installments": [
{ "deadline": "2026-12-01", "amount": "600.00", "payment_methods": ["transfer"] },
{ "deadline": "2027-01-01", "amount": "600.00", "payment_methods": ["transfer", "sepa"] }
]Rules
- The sum of the installment amounts must equal the invoice total with tax.
- Multiple installments are only supported for invoices in EUR.
- Invoices issued by a billing subscription cannot have multiple installments.
- If you don't send installments, a single installment matching the invoice total is created automatically.
- Installments that are paid, cancelled or waiting_funds can't be updated or deleted.
- An invoice that has several installments can't go back to a single installment.
Response
Customer invoices now return an installments object containing the url of the list endpoint above.
Access
Check access with features endpoint here: https://pennylane.readme.io/reference/getcompanyfeatures
- Scopes:
- Creating, updating and marking as paid require customer_invoices:all.
- Listing installments also works with customer_invoices:readonly.
- Plan: the company's plan must include Installments. Otherwise, sending installments or calling mark-as-paid returns 403.

