Handleiding / Betalingen

Mollie instellen

Bijgewerkt op 2026-08-17

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. BedFlow verbergt automatisch de andere gateway zodra je er één activeert, en weigert elke poging om beide tegelijk aan te zetten 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. Ga naar Instellingen → Integraties, sectie Betalingen, en klik op Instellingen bij de Mollie-tegel.
  2. Toggle Mollie inschakelen aan.
  3. Plak je API key (live_… of test_…).
  4. Profile ID laat je leeg. Dit veld is er alléén voor wie met een organization access token (access_…) werkt — dan vind je het Profile ID (pfl_…) op je Mollie-dashboard onder Profiel. Met een gewone API key hoort het leeg te blijven; vul je het toch in, dan wordt het genegeerd.
  5. 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. BedFlow zoekt automatisch uit bij welke property de betaling hoort en controleert ze met jouw eigen Mollie-sleutel.
  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 krijgt op de factuur de betaalreferentie mollie:tr_xxx, zodat elke betaling apart gematcht kan worden bij je bankreconciliatie (CODA). 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