Manual / Pagamentos

Configurar Mollie

Atualizado em 2026-05-12

Além do Stripe, desde 12 de maio de 2026 suportamos também o Mollie como gateway de cartões. O Mollie é especialmente interessante para operadores NL porque o iDEAL está incluído sem taxas Stripe extra, e os tarifários do Mollie por transação para métodos locais europeus tendem a ser mais baratos numa reserva média de B&B de 100–500 €.

⚠️ Um gateway de cada vez. Por alojamento escolhes Stripe ou Mollie — não ambos. O Bancontact pode ficar ao lado de um deles. O formulário Filament esconde o outro gateway assim que um está ativo, e uma segunda verificação defensiva ao nível da base de dados rejeita qualquer tentativa de ativar ambos com um erro claro.

Quando escolher Mollie em vez de Stripe?

| Situação | Melhor | Porquê | |---|---|---| | Sobretudo hóspedes NL | Mollie | iDEAL incluído, ~0,29 € por transação em vez de 1,4 % no Stripe | | Sobretudo hóspedes BE | Indiferente | O Bancontact configura-se à parte; as taxas de cartão são próximas | | Hóspedes internacionais, Amex / Apple Pay | Stripe | O Mollie suporta Apple Pay mas a cobertura Amex e o fluxo mobile Apple Pay no Stripe é um pouco mais fluido | | Já tens conta Mollie para o teu site antigo | Mollie | Um dashboard para PMS + loja existente, uma importação CODA | | Recorrente (futuro Auto-Pay) | Stripe | SCA + Mandates do Stripe são mais maduros que o fluxo de primeiro pagamento do Mollie |

Nenhuma escolha errada: podes mudar depois — desliga um gateway, preenche o outro, e /pay muda imediatamente para novas reservas.

Criar conta Mollie

  1. Vai a mollie.com/dashboard/signup e cria uma conta de comerciante.
  2. Indica o teu NIF / KvK (NL/BE/DE são ativados num dia útil).
  3. No dashboard ativa os métodos que queres oferecer — pelo menos cartão de crédito e iDEAL para a maioria dos B&Bs.
  4. Abre Developers → API keys e copia a Live API key (começa com live_). Para testes usa primeiro a Test API key (test_).

Configurar no BedFlow

  1. No Filament abre o alojamento que vai usar Mollie (Properties → escolher alojamento → Editar).
  2. Desce até à secção Pagamentos (Stripe ou Mollie + Bancontact) e abre o separador Mollie.
  3. Ativa Mollie ativo para este alojamento.
  4. Cola a tua chave API Mollie (live_… ou test_…).
  5. Deixa Profile ID em branco a menos que uses um Organization access token (aparece no dashboard Mollie em Perfil).
  6. Clica em Guardar.

💡 Se puseres uma chave de teste, /pay/{fatura} chamará o ambiente de testes do Mollie — sem transações reais. Não te esqueças de mudar para a chave live no go-live.

Registar o URL do webhook no Mollie

Ao contrário do Stripe, o Mollie não regista um webhook no dashboard — o URL do webhook é passado por pagamento na chamada de criação. Não tens que registar nada no dashboard Mollie. Passamos este URL em cada criação de pagamento:

https://bedflow.eu/webhooks/mollie

O que acontece:

  1. O Mollie faz POST de {id: tr_xxx} assim que o hóspede termina.
  2. Fazemos fan-out por todos os alojamentos com mollie_enabled = true, pegamos o primeiro cuja chave consegue obter o objeto payment, e usamos essas credenciais para verificação.
  3. Com status = "paid" a fatura é marcada como paga, é enviada uma notificação Telegram, o calendário wellness é atualizado quando aplicável, e o e-mail de confirmação de reserva é despoletado.

Sem webhook secret — a segurança do Mollie é posse da API key: quem consegue obter o pagamento, pode saber o seu estado.

O que vê o hóspede?

Em /pay/{id-fatura} aparece junto ao Bancontact (se ativado) um botão Mollie azul «Pagar com cartão ou iDEAL via Mollie». Ao clicar, o hóspede é encaminhado para o checkout hospedado do Mollie (mollie.com/checkout/select-method/...) onde pode escolher iDEAL, Bancontact, cartão, Apple Pay ou SEPA. Após pagar, volta automaticamente para /pay/{id-fatura}/success.

Reconciliação no Yuki / contabilidade

Cada pagamento Mollie bem-sucedido é guardado como payment_reference = "mollie:tr_xxx" na fatura e em payment_refs para matching CODA por pagamento. O payout Mollie (uma vez por dia ou por semana, conforme definido no dashboard) chega à tua conta tipicamente 1-2 dias úteis depois e inclui na descrição os IDs de pagamento Mollie desse batch. Yuki / a tua contabilidade pode usar a exportação Mollie por pagamento para chegar à fatura correta via a referência mollie:tr_xxx.

Mudar do Stripe para Mollie (ou vice-versa)

  1. Em Properties → Pagamentos desliga o gateway atual (toggle off + guardar).
  2. A secção do outro gateway reaparece; ativa-a e preenche credenciais.
  3. Guardar. As novas páginas /pay usam o novo gateway a partir de agora.
  4. Links de pagamento abertos por pagar continuam a funcionar enquanto o gateway antigo ainda tiver credenciais. Só quebram quando realmente apagas a chave API antiga.

Ainda não vimos pagamentos perdidos por uma mudança demasiado cedo — Mollie e Stripe mantêm tipicamente os URLs de checkout válidos 24-72 horas — mas é boa prática fazer a mudança num momento calmo (domingo à noite) e manter o gateway antigo durante mais 1-2 dias.

Erros comuns

| Erro em /pay | Significado | |---|---| | «Mollie niet geconfigureerd voor deze property» | Toggle desligado ou chave API vazia | | «The amount.value should be a string with two decimals» | Montante inferior a 1,00 € — Mollie recusa transações mais pequenas (sem impacto em fluxos normais; só pagamentos parciais wellness) | | «Invalid API key» | Chave de teste em produção, ou typo. Verifica que começa por live_ em produção | | Telegram: «Mollie Checkout mislukt» | Erro API genérico — normalmente lado Mollie. Verifica status.mollie.com |

← Voltar à categoria