Recurring payments

This section describes setting up & configuring recurring payments with this plugin.

1. Configuration

1.1. Required CRON Jobs

To process subscriptions, two cron commands must be configured:

# Mark processable subscriptions so that they won't be re-scheduled multiple times
* * * * * /usr/bin/php /path/to/bin/console mollie:subscription:begin-processing

# Process previously marked subscriptions
* * * * * /usr/bin/php /path/to/bin/console mollie:subscription:process

These jobs must run every minute to ensure subscriptions are processed on time.

1.2. Gateway Setup

Create a Mollie gateway with type Recurring (cron). The configuration is similar to the default Mollie gateway.

1.3. Configuring the product's variants

• Open the product variant you want to sell as a subscription.

• Adjust its Recurring Settings.

2. Managing Subscriptions

2.1. Access in Admin

Subscriptions can be managed via Admin → Mollie → Subscriptions.

Here you will find a grid with all subscriptions and their current state:

2.2. Subscription Details

Each subscription contains:

• Orders attached to the subscription (Note: The first order may be shared between multiple subscriptions, as it defines the contents.)

• Payments related to the subscription

• Expected payment schedule and fulfillment dates

• Order items included

Every active / processing subscription can be paused (and resumed) or canceled

3. Orders & Subscriptions

• Recurring and non-recurring products cannot be purchased in the same order.

• For every recurring item in an order, a separate subscription is created.

  • This ensures different intervals or durations are handled independently.

• At each scheduled interval, a new order is generated.

  • This enables individual refunds and partial subscription pause/cancel actions.

4. Customization

The plugin provides default labels to indicate that a product is a subscription:

If these don’t fit your theme, you can override them.

Use the hookable Twig block:

sylius_shop.product.show.content.info.summary

And customize the template for variant_recurring_settings.

5. Final Notes

• Subscriptions are automatically canceled if two consecutive payments fail (timeout or error).