Manual / Pagos

Configurar Mollie

Actualizado el 2026-05-12

Además de Stripe, desde el 12 de mayo de 2026 también soportamos Mollie como pasarela de tarjetas. Mollie es especialmente interesante para operadores NL porque iDEAL viene incluido sin tarifas Stripe adicionales, y las tarifas por transacción de Mollie para métodos locales europeos suelen ser más baratas en una reserva media de B&B de 100–500 €.

⚠️ Una pasarela a la vez. Por alojamiento eliges Stripe o Mollie — no ambos. Bancontact puede quedar junto a uno de los dos. El formulario Filament oculta la otra pasarela en cuanto una está activa, y una segunda comprobación defensiva a nivel de base de datos rechaza cualquier intento de activar ambas con un error claro.

¿Cuándo elegir Mollie sobre Stripe?

| Situación | Mejor | Por qué | |---|---|---| | Sobre todo clientes NL | Mollie | iDEAL incluido, ~0,29 € por transacción en lugar de 1,4 % en Stripe | | Sobre todo clientes BE | Indiferente | Bancontact se configura aparte; las tarifas de tarjeta son similares | | Clientes internacionales, Amex / Apple Pay | Stripe | Mollie soporta Apple Pay pero la cobertura Amex y el flujo móvil Apple Pay en Stripe es algo más fluido | | Ya tienes cuenta Mollie para tu web antigua | Mollie | Un dashboard para PMS + tienda existente, una importación CODA | | Recurrente (futuro Auto-Pay) | Stripe | SCA + Mandates de Stripe están más maduros que el flujo de primer pago de Mollie |

No hay mala elección: puedes cambiar más tarde — desactiva una pasarela, rellena la otra, y /pay cambia inmediatamente para nuevas reservas.

Crear cuenta Mollie

  1. Ve a mollie.com/dashboard/signup y crea una cuenta de comercio.
  2. Indica tu KvK / NIF (NL/BE/DE se activan en un día laboral).
  3. En el dashboard activa los métodos que quieras ofrecer — al menos tarjeta de crédito e iDEAL para la mayoría de B&Bs.
  4. Abre Developers → API keys y copia la Live API key (empieza por live_). Para pruebas usa primero la Test API key (test_).

Configurar en BedFlow

  1. En Filament abre el alojamiento que vaya a usar Mollie (Properties → elegir alojamiento → Editar).
  2. Desplázate a la sección Pagos (Stripe o Mollie + Bancontact) y abre la pestaña Mollie.
  3. Activa Mollie activo para este alojamiento.
  4. Pega tu clave API Mollie (live_… o test_…).
  5. Deja Profile ID vacío salvo que uses un Organization access token (aparece en el dashboard Mollie en Perfil).
  6. Pulsa Guardar.

💡 Si pones una clave de prueba, /pay/{factura} llamará al entorno de pruebas de Mollie — sin transacciones reales. No olvides cambiar a la clave live al pasar a producción.

Registrar la URL del webhook en Mollie

A diferencia de Stripe, Mollie no registra un webhook en su dashboard — la URL del webhook se pasa por pago en la llamada de creación. No tienes que registrar nada en el dashboard de Mollie. Pasamos esta URL en cada creación de pago:

https://bedflow.eu/webhooks/mollie

Qué pasa:

  1. Mollie hace POST de {id: tr_xxx} en cuanto el huésped termina.
  2. Hacemos fan-out por todos los alojamientos con mollie_enabled = true, cogemos el primero cuya clave consigue obtener el objeto payment, y usamos esas credenciales para la verificación.
  3. Con status = "paid" la factura se marca como pagada, se envía una notificación Telegram, se actualiza el calendario wellness si corresponde, y se dispara el e-mail de confirmación de reserva.

Sin webhook secret — la seguridad de Mollie es posesión de la API key: quien pueda obtener el pago, puede conocer su estado.

¿Qué ve el huésped?

En /pay/{id-factura} aparece junto a Bancontact (si activado) un botón Mollie azul «Pagar con tarjeta o iDEAL via Mollie». Al pulsarlo se envía al huésped al checkout hospedado de Mollie (mollie.com/checkout/select-method/...) donde puede elegir iDEAL, Bancontact, tarjeta, Apple Pay o SEPA. Tras pagar vuelve automáticamente a /pay/{id-factura}/success.

Reconciliación en Yuki / tu contabilidad

Cada pago Mollie exitoso se guarda como payment_reference = "mollie:tr_xxx" en la factura y en payment_refs para matching CODA por pago. El payout Mollie (una vez al día o a la semana según ajuste del dashboard) llega a tu cuenta 1-2 días laborables después e incluye en la descripción los IDs de pago Mollie de ese lote. Yuki / tu contabilidad puede usar la exportación Mollie por pago para retroceder a la factura correcta vía la referencia mollie:tr_xxx.

Cambiar de Stripe a Mollie (o al revés)

  1. En Properties → Pagos desactiva la pasarela actual (toggle off + guardar).
  2. La sección de la otra pasarela reaparece; actívala y rellena credenciales.
  3. Guardar. Las nuevas páginas /pay usarán la nueva pasarela desde ese momento.
  4. Los enlaces de pago abiertos pendientes siguen funcionando mientras la pasarela antigua aún tenga credenciales. Solo se rompen cuando borras realmente la clave API antigua.

No hemos visto pagos perdidos por un cambio demasiado temprano — Mollie y Stripe mantienen las URLs de checkout válidas 24-72 horas normalmente — pero es buena práctica hacer el cambio en un momento tranquilo (domingo por la tarde) y mantener la pasarela antigua otros 1-2 días.

Errores comunes

| Error en /pay | Significado | |---|---| | «Mollie niet geconfigureerd voor deze property» | Toggle desactivado o clave API vacía | | «The amount.value should be a string with two decimals» | Importe inferior a 1,00 € — Mollie rechaza transacciones más pequeñas (no afecta flujos normales; solo pagos parciales wellness) | | «Invalid API key» | Clave de prueba en producción, o error tipográfico. Verifica que empieza por live_ en producción | | Telegram: «Mollie Checkout mislukt» | Error API genérico — normalmente lado Mollie. Revisa status.mollie.com |

← Volver a la categoría