Configurer Mollie

Mis à jour le 2026-05-12

En plus de Stripe, depuis le 12 mai 2026 nous prenons également en charge Mollie comme passerelle de paiement par carte. Mollie est particulièrement intéressant pour les opérateurs NL parce que iDEAL est inclus sans frais Stripe supplémentaires, et les tarifs par transaction de Mollie pour les méthodes locales européennes sont souvent moins chers pour une réservation B&B moyenne de 100 à 500 €.

⚠️ Une seule passerelle à la fois. Par hébergement vous choisissez soit Stripe soit Mollie — pas les deux. Bancontact peut rester à côté de l'un des deux. Le formulaire Filament masque l'autre passerelle dès qu'une est active, et un second contrôle défensif au niveau base de données refuse toute tentative d'activer les deux avec une erreur claire.

Quand choisir Mollie plutôt que Stripe ?

| Situation | Meilleur | Pourquoi | |---|---|---| | Surtout des clients NL | Mollie | iDEAL inclus, ~0,29 € par transaction au lieu de 1,4 % chez Stripe | | Surtout des clients BE | Indifférent | Bancontact se configure séparément ; les frais carte sont proches | | Clients internationaux, Amex / Apple Pay | Stripe | Mollie prend en charge Apple Pay mais la couverture Amex et le flux mobile Apple Pay sont un peu plus fluides chez Stripe | | Vous avez déjà un compte Mollie pour votre ancien site | Mollie | Un dashboard pour PMS + boutique existante, un import CODA | | Récurrent (futur Auto-Pay) | Stripe | SCA + Mandates Stripe sont plus matures que le flux premier-paiement de Mollie |

Pas de mauvais choix : vous pouvez changer plus tard — désactivez une passerelle, remplissez l'autre, et /pay bascule immédiatement pour les nouvelles réservations.

Créer un compte Mollie

Rendez-vous sur mollie.com/dashboard/signup et créez un compte marchand.
Renseignez votre numéro KvK / TVA (NL/BE/DE sont activés sous un jour ouvré).
Dans le dashboard activez les méthodes que vous voulez proposer — au minimum carte de crédit et iDEAL pour la plupart des B&B.
Ouvrez Developers → API keys et copiez la Live API key (commence par live_). Pour tester, utilisez d'abord la Test API key (test_).

Configurer dans BedFlow

Dans Filament ouvrez l'hébergement qui doit utiliser Mollie (Properties → choisir l'hébergement → Modifier).
Faites défiler jusqu'à la section Paiements (Stripe ou Mollie + Bancontact) et ouvrez l'onglet Mollie.
Activez Mollie actif pour cet hébergement.
Collez votre clé API Mollie (live_… ou test_…).
Laissez Profile ID vide, sauf si vous utilisez un Organization access token (apparaît dans le dashboard Mollie sous Profil).
Cliquez sur Enregistrer.

💡 Si vous saisissez une clé de test, /pay/{facture} interrogera l'environnement de test Mollie — pas de vraies transactions. N'oubliez pas la clé live au passage en production.

Enregistrer l'URL de webhook chez Mollie

Contrairement à Stripe, Mollie n'enregistre pas un webhook dans son dashboard — l'URL est transmise par paiement dans l'appel de création. Vous n'avez donc rien à enregistrer dans le dashboard Mollie. Nous transmettons cette URL à chaque création de paiement :

https://bedflow.eu/webhooks/mollie

Ce qui se passe :

Mollie POST {id: tr_xxx} dès que le client a terminé.
Nous parcourons tous les hébergements avec mollie_enabled = true, prenons le premier dont la clé peut récupérer l'objet payment, et utilisons ces identifiants pour la vérification.
Si status = "paid" la facture passe en payée, une notification Telegram part, le calendrier wellness est mis à jour si applicable, et l'e-mail de confirmation de réservation est déclenché.

Pas de webhook secret nécessaire — la sécurité Mollie repose sur la possession de la clé API : qui peut récupérer le paiement peut connaître son statut.

Que voit le client ?

Sur /pay/{id-facture} apparaît à côté de Bancontact (si activé) un bouton Mollie bleu « Payer par carte de crédit ou iDEAL via Mollie ». Le clic envoie le client vers le checkout hébergé Mollie (mollie.com/checkout/select-method/...) où il peut choisir iDEAL, Bancontact, carte, Apple Pay ou SEPA. Après paiement, retour automatique sur /pay/{id-facture}/success.

Réconciliation dans Yuki / votre comptabilité

Chaque paiement Mollie réussi est stocké comme payment_reference = "mollie:tr_xxx" sur la facture et dans payment_refs pour le matching CODA par paiement. Le payout Mollie (une fois par jour ou une fois par semaine selon le réglage du dashboard) arrive typiquement sur votre compte 1 à 2 jours ouvrés plus tard et contient les IDs de paiement Mollie de la batch dans la description. Yuki / votre comptabilité peut utiliser l'export Mollie par paiement pour retracer la facture exacte via la référence mollie:tr_xxx.

Passer de Stripe à Mollie (ou retour)

Dans Properties → Paiements désactivez la passerelle actuelle (basculez sur off et enregistrez).
La section de l'autre passerelle réapparaît ; activez-la et remplissez les identifiants.
Enregistrez. Les nouvelles pages /pay utilisent désormais la nouvelle passerelle.
Les liens de paiement ouverts non réglés continuent à fonctionner tant que l'ancienne passerelle a encore des identifiants. Ces anciens liens ne cassent qu'au moment où vous supprimez réellement l'ancienne clé API.

Nous n'avons pas encore observé de paiements perdus à cause d'une bascule trop rapide — Mollie et Stripe gardent typiquement les URL de checkout valides 24-72 heures — mais c'est une bonne pratique de faire le switch à un moment calme (dimanche soir) et de garder l'ancienne passerelle encore 1-2 jours.

Erreurs courantes

| Erreur sur /pay | Signification | |---|---| | « Mollie niet geconfigureerd voor deze property » | Toggle désactivé ou clé API vide | | « The amount.value should be a string with two decimals » | Montant sous 1,00 € — Mollie refuse les petites transactions (pas un problème en flux normal ; seulement pour paiements partiels wellness) | | « Invalid API key » | Clé de test en production, ou faute de frappe. Vérifiez que la clé commence par live_ en production | | Telegram : « Mollie Checkout mislukt » | Erreur API générique — généralement côté Mollie. Vérifiez status.mollie.com |