Skip to content

Plugin configuration

markusmichalski-fc edited this page Mar 13, 2024 · 10 revisions

Here you'll find a description about plugin configuration options.
You'll find these configurations in the "Settings"-Tab of the Mollie-Plugin.

Basic Configuration

Please configure these settings to make sure the communication from and to Mollie works correctly.

Configuration Option Description
Mode Live/Test If Test is chosen, all payments will show (Mollie Test Mode) in your shop and will be done with the Mollie sandbox/testing environment.
If Live ist chosen, the plugin is in production mode and real payments will be done.
LIVE API-Key - This is the API key that is used when in live mode. You need this is you are in production mode, and also if you want to test Apple Pay Direct. You can use separate keys for each subshop if you'd like.
TEST API-Key - This is the API key that is used when testing mode is enabled. You need this if you are in testing mode.
Test API Keys - With the button "Test API Keys" you can check if a communication with Mollie can be established based on the entered keys.
Log result of transaction handling Activate this option to log the results of the transaction handling.
The log file to be found here: {{SHOPROOT}}/log/MollieTransactions.log
Show icons Activate this option, if yo want to show payment icons in the checkout

Status Mapping

These settings are related to orders and help you to configure your payment flow and how you want to treat orders.

Here you can assign the desired OXID order folders to the "Pending", "Processing" and "Cancelled" statuses.

Status Description
Pending Set the order status before the customer is redirected to Payment Gateway
Processing Set the order status for Completed Payments
Cancelled Set the order status for cancelled orders

ApplePay

Here you have the option to select where the Apple Pay button should be displayed.

  • Shopping cart
  • Product detail page

In addition, Apple Pay is of course available on the payment selection page.

Please also note the information on the Apple Pay detail page.

Cronjobs

The Mollie module includes a cronjob script which is able to execute certain tasks of the Mollie module periodically.
For those periodic tasks to work you have to configure a cronjob on the webserver of your OXID eShop. The cronjob script can be found here:

{{PATH TO YOUR SHOP}}/source/modules/mollie/molliepayment/cron.php

In an Enterprise Edition scenario you can also add a shop-id as a parameter to the cron.php call to only execute the cronjobs for the given shop-id like this for shop-id 3:

php {{PATH TO YOUR SHOP}}/source/modules/mollie/molliepayment/cron.php 3

Currentyl available sub-jobs

The sub-jobs can be activated individually.
The Mollie module has the following sub-jobs currently:

Sub-job Description
Completion of paid but unfinished orders (FinishOrders) When a customer has paid successfully on the Mollie redirect page but he does not return to your shop, the order is not finalized correctly. This can happen for example when the customer loses his internet connection after payment or when the browser tab is closed before return to the shop. This Cronjob will finish these corrupted orders and complete all the unfinished tasks like sending the order confirmation email.
Cancel unpaid orders automatically (OrderExpiry) Orders with pending payments can be cancelled automatically after a certain time. You can configure this timespan in the configuration for each Mollie payment method in the OXID backend within the Mollie payment. You can select a timespan between 1 and 30 days or deactivate this for each payment method.
Dispatch of payment reminder email (SecondChanceEmail) This cronjob enables you to send a reminder email to your customer for finishing the order process, when the customer did not continue the checkout during the payment process by e.g., closing the browser or having a failed payment attempt. No emails will be sent for paid orders or orders where the customer canceled the payment explicitly. You can configure the day interval between order attempt and sending the reminder in the Mollie configuration. The email text can be customized by changing the CMS block "Mollie Second Chance Email".
Transmission of shipping status to Mollie (OrderShipment) When the shipping status in your Oxid shop is set via a external system like a ERP system and NOT via the "Send Now" button in the Oxid backend this Cronjob will the shipping status and tracking code to Mollie. The cronjob is not needed when you set the shipping status yourself with the "Send Now" button.
Capture of payments If you have Authenticate credit card before capture as Capture Method but don't want to capture the amounts manually, this cronjob captures orders which are fullfilled.

More sub-jobs will be added in the future.

Calling the cronjob script via URL

When calling the cronjob via URL you have to configure a secure key of your own choice in the Mollie cronjob configuration.
You have to add this secure key as the GET parameter "secureKey" to the URL call like this:
https://YOUR-SHOP-URL-HERE/modules/mollie/molliepayment/cron.php?secureKey=YOUR-SECURE-KEY
This prevents unauthorized execution of the cronjob script by others.

Alternative payment logos

Here you can upload your own logos for the individual payment methods. These will then be displayed in the checkout instead of the standard logos.