From invoice to payment - Flow

Find attached a visualization of the high-level flow for a NORMAL invoice, from creation to settlement and bookkeeping.

For information about Creating the Invoice, visit B2B Invoice - Creating Invoices

Key parameters controlling the flow

While creating the invoice, two specific optional parameters will be decisive for the invoice status and can be used to control flow; draft and sendInvoice. If draft=true, the invoice will have the status draft and can be updated as many times as before finalisation (/final). If, sendInvoice=false, you can postpone the invoice and send in the finalisation API Call.

A draft invoice can always be finalized in a later stage, when the draft invoice is confirmed to be due to no more changes, but as seen in the flow below, it can also be paid in the draft state, acting as a prepayment or proforma invoice.

Normal Invoice - Part 1 - From Creation to Receival

There are several invoices types (see Invoice Types and Methods fore more information) available, but the most common is the type Normal, that follows a standardised process for customers that are offered to Pay Later and required to pay upon Due Date.

Normal Invoice - Part 2- Payment & Payment Recognition

Independent of the type of Payment Method used by the customer, Payer matches payments to one or several Invoices. For incoming payments not initiated via Payer, for example normal bank payments, Payer retrieves the information via Payer's bank integrations and process, matches and reconcile the payments to one or several invoices and credit notes.

Notifications of paid invoices

The easiest way to know if an invoice is paid, is to setup a subscription for INVOICE__PAYMENT_ RECEIVED in our Events API or another equivalent Event.

The payment's are also available if you fetch the invoices using GET /api/v3/invoices and are also visible manually in Payer's Merchant Admin Portal and in Reports.

Other Events

You can subscribe for key events during the flow, e.g. when invoices are created, paid etc. For more information, go to Events API and Subscribing to Events.