Webhooks

What are webhooks?

Webhooks are used to connect different systems. They provide a way of how they can talk with each other.

So whenever there is an update for an order, Mollie will fire a webhook and notify Shopware about any updates, such as a payment status.

This means, that Shopware will need to provide a webhook endpoint for these notifications. And that is done by the Mollie plugin.

Configuration

In most cases it's not necessary to configure anything to receive notifications.

However, if you are in a testing or staging environment, or have a strict production setup, please make sure these URLs are publicly available:

Basic Webhook

This is the basic webhook for all (non-subscription) payments. It has to be available to get updates of orders from Mollie

http(s)://{{your-domain}}/mollie/webhook

Subscription Webhook

This webhook is used for everything regarding subscriptions. It will be called when renewing a subscription (which usually creates a new order), but also for updating orders/payments of subscriptions.

http(s)://{{your-domain}}/mollie/webhook/{subscriptionId}

Subscription Webhook (Legacy)

This was the initial webhook for the subscriptions. It unfortunately implied that it would only process the renewing of subscriptions. But in reality it also handles updates of payment statuses of orders from subscriptions.

We transitioned to a better named webhook, however, for old subscriptions, this URL still needs to be available (at least while they are still used).

http(s)://{{your-domain}}/mollie/subscription/{subscriptionId}/renew

What IPs will the webhook requests be originating from?

If you want to create a whitelist for the IP range of Mollie, please refer to this page: https://help.mollie.com/hc/en-us/articles/213470829

What about headless setups?

For headless setups, there are more routes and webhook involved. Please see our guide on the headless integration.