For partners: Reconciliation of Mollie Invoices

From 1 January 2020, the Mollie Dashboard will be upgraded. We will gradually migrate our customers. Before we migrate your account to the upgraded dashboard, we will inform you in advance by email. Only if your dashboard has been upgraded, the information below applies to you.

This section will describe the process of matching invoices to the withheld fees and other related events.

Time-based & Settlement-based exports (MT940, CODA)

The exports will contain cost / invoice related transactions that should be recognized and matched to the invoice. All such transactions will contain an invoice number. The following transactions can be expected:

  • Withheld transaction fees: Negative transaction that represents prepayments (money withheld from payment settlements, etc.) for fees.
  • Invoice compensation: Positive transaction from Mollie B.V. to the merchant’s balance to compensate for overpayment of the invoice (too much was withheld from payment settlements, etc.).

The invoice can be retrieved from the API separately, which will have the invoice number in the response.

Note: Any export can contain multiple of either of these transactions for different invoices. For example, a settlement-based export can be requested for a settlement with withheld transaction fees spanning 2 periods and thus 2 invoices. Furthermore, yearly time-based exports will contain even more of such transactions, as these span all months and thus all invoices of that year. Such transactions will always be clearly separated in the export by the different invoice numbers in their description.

Settlements API

You can also reconcile the Mollie Invoice, with the Settlement API. This enables you to do this automatically, without downloading and uploading any files. Less effort for you or your merchants!

When a settlement is detected on the bank account you can query the Settlements API, and in the last settlements find the settlement who holds the settlement description. By using the Settlements API you can find all details about this settlement.

The Settlement API provides a breakdown of all revenue (payments / refunds / chargebacks) and costs (withheld transaction fees) per period. The period is specified per year and month. When the merchant has been migrated, next to the already existing “revenue” and “costs” arrays, there will be a new field; the “invoiceId” variable. This variable will correlate all costs of that period the invoice mentioned in that field.

Every transaction that should be matched to an invoice will be an element in this “costs” array and the invoice that it should be matched with will be the one in the “invoiceId” field of that period.

We advise you to summarise all costs per period and book this against the given invoice from the “InvoiceId'' field. This will make the reconciliation of the Mollie Invoice complete.