Installation

This installation instruction assumes that you're using Symfony Flex and Rector. If you don't, take a look at the manual installation, but we strongly recommend using Flex and Rector for speed and simplicity.

1. Install the Plugin via Composer

composer require sylius/mollie-plugin:^3.1 --no-scripts -W

2. Run the Rector Upgrade for Mollie Plugin

Edit your rector.php config:

// rector.php
+ use Sylius\SyliusRector\Set\SyliusMollie;

return static function (RectorConfig $rectorConfig): void {
    // ...
+   $rectorConfig->sets([SyliusMollie::MOLLIE_PLUGIN_30]);
};

Then run Rector:

vendor/bin/rector

This step auto-applies required code changes (e.g., routing, services, configuration) for the plugin.

3. Run Doctrine Migrations

Update your database schema:

bin/console doctrine:migrations:migrate

4. Frontend Assets Installation

Install assets:

bin/console assets:install

Add JS dependencies:

yarn add bazinga-translator intl-messageformat lodash.get [email protected]

Build frontend assets:

yarn encore dev # for development
yarn encore production # for production

5. Clear the Symfony Cache

php bin/console cache:clear

🧩 Optional Features

These steps are optional but recommended depending on your use case.

Enable Refunds with Refund Plugin

To support order refunds:

composer require sylius/refund-plugin:^2.0.2 --no-scripts -W

Then follow Refund Plugin Installation Guide.

---

❗ Refund Plugin Troubleshooting

If you see: Duplicate transition 'complete' in state machine 'sylius_refund_refund_payment'

You likely have legacy state machine config.

Fix: Remove the file:

rm config/packages/sylius_refund.yaml

Load Fixtures

To populate the shop with demo data:

bin/console sylius:fixtures:load

Enable Mollie Payment Link Cronjob

Add this cron entry to send payment links automatically:

* * * * * /usr/bin/php /path/to/project/bin/console mollie:send-payment-link

Set Up Apple Pay

To support Apple Pay, upload this file to your server:

public/.well-known/apple-developer-merchantid-domain-association

Usage

During configuration, first save the keys to the database and then click "Load methods".