mod_payment_mollie

Provide Mollie payments and recurring subscriptions through mod_payment.

Enable mod_payment_mollie with its mod_payment and mod_admin dependencies. Configure the site under System → Payment configuration with use.mod_admin_config. Select this adapter with #payment_request{preferred_psp_module = mod_payment_mollie}. Checkout creation supports EUR and USD.

Site configuration

api_key: secret Mollie API key. A test_ key selects test payments; a live_ key selects live payments.
recurring_payment_interval: monthly or yearly, defaulting to yearly.
webhook_host: optional public origin, including protocol and without a trailing slash. Defaults to the site's absolute URL.
sync_periodic: automatically maintained synchronization cursor; leave unset when configuring the module.

The adapter generates /mollie/webhook/:payment_nr callback URLs. Callbacks identify an existing local payment and retrieve payment data from the authenticated Mollie API before updating it. Recurring payments have a daily synchronization path.

Four-hour discovery of previously unknown payments uses the shared mod_payment options and retention cutoff. This polls the configured Mollie profile's payments; it does not turn the existing payment-specific callback into a generic webhook.

Configuration

Configuration keys declared by this module. The defaults below are from the source code.

Module	Key	Type	Default	Description
`mod_payment_mollie`	`api_key`	`binary`	`<<>>`	Required secret Mollie API key. Use a test_ key for test payments or a live_ key for live payments.
`mod_payment_mollie`	`profiles_access_token`	`binary`	`<<>>`	Optional advanced access token with profiles.read permission to list available Mollie profiles. Used only for profile lookup; payments still use the API key.
`mod_payment_mollie`	`recurring_payment_interval`	`binary`	`<<"yearly">>`	Interval for new recurring subscriptions: monthly or yearly. Defaults to yearly.
`mod_payment_mollie`	`disable_webhooks`	`boolean`	`false`	Omit webhooks from new Mollie payments and subscriptions. Webhooks are also omitted automatically for .test and localhost webhook hosts. Existing Mollie webhooks are not changed.
`mod_payment_mollie`	`webhook_host`	`binary`	`<<>>`	Optional webhook origin, including http:// or https:// and without a trailing slash. Defaults to the site's absolute URL. Useful for testing through a public host.
`mod_payment_mollie`	`sync_periodic`	`binary`	`<<>>`	Internal synchronization cursor: the newest Mollie createdAt timestamp processed by the periodic payment sync. Updated automatically; normally leave unset.

Observes

Notification

cancel_recurring_psp_request

Notification

payment_psp_poll

Notification

payment_psp_request

Notification

payment_psp_status_sync

Notification

payment_psp_view_url

Notifications

observe_request_context/3

Refresh the context or request process for the given request or action

Notification

tick_24h

Models

m_payment_mollie_api

Call Mollie and translate payments and subscriptions into local payment updates.

Models

m_payment_mollie_config

The webhooks model path exposes effective webhook configuration to administrators only. A .test hostname is a local-development heuristic, not an Internet…

Models

m_payment_mollie_profiles

Look up the current API key's profile, or all profiles accessible to the optional profiles_access_token with profiles.read permission. The list model path…

Controllers

controller_mollie_webhook

Handle Mollie checkout callbacks.

Type at least two characters

mod_payment_mollie

Site configuration

Configuration

Observes

cancel_recurring_psp_request

payment_psp_poll

payment_psp_request

payment_psp_status_sync

payment_psp_view_url

observe_request_context/3

tick_24h

Models

m_payment_mollie_api

m_payment_mollie_config

m_payment_mollie_profiles

Controllers

controller_mollie_webhook

Dispatch rules