Mollie

Mollie-betalingen (iDEAL, creditcard, Bancontact, terminal, etc.) worden gesynchroniseerd en gekoppeld aan betalingsrapporten via de settlement.

Mollie-settlements

Mollie-settlements: T+0. Tillor zoekt de settlement die op de rapportdatum is aangemaakt (zelfde dag) en koppelt alle betalingen. Geen settlement (bijv. weekend) → geen Mollie-deel in het rapport. Settlement-only betalingen (niet in Tillor) komen als "onbekende Mollie-betaling" in het rapport.

Mollie-betalingen

Ingestie elke nacht 03:00. Een betaling komt alleen in een rapport als het in de settlement van die datum zit. Bekend = Tillor-metadata (factuur/klant); onbekend = suspense (499000) tenzij tillor.bookkeeping metadata.

Mollie-metadata

Mollie slaat metadata op bij elke betaling. Tillor gebruikt drie soorten in de tillor-namespace: koppelingsmetadata (Tillor schrijft terug naar Mollie zodat de betaling herkenbaar is), ingestie-hints (jij zet ze bij het aanmaken van de Mollie-betaling om Tillor's gedrag te sturen) en directe boekhoudmetadata (volledige bypass van Tillor naar de boekhouding).

Tillor-koppelingsmetadata

{
  "tillor": {
    "paymentId": "clx123...",
    "invoiceId": "clx456...",
    "customerId": "clx789...",
    "paymentGroupId": "pmt_grp_abc",
    "descriptionSuffix": "Parkeerplaats P1"
  }
}

Zorgt voor webhook-koppeling en "bekende" betalingen in het rapport. Tillor schrijft deze velden zelf bij naar Mollie zodra een betaling aan een factuur, klant of betalingsgroep gekoppeld wordt.

Ingestie-hints voor betalingsgroepen

Bij het aanmaken van een Mollie-betaling kun je hints meegeven die Tillor bij ingestie gebruikt om de betaling automatisch in een betalingsgroep te bucketen. Handig voor POS-shifts, activiteitenboekingen, tafelbetalingen, of elk scenario waar je meerdere betalingen wil bundelen voor je een factuur boekt.

{
  "tillor": {
    "paymentGroupName": "Yoga sunrise - Lake Como",
    "paymentGroupExternalId": "act_42"
  }
}

Eén van beide velden is genoeg om de auto-bucketing te activeren. Beide samen is de aanrader wanneer het label in jouw systeem kan veranderen (activiteitenhernoeming, shift-relabel, ...) maar het onderliggende ID stabiel blijft.

Wat doet Tillor bij ingestie?

1. Tillor zoekt een open betalingsgroep met deze externe ID (of, als paymentGroupExternalId ontbreekt, met deze naam).
2. Geen match? Er wordt een nieuwe open groep aangemaakt. De naam is paymentGroupName als die meegegeven is, anders paymentGroupExternalId.
3. De betaling wordt aan de groep gekoppeld zodra ze de status PAID heeft.
4. Toegewezen groepen (al gekoppeld aan een factuur) worden niet hergebruikt; late betalingen met dezelfde sleutel komen in een verse open groep terecht.

Directe boekhoudmetadata (tillor.bookkeeping)

Onbekende Mollie-betalingen worden standaard op suspense (499000) geboekt. Met tillor.bookkeeping worden ze direct op de opgegeven klant geboekt:

{
  "tillor": {
    "bookkeeping": {
      "customerCode": "100001",
      "documentType": "INV",
      "department": "a",
      "fiscalYear": "2026",
      "documentNumber": "00042"
    }
  }
}