Mollie
Mollie settlements, payments and metadata
Last updated on
Mollie payments (iDEAL, credit card, Bancontact, terminal, etc.) are synchronised in Tillor and linked to payment reports via the Mollie settlement.
Connecting in Tillor
- Go to Settings > Integrations and choose Mollie in the list.
- Follow the Mollie OAuth steps if the connection is not yet active.
- On the detail page, under Website profile, choose a Primary profile (the Mollie website profile for payments and synchronisation). Optionally choose a Default terminal (the card device Tillor suggests by default on invoices).
- Click Save. Without a primary profile, Mollie payments do not work in Tillor; a terminal is only needed for card payments.
Status icons in the selection lists
To the left of the profile and terminal name is a coloured icon. That is the status at Mollie, not the name itself.
| Icon | Website profile | Terminal |
|---|---|---|
| Green (tick) | Verified - suitable for live payments | Active - ready for card payments |
| Orange (clock) | Not verified yet at Mollie | Pending - not yet active |
| Red (prohibited) | Blocked | - |
| Grey | - | Inactive |
Preferably choose a verified profile. An active terminal is optional and only needed if you want Tillor to suggest card payments. Without a primary profile, payments and synchronisation do not run.
Mollie settlements
As long as Mollie has not yet paid out a payment, it appears as an advance on the open draft report. Only when the report is finalised does the settlement decide which report it belongs to; see Mollie payments on the draft.
For report day D, Tillor looks for a settlement in this order:
- Settlement created on day D
- Otherwise settlement created on day D+1 (typically: revenue of D is paid out the next morning)
Fixed rules:
- Every settlement id appears on at most one payment report.
- Does a report already have a settlement? That link stays; Tillor does not replace it.
- If both D and D+1 are missing (for example a weekend): the report may already exist with only manual/bank account payments; as soon as Mollie publishes, the daily synchronisation adds Mollie.
Examples
| Report day D | Settlement created at Mollie | Result |
|---|---|---|
| Tue 20 May | Tue 20 May (stl_aaa) | PAYR/2026/0140 (20 May) gets stl_aaa |
| Tue 20 May | Wed 21 May early (stl_bbb) | PAYR/2026/0140 (20 May) gets stl_bbb (rule D+1) |
| Sun 18 May | Mon 19 May (stl_ccc) | PAYR/2026/0138 (Sunday) gets stl_ccc, not the Monday report |
| Mon 19 May | Mon 19 May (stl_ccc) | Monday report looks for its own settlement (stl_ddd on Tue or later), not stl_ccc |
| Sat 17 May | No settlement Sat/Sun/Mon morning | Report 17 May: manual/bank accounts first; Mollie follows once the settlement exists |
| Tue 20 May | Report already existed without settlement | Next run 09:00: settlement is still added on 20 May, payments linked |
In practice (D+1): revenue of Tuesday 20 May is in settlement stl_6necch, created Wednesday 21 May at 06:08. Tillor links stl_6necch to PAYR/2026/0140 (report day 20 May), not to the report of 21 May.
Existing report: was PAYR/2026/0140 already in Tillor without a linked Mollie settlement and with two manual lines? After the synchronisation, stl_6necch is still linked; existing lines stay; Mollie payments from that settlement are added.
Already linked: report 15 May already has stl_old. Tillor does not change that id. Loose Mollie payments with the same settlement id still end up on the report that already has that settlement.
Synchronisation on existing reports
After creating missing reports, Tillor looks only at reports without a linked Mollie settlement in a rolling window of one calendar month before yesterday up to yesterday. Reports that already have a Mollie settlement are not fetched again via the Mollie settlement list.
Payments that already have a settlement id from Mollie but are not yet on a report end up on the report with the same settlement id.
Mollie payments in Tillor
Tillor fetches Mollie payments every 15 minutes (per organisation with an active Mollie connection). Webhooks from Mollie also work immediately: a payment becomes Paid, Refunded or Charged Back straight away, even if it originated outside Tillor (for example a card machine). If in doubt, or after a missed webhook: Sync in the action menu of the payment.
A payment ends up on a report if:
- it is in the linked settlement (Mollie's list), or
- the payment already has a settlement id that belongs to the report.
| Type in report | Meaning |
|---|---|
| Known | Payment linked to an invoice in Tillor |
| Unknown | No invoice link in Tillor → suspense account 499000, unless you send accounting details along via Mollie |
Settlement payments that do not exist in Tillor appear as an unknown Mollie payment on the report.
On a payment report you see linked Mollie payments in the Payments table:
Mollie metadata
Do you have a till or another system that creates Mollie payments itself? You can steer Tillor through metadata on that payment: linking to an invoice or payment group, or straight to accounting. The fields are described under Mollie metadata.