OXID 7: Get started
Available payment methods
Mollie for OXID 7 Plugin offers a wide range of payment methods that your customers can use to pay during checkout.
Apple Pay, BANCOMAT Pay, Bancontact, Belfius Pay Button, Billie, Blik, Credit/Debit cards, EPS, Gift cards, iDEAL, iDEAL in3, KBC Payment Button, Klarna, MyBank, PayPal, paysafecard, Przelewy24, Riverty, SEPA Bank Transfer, Trustly, TWINT.
For information on how to select the best payment methods for your business, refer to the Mollie Payment methods guide.
Features
OXID 7 Plugin offers the following features to effectively manage your online payments:
- Customize the payment experience
- Localize your payment methods
- Offer and manage subscriptions
- Manage orders and payments
Install and connect
Enhance your OXID 7 shop payment options with Mollie.
What you need to do in advance:
- Create and successfully log in to your Mollie account.
Install Plugin
- Connect to your web server via SSH and navigate to the base folder of your OXID eShop where the
composer.jsonis located. - Install the plugin using the following command:
composer require mollie/mollie-oxid7 - Activate the module in your OXID Shop's Backend.
Plugin configuration
The Plugin will create OXID payment methods that can be used like any other payment methods in your shop.
You can configure the following options in the Extensions > Modules > Settings tab of the Mollie plugin:
- Basic Configuration - configure these settings to make sure the communication between Mollie and your OXID shop works properly.
| Configuration | Description |
|---|---|
| Mode | Test - all payments are made using sandbox/testing environment. Live - plugin is in production mode and actual payments are made. |
| LIVE API-Key | API key for the Live mode. Use this key in production or if you want to test Apple Pay Direct. You can use separate keys for each subshop. |
| TEST API-Key | API key for the Test mode. Use this key to test your payments in the sandbox. |
| Test API Keys | Check if the communication with Mollie can be properly established based on the entered keys. |
| Log result of transaction handling | Log the results of the transactions. You can access the log file here: {{SHOPROOT}}/log/Mollie-Transactions.log. |
| Remove deactivated payment types | Remove payment methods that are not activated on Mollie's side from the payment selection (that would otherwise result in an error). |
| Show icons | Show payment icons at the checkout. |
- Status Mapping - configure your payment flow and how you want to treat your New, Finished or Problems orders by assigning them to "Pending", "Processing" or "Cancelled".
| Status | Description |
|---|---|
| Pending | Set the order status for payments before the customer is redirected to payment gateway. |
| Processing | Set the order status for completed payments. |
| Cancelled | Set the order status for cancelled orders. |
- Apple Pay - configure whether you want to show the Apple Pay button on the basket and/or product details page.
| Option |
|---|
| Shopping cart |
| Product detail page |
See our Apple Pay GitHub page for more information.
- Cronjobs - configure a cronjob on the webserver of your shop to schedule periodic execution of certain tasks.
Find the cronjob script here:
{{PATH TO YOUR SHOP}}/source/modules/mollie/molliepayment/cron.php
In the Enterprise Edition you can add shop-id as a param to the cron.php call. This will execute cronjobs only for the given shop (this script runs the job only for the shop with the ID 3):
php {{PATH TO YOUR SHOP}}/source/modules/mollie/molliepayment/cron.php 3
Available sub-jobs
The list of the available sub-jobs that can be activated individually is the following:
| Sub-job | Description |
|---|---|
| FinishOrders (Completion of paid but unfinished orders) | This cronjob finishes corrupted orders and completes all the unfinished tasks (e.g sending the order confirmation email). E.g a customer loses their internet connection after payment or a browser tab is closed before their redirection to the shop, so the order is not finalized properly. |
| OrderExpiry (Cancel unpaid orders automatically) | This cronjob cancels Orders with pending payments automatically after a certain time. You can configure a timespan between 1 and 30 days or deactivate this for each payment method. |
| SecondChanceEmail (Dispatch of payment re- minder email) | This cronjob sends a reminder email to your customer to finish the order. You can configure the day interval between the order attempt and sending the email. You can customize the email text in the CMS block Mollie Second Chance Email. E.g a customer did not finish the checkout process or their payment failed. Emails are not sent out for paid or cancelled orders. |
| OrderShipment (Transmission of shipping status to Mollie) | This cronjob passes shipping status and tracking code to Mollie. E.g the shipping status in your shop is set via an external system (like an ERP) and not via the "Send Now" button in the OXID backend. |
- Alternative payment logos - configure your own logos for the individual payment methods. These will be displayed in the checkout instead of the standard logos.
Authentication
Mollie gives you two API keys to authenticate OXID 7 requests:
- Test key: Use this key when setting up and testing Mollie.
- Live key: Use this key after Mollie has approved your account and you are ready to accept live payments.
To connect with Mollie, follow these steps:
- Log in to your Mollie Dashboard.
- Select the organization from the menu in the top-left corner of the dashboard's home page.
Important
To comply with UK regulations, UK-based merchants have to select a UK-registered organization to ensure that they use the correct API keys.
- Go to Browse > Developers > Your API keys.
- Copy the API keys.
- Log in to OXID 7.
- Go to Extensions > Modules.
- Select Mollie Payment.
- Open Settings > Basic Configuration and paste the API keys into their respective fields.
- Select Test or Live mode depending on the mode you want to use.
We recommend enabling test mode until you are sure that everything works as you expect. - Click Test API keys to verify that your API keys work.
NOTE: The Test API Keys button is only available if the keys are saved. If no key is stored in the
configuration, the button won't show up. - Save the changes.
Updated 2 days ago
