Mollie Payments Plugin

This plugin provides seamless Mollie integration for Sylius stores.

Accept payments through over 20 different methods with Mollie – trusted by over 70,000 businesses in Europe.

--- ## Table of Contents * [Overview](#overview) * [Demo](#mollie-plugin-demo) * [Installation](#installation) * [Usage](#usage) * [Recurring subscription (internal CRON)](doc/recurring.md) * [Recurring payments](doc/recurring.md) * [Community](#community) --- ## Overview    [Mollie](https://www.mollie.com/) is one of the most advanced and developer-friendly payment gateways in Europe. This plugin integrates Mollie into Sylius and is officially certified by Mollie. > Our mission is to create a greater playing field for everyone. By offering convenient, safe world-wide payment solutions we remove barriers so you could focus on growing your business. Mollie provides a powerful API allowing webshop and app developers to implement over 20 payment methods with ease. Their services are fast, reliable, and constantly innovating the European payments landscape. --- ## Demo You can quickly test the plugin using Docker. Just run: If you'd like to run it in development mode (with debug tools enabled), use: --- ## Installation #### Beware! This installation instruction assumes that you're using Symfony Flex. If you don't, take a look at the [legacy installation instruction](doc/legacy_installation.md). However, we strongly encourage you to use Symfony Flex, it's much quicker! #### 1. Ensure that you have `wkhtmltopdf` installed, and that you have the proper path to it set in the .env file (`WKHTMLTOPDF_PATH` and `WKHTMLTOIMAGE_PATH` variables)(Visit [RefundPlugin](https://github.com/Sylius/RefundPlugin) for more information). #### 2. Require Mollie plugin with composer: #### 3. Update the GatewayConfig entity class with the following code: Ensure that the GatewayConfig resource is overridden in the Sylius configuration file: #### 4. Update the Order entity class with the following code: Ensure that the Order resource is overridden in the Sylius configuration file: #### 5. Update the Product entity class with the following code: Ensure that the Product resource is overridden in the Sylius configuration file: #### 6. Update the ProductVariant entity class with the following code: Ensure that the ProductVariant resource is overridden in the Sylius configuration file: ### 7. Update the AdminUser entity class with the following code: Ensure that the AdminUser resource is overridden in the Sylius configuration file: #### 8. Update your database After running all the above-mentioned commands, run migrate command #### 9. Copy Sylius templates overridden in plugin to your templates directory (e.g templates/bundles/): **Note:** Some directories may already exist in your project **Note:** Be aware that the following commands will override your existing templates! **Important:** Ensure the Mollie script is included at the top of your `templates/bundles/SyliusShopBundle/_scripts.html.twig` file: #### 10. Install assets: **Note:** If you are running it on production, add the `-e prod` flag to this command. #### 11. Add the payment link cronjob: #### 12. Download the [domain validation file](https://www.mollie.com/.well-known/apple-developer-merchantid-domain-association) and place it on your server at: `public/.well-known/apple-developer-merchantid-domain-association` ## Frontend Asset Management 1. Install assets: #### Installation & Build Process 1. Install dependencies: 1. Build assets: for development: for production: 1. Clear cache: 1. [Optional] Load fixtures: ## ⚠️ SyliusRefundPlugin Troubleshooting If you encounter an error related to duplicate transitions in the `sylius_refund_refund_payment` state machine (e.g. multiple `"complete"` transitions from `"new"` state), you should **remove the following file** from your project: You should remove it **if your project does not use Symfony Workflow** ## Sylius API In order to create Mollie payment with Sylius API, the following steps must be followed: - send the following request to the Sylius API in order to retrieve Mollie payment method configuration: /api/v2/shop/orders/{tokenValue}/payments/{paymentId}/configuration - tokenValue represents order token which is saved in the sylius_order DB table - response from this endpoint should be in the following format: - create the payment on Mollie, using Mollie API. Response from the above-mentioned step should be put in the request body. Request should be sent to the POST: https://api.mollie.com/v2/payments. Bearer token should be sent in the request authorization header. Token can be copied from the Mollie admin configuration page. - after payment has been created, API response will contain checkout field. User should enter this url in the browser. - open checkout url in the browser and complete the payment ## Usage During configuration, first save the keys to the database and then click "Load methods". ### Rendering Mollie credit card form You can use: - `SyliusMolliePlugin:DirectDebit:_form.html.twig` - `@SyliusMolliePlugin/Grid/Action/cancelSubscriptionMollie.html.twig` See [these examples](tests/Application/templates/bundles/SyliusShopBundle). ## Security issues If you think that you have found a security issue, please do not use the issue tracker and do not post it publicly. Instead, all security issues must be sent to `[email protected]` ## Community For online communication, we invite you to chat with us & other users on [Sylius Slack](https://sylius-devs.slack.com/).