Handbuch / Zahlungen

Mollie einrichten

Aktualisiert am 2026-05-12

Zusätzlich zu Stripe unterstützen wir seit dem 12. Mai 2026 auch Mollie als Karten-Gateway. Mollie ist besonders interessant für NL-Betreiber, weil iDEAL ohne zusätzliche Stripe-Gebühren enthalten ist und Mollies Tarife pro Transaktion für europäische lokale Methoden bei einer durchschnittlichen B&B-Buchung von 100–500 € meist günstiger sind.

⚠️ Nur ein Gateway gleichzeitig. Pro Unterkunft wählst du entweder Stripe oder Mollie — nicht beide. Bancontact darf neben einem von beiden bleiben. Das Filament-Formular blendet das andere Gateway aus, sobald eines aktiv ist, und eine defensive zweite Prüfung auf Datenbankebene weist jeden Versuch ab, beide gleichzeitig zu aktivieren, mit einer klaren Fehlermeldung.

Wann Mollie statt Stripe wählen?

| Situation | Besser | Warum | |---|---|---| | Hauptsächlich NL-Gäste | Mollie | iDEAL enthalten, ~0,29 € pro Transaktion statt 1,4 % bei Stripe | | Hauptsächlich BE-Gäste | Egal | Bancontact konfigurierst du sowieso separat; Kartenfees liegen nah beieinander | | Internationale Gäste, Amex / Apple Pay | Stripe | Mollie unterstützt Apple Pay, aber Stripes Amex-Coverage und der mobile Apple-Pay-Flow sind etwas geschmeidiger | | Du hast bereits ein Mollie-Konto für deine alte Website | Mollie | Ein Dashboard für PMS + bestehenden Shop, ein CODA-Import | | Recurring (zukünftiges Auto-Pay) | Stripe | Stripe SCA + Mandates sind reifer als Mollies Erstzahlungs-Flow |

Keine falsche Wahl: Du kannst später wechseln — schalte das eine Gateway aus, fülle das andere aus, und /pay wechselt sofort für neue Buchungen.

Mollie-Konto erstellen

  1. Gehe zu mollie.com/dashboard/signup und lege ein Händlerkonto an.
  2. Hinterlege deine USt-IdNr. / KvK-Nummer (NL/BE/DE werden innerhalb eines Werktags freigeschaltet).
  3. Aktiviere im Dashboard die Methoden, die du anbieten willst — mindestens Kreditkarte und iDEAL für die meisten B&Bs.
  4. Öffne Developers → API keys und kopiere den Live API key (beginnt mit live_). Für Tests zuerst den Test API key (test_) verwenden.

In BedFlow einstellen

  1. Öffne in Filament die Unterkunft, die Mollie nutzen soll (Properties → Unterkunft wählen → Bearbeiten).
  2. Scrolle zum Abschnitt Zahlungen (Stripe oder Mollie + Bancontact) und öffne den Mollie-Tab.
  3. Schalte Mollie aktiv für diese Unterkunft ein.
  4. Füge deinen Mollie API Key ein (live_… oder test_…).
  5. Profile ID leer lassen, außer du nutzt einen Organization access token (steht dann im Mollie-Dashboard unter Profil).
  6. Klicke auf Speichern.

💡 Wenn du einen Test-Key einträgst, ruft /pay/{rechnung} Mollies Test-Umgebung auf — keine echten Transaktionen. Vergiss nicht, beim Go-Live den Live-Key zu setzen.

Webhook-URL bei Mollie hinterlegen

Anders als Stripe registriert Mollie keinen Webhook im Dashboard — die Webhook-URL wird pro Zahlung im Create-Call mitgegeben. Du musst also nichts im Mollie-Dashboard registrieren. Wir übergeben bei jeder Payment-Erstellung diese URL:

https://bedflow.eu/webhooks/mollie

Was passiert:

  1. Mollie POSTet {id: tr_xxx}, sobald der Gast fertig ist.
  2. Wir prüfen alle Unterkünfte mit mollie_enabled = true, nehmen die erste, deren Key das Payment-Objekt holen kann, und nutzen diese Credentials zur Verifizierung.
  3. Bei status = "paid" wird die Rechnung als bezahlt markiert, eine Telegram-Benachrichtigung verschickt, gegebenenfalls der Wellness-Kalender aktualisiert und die Buchungsbestätigungs-Mail ausgelöst.

Kein Webhook-Secret nötig — Mollies Sicherheit basiert auf Besitz des API Keys: Wer das Payment abrufen kann, darf seinen Status kennen.

Was sieht der Gast?

Auf /pay/{rechnung-id} erscheint neben Bancontact (sofern aktiviert) ein blauer Mollie-Button „Mit Kreditkarte oder iDEAL über Mollie bezahlen". Ein Klick leitet den Gast zu Mollies eigenem hosted Checkout (mollie.com/checkout/select-method/...) weiter, wo iDEAL, Bancontact, Kreditkarte, Apple Pay oder SEPA gewählt werden können. Nach der Zahlung kommt der Gast automatisch auf /pay/{rechnung-id}/success zurück.

Reconciliation in Yuki / deiner Buchhaltung

Jede erfolgreiche Mollie-Zahlung wird als payment_reference = "mollie:tr_xxx" auf der Rechnung gespeichert + in payment_refs für Per-Payment-CODA-Matching. Der Mollie-Payout (einmal täglich oder wöchentlich, je nach Dashboard-Einstellung) erreicht dein Konto typischerweise 1-2 Werktage später und enthält in der Beschreibung die Mollie-Payment-IDs dieses Batches. Yuki / deine Buchhaltung kann über den Mollie-Export pro Payment zur richtigen Rechnung zurückrechnen über die mollie:tr_xxx-Referenz.

Wechsel von Stripe zu Mollie (oder umgekehrt)

  1. Schalte in Properties → Zahlungen das aktuelle Gateway aus (Toggle aus + speichern).
  2. Der andere Gateway-Abschnitt erscheint wieder; aktiviere ihn und fülle Credentials aus.
  3. Speichern. Neue /pay-Seiten nutzen ab sofort das neue Gateway.
  4. Offene, unbezahlte Zahlungs-Links funktionieren weiter — solange das alte Gateway noch Credentials hat. Erst wenn du den alten API-Key tatsächlich löschst, fallen diese alten Links um.

Verlorene Zahlungen durch zu frühen Wechsel haben wir noch nicht gesehen — Mollie und Stripe halten ihre Checkout-URLs typischerweise 24-72 Stunden gültig — aber gute Praxis ist, den Wechsel zu einem ruhigen Moment zu machen (Sonntagabend) und das alte Gateway noch 1-2 Tage stehen zu lassen.

Häufige Fehlermeldungen

| Fehlermeldung auf /pay | Bedeutung | |---|---| | „Mollie niet geconfigureerd voor deze property" | Toggle aus oder API-Key leer | | „The amount.value should be a string with two decimals" | Betrag unter 1,00 € — Mollie lehnt kleinere Transaktionen ab (in normalen Flows kein Problem; nur bei Wellness-Teilzahlungen relevant) | | „Invalid API key" | Test-Key in Live oder Tippfehler. Prüfe, ob der Key in Produktion mit live_ beginnt | | Telegram: „Mollie Checkout mislukt" | Allgemeiner API-Fehler — meist Mollie-Seite. Check status.mollie.com |

← Zurück zur Kategorie