Handleiding / Плащания

Настройка на Mollie

Bijgewerkt op 2026-05-24

Освен Stripe от 12 май 2026 поддържаме и Mollie като креди­тно-картов gateway. Mollie е особено интересен за NL-оператори, защото iDEAL е включен по подразбиране без допълнителни Stripe-fees, и защото Mollie-тарифите за локални европейски методи на плащане често са по-благоприятни за средна B&B резервация от 100–500 €.

⚠️ Един gateway наведнъж. За всеки property избирате или Stripe, или Mollie — не и двата. Bancontact може да остане заедно с един от двата. Filament настройката автоматично скрива другия gateway веднага щом активирате един, а има и втора защитна проверка на ниво база данни, която отказва всеки опит за активиране на двата с ясно съобщение за грешка.

Кога избирате Mollie пред Stripe?

| Ситуация | По-добре | Защо | |---|---|---| | Предимно NL-гости | Mollie | iDEAL включен, ~0,29 € на транзакция вместо 1,4% при Stripe | | Предимно BE-гости | Без разлика | Bancontact уреждате така или иначе отделно; кредитно-картовите fees са близки | | Международни гости с Amex / Apple Pay | Stripe | Mollie поддържа Apple Pay, но Amex-покритието и mobile Apple Pay flow са малко по-плавни при Stripe | | Вече имате Mollie акаунт за стария Ви сайт | Mollie | Един dashboard за PMS + съществуващ shop, един coda-import | | Recurring (бъдещ Auto-Pay) | Stripe | Stripe SCA + Mandates са по-зрели от първото-плащане-flow на Mollie |

Няма грешен избор: винаги можете да смените по-късно — изключете единия gateway, попълнете другия и /pay веднага превключва за нови резервации.

Създаване на Mollie акаунт

  1. Отидете на mollie.com/dashboard/signup и създайте merchant-акаунт.
  2. Попълнете Вашия KvK / ДДС номер (NL/BE/DE се активират в рамките на 1 работен ден).
  3. Активирайте в dashboard методите, които искате да предлагате — поне creditcard и iDEAL за повечето B&B.
  4. Отворете Developers → API keys и копирайте Live API key (започва с live_). За тестване можете първо да използвате Test API key (test_).

Настройка в BedFlow

  1. Отворете във Filament property-то, което трябва да използва Mollie (Properties → изберете property → Редактирай).
  2. Скролнете до секцията Плащания (Stripe или Mollie + Bancontact) и отворете Mollie-таб.
  3. Включете toggle Mollie активен за този property.
  4. Поставете Вашия Mollie API Key (live_… или test_…).
  5. Profile ID оставете празно, освен ако не използвате Organization access token (тогава това стои на Вашия Mollie-dashboard под Profiel).
  6. Кликнете Запази.

💡 Ако попълните test-key, /pay/{factuur} ще извиква Mollie test environment — без реални транзакции. Не забравяйте при go-live да попълните live-key.

Регистриране на webhook URL при Mollie

За разлика от Stripe, Mollie не регистрира webhook в dashboard — webhook URL-ът се предава за всяко плащане в create-call. Така че не трябва да регистрирате нищо в Mollie dashboard. Ние предаваме при всяко създаване на плащане този URL:

https://bedflow.eu/webhooks/mollie

Какво се случва тук:

  1. Mollie POST-ва {id: tr_xxx} веднага щом гостът приключи.
  2. Ние fan-out към всички properties с mollie_enabled = true, вземаме първия, който може да извлече payment-обекта, и използваме тези credentials за верификация.
  3. При status = "paid" фактурата се маркира като платена, изпраща се Telegram-нотификация, евентуално се update-ва wellness-календарът и се trigger-ва booking-confirmation имейлът.

Не е нужен webhook-secret — сигурността на Mollie е във владеене на API ключа: който може да извлече плащането, може да знае статуса му.

Какво вижда гостът?

На /pay/{factuur-id} се появява до евентуалния Bancontact син Mollie-бутон "Плати с кредитна карта или iDEAL през Mollie". Кликването изпраща госта към Mollie hosted checkout (mollie.com/checkout/select-method/...), където може да избере iDEAL, Bancontact, кредитна карта, Apple Pay или SEPA. След плащане автоматично се връща на /pay/{factuur-id}/success.

Reconciliation в Yuki / Вашето счетоводство

Всяко успешно Mollie-плащане запазваме като payment_reference = "mollie:tr_xxx" върху фактурата + в payment_refs за per-payment CODA-matching. Mollie-payout (1× на ден или 1× на седмица в зависимост от настройката на Вашия dashboard) типично пристига 1-2 работни дни по-късно по сметката Ви и съдържа в описанието Mollie-payment-ID-тата от този batch. Yuki / Вашето счетоводство може през Mollie-export per payment да насочи обратно към правилната фактура през референцията mollie:tr_xxx.

Превключване от Stripe към Mollie (или обратното)

  1. Поставете в Properties → Плащания текущия gateway изключен (toggle на off и запазете).
  2. Секцията на другия gateway отново се появява; включете toggle и попълнете credentials.
  3. Запазете. Новите /pay страници от сега ползват новия gateway.
  4. Текущите, неплатени линкове за плащане продължават да работят — докато старият gateway все още има credentials. Едва когато наистина премахнете стария API-key, старите линкове падат.

Изгубени плащания заради твърде ранно превключване още не сме виждали — Mollie и Stripe пазят checkout-URL-ите си типично 24-72 часа — но е добра практика да направите превключването в спокоен момент (неделя вечер) и да задържите стария gateway още 1-2 дни.

Често срещани съобщения за грешка

| Съобщение за грешка на /pay | Какво означава | |---|---| | "Mollie не е конфигуриран за този property" | Toggle е изключен или API-key е празен | | "The amount.value should be a string with two decimals" | Сума под 1,00 € — Mollie отказва по-малки транзакции (не е проблем в нормален flow; само релевантно за wellness частични плащания) | | "Invalid API key" | Test-key в live, или typo. Проверете дали ключът започва с live_ в production | | Telegram: "Mollie Checkout се провали" | Обща API-грешка — обикновено от страна на Mollie. Проверете status на status.mollie.com |

← Terug naar categorie