Guides · Payments

Invoices & part-payments

Issue invoices that your customer pays online from a private link (/i/{token}), with part payments allowed and no late fees.

Every invoice has an unguessable pay link. Send it from the dashboard or with POST /v1/billing/invoices/{id}/send, which emails the customer. The customer pays the balance (or any part, if you allowed part payments) through checkout, and the invoice moves to paid when nothing is left.

Webhooks: invoice.created when an invoice is made, invoice.part_paid after a payment that leaves a balance, invoice.paid when the balance reaches ₦0.00, invoice.overdue the first time a subscription invoice passes its due date, and invoice.voided when it is voided. Recording a bank transfer by hand sends the same payment events. An invoice with payments on it cannot be voided.

Enabling milestone & partial invoice payments

Set allowPartPayments: true and minimumPartPayment (e.g. "50000.00") when creating an invoice with POST /v1/billing/invoices. Each partial payment emits invoice.part_paid until the remaining balance reaches "0.00", which emits invoice.paid.