Added

Multi-installment invoices are now available in the Company API v2

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.
MethodEndpoint
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

You 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.