Sylius: Set up order management

Select an API method

Select the appropriate API method for your payment processing goals: Mollie's Payments API for simple payments or its Orders API for detailed orders.

You can set a default API method, or one for each individual payment method.

📘

Note

  • Individual settings override the default setting.
  • You cannot select an API method either as a default or individually for these payment methods, which only use the Orders API:
    • Billie
    • Klarna
    • iDEAL in3
    • Vouchers

Select the default API method

  1. Log in to Sylius.
  2. Go to Configuration > Payment methods.
  3. Select Edit in the Actions column of the Mollie gateway.
  4. Select the payment method and API method.
  5. Save the changes.

Change the order expiry period

Customize the order expiry period as needed, for example, to allow customers more time to pay for their orders.

📘

Note

  • By default, customers have 28 days to pay for their orders.
  • Ensure that the Orders API is selected.

To change it, follow the following instructions:

  1. Log in to Sylius.
  2. Go to Configuration > Payment methods.
  3. Select Edit in the Actions column of the Mollie gateway.
  4. Select the payment method.
  5. Select the expiry period (1-100 days) from the Order expiration days drop-down menu.
  6. Save the changes.

Customize payment descriptions

Include order details such as order number and customer name in the payment descriptions that appear in your Mollie Dashboard.

All payments are listed on the Payments page of your Mollie Dashboard. A payment's description is displayed in its Details column. It can also appear on your customers' bank statements depending on the payment method used and the customer's bank.

By default, the payment description includes the Sylius, Sylius order ID,Mollie order status, API method used, and refund status.

📘

Note

You can only change the payment description for payment methods that use the Payments API.

You can combine free text and the following variables:

  • {ordernumber}
  • {storename}

To change the payment description, follow these steps:

  1. Log in to Sylius.
  2. Go to Configuration > Payment methods.
  3. Select Edit in the Actions column of the Mollie gateway.
  4. Select the payment method.
  5. In the description field, combine free text and variables to create a description.
  6. Save the changes.

📘

Example

To render 'The customer bought order #123456 at MegaProducts.com', combine the following text and variables:
The customer bought order #{ordernumber} at {storename}.

Customize emails

Customize the content and styling of emails that you send as payment requests or second-chance emails.

  1. Log in to Sylius.

  2. Go to the Mollie section of the side navigation bar.

  3. Select Email template.

  4. Select Create.

  5. Select the email template type from the Type drop-down menu:

    OptionDescription
    Payment linkThe email template is used when creating payment requests
    Payment link abandonedThe email template is used when creating second-chance emails
  6. Enter CSS commands into the Style CSS field to style the template.

📘

Note

Your CSS selectors target the HTML elements and class attributes that you specify in the Content field.

  1. For each relevant language, enter the following details:
FieldDescription
NameAn identifier for your own administration
SubjectThe subject of the email
ContentThe body of the email, formatted using HTML
  1. Select Create.

Set up second-chance emails

Recover potentially lost sales by automatically sending second-chance emails that include a payment link to re-engage customers who didn't complete a purchase.

  1. Log in to Sylius.
  2. Go to Configuration > Payment methods.
  3. Switch on the Enable second-chance functionality toggle.
  4. Optional: Change the email sending delay after cart abandonment by selecting a duration (1-200 hours) from the drop-down menu under the toggle.
  5. Select Save changes.