Handleiding / Betalingen

Mollie instellen

Bijgewerkt op 2026-05-12

Naast Stripe ondersteunen we sinds 12 mei 2026 ook Mollie als creditcard-gateway. Mollie is vooral interessant voor NL-operators omdat iDEAL standaard inbegrepen zit zonder extra Stripe-fees, en omdat de Mollie-tarieven voor lokale Europese betaalmethodes vaak gunstiger zijn voor een gemiddelde B&B-booking van €100–€500.

⚠️ Eén gateway tegelijk. Per property kies je ofwel Stripe ofwel Mollie — niet beide. Bancontact mag wel naast één van beide blijven staan. De Filament-instelling verbergt automatisch de andere gateway zodra je er één activeert, en er zit een tweede defensieve check op database-niveau die elke poging om beide aan te zetten weigert met een duidelijke foutmelding.

Wanneer kies je Mollie boven Stripe?

| Situatie | Beter | Waarom | |---|---|---| | Vooral NL-gasten | Mollie | iDEAL inbegrepen, ~0,29 € per transactie i.p.v. 1,4% van Stripe | | Vooral BE-gasten | Geen verschil | Bancontact regel je sowieso apart; creditcard-fees liggen dichtbij elkaar | | Internationale gasten met Amex / Apple Pay | Stripe | Mollie ondersteunt Apple Pay maar de Amex-coverage en het mobiele Apple-Pay-flow is bij Stripe iets soepeler | | Je hebt al een Mollie-account voor je oude website | Mollie | Eén dashboard voor PMS + bestaande shop, één coda-import | | Recurring (toekomstige Auto-Pay) | Stripe | Stripe SCA + Mandates zijn rijper dan Mollie's eerste betaling-flow |

Geen verkeerde keuze: je kan altijd later wisselen — zet de ene gateway uit, vul de andere in, en /pay schakelt onmiddellijk om voor nieuwe boekingen.

Mollie-account aanmaken

  1. Ga naar mollie.com/dashboard/signup en maak een merchant-account.
  2. Vul je KvK / BTW-nummer in (NL/BE/DE worden binnen 1 werkdag geactiveerd).
  3. Activeer in het dashboard de methodes die je wil aanbieden — minstens creditcard en iDEAL voor de meeste B&B's.
  4. Open Developers → API keys en kopieer de Live API key (start met live_). Voor testen kan je eerst de Test API key (test_) gebruiken.

In BedFlow instellen

  1. Open in Filament de property die Mollie moet gebruiken (Properties → kies property → Bewerken).
  2. Scroll naar de sectie Betalingen (Stripe of Mollie + Bancontact) en open de Mollie-tab.
  3. Toggle Mollie actief voor deze property aan.
  4. Plak je Mollie API Key (live_… of test_…).
  5. Profile ID laat je leeg, tenzij je een Organization access token gebruikt (dan staat dat op je Mollie-dashboard onder Profiel).
  6. Klik Opslaan.

💡 Als je een test-key invult zal /pay/{factuur} de Mollie test-omgeving aanroepen — geen echte transacties. Vergeet niet om bij go-live je live-key in te vullen.

Webhook-URL bij Mollie registreren

In tegenstelling tot Stripe registreert Mollie geen webhook in z'n dashboard — de webhook-URL gaat per payment mee in de create-call. Je hoeft dus niks te registreren in Mollie's dashboard. Wij geven bij elke payment-creation deze URL mee:

https://bedflow.eu/webhooks/mollie

Wat hier gebeurt:

  1. Mollie POST't {id: tr_xxx} zodra de gast klaar is.
  2. Wij fan-out alle properties met mollie_enabled = true, pakken de eerste die het payment-object kan ophalen, en gebruiken die credentials voor verificatie.
  3. Bij status = "paid" wordt de factuur als betaald gemarkeerd, een Telegram-notificatie verstuurd, eventueel de wellness-kalender bijgewerkt en de booking-confirmation-email getriggerd.

Geen webhook-secret nodig — Mollie's beveiliging zit in bezit van de API key: wie de payment kan ophalen, mag z'n status weten.

Wat ziet de gast?

Op /pay/{factuur-id} verschijnt naast eventueel Bancontact een blauwe Mollie-knop "Betaal met kredietkaart of iDEAL via Mollie". Klikken stuurt de gast naar Mollie's eigen hosted checkout (mollie.com/checkout/select-method/...) waar hij iDEAL, Bancontact, creditcard, Apple Pay of SEPA kan kiezen. Na betaling komt hij automatisch terug op /pay/{factuur-id}/success.

Reconciliation in Yuki / je boekhouding

Iedere geslaagde Mollie-payment slaan we op als payment_reference = "mollie:tr_xxx" op de invoice + in payment_refs voor per-payment CODA-matching. De Mollie-payout (1× per dag of 1× per week, afhankelijk van je dashboard-instelling) ligt typisch 1-2 werkdagen later op je rekening en bevat in de omschrijving de Mollie-payment-ID's van die batch. Yuki / je boekhouding kan via de Mollie-export per payment terugrekenen naar de juiste factuur via de mollie:tr_xxx-referentie.

Wisselen van Stripe naar Mollie (of omgekeerd)

  1. Zet in Properties → Betalingen de huidige gateway uit (toggle naar uit en sla op).
  2. De andere gateway-sectie wordt weer zichtbaar; toggle die aan en vul credentials in.
  3. Sla op. Nieuwe /pay-pagina's gebruiken vanaf nu de nieuwe gateway.
  4. Lopende, niet-betaalde betaal-links blijven werken — zolang de oude gateway nog credentials heeft. Pas wanneer je de oude API-key écht verwijdert vallen die oude links om.

Verloren betalingen door een te vroege switch hebben we nog niet gezien — Mollie en Stripe houden hun checkout-URL's typisch 24-72 uur geldig — maar het is goede praktijk om de switch te doen op een rustig moment (zondagavond) en de oude gateway nog 1-2 dagen aan te houden.

Veelvoorkomende foutmeldingen

| Foutmelding op /pay | Wat het betekent | |---|---| | "Mollie niet geconfigureerd voor deze property" | Toggle staat uit of API-key is leeg | | "The amount.value should be a string with two decimals" | Bedrag onder €1,00 — Mollie weigert kleinere transacties (geen probleem in normale flows; alleen relevant voor wellness-deelbetalingen) | | "Invalid API key" | Test-key in live, of typo. Check of de key met live_ start in productie | | Telegram: "Mollie Checkout mislukt" | Algemene API-fout — meestal Mollie's kant. Check status op status.mollie.com |

← Terug naar categorie