WooCommerce
Introduction
Our WooCommerce plug-in comes with regular updates and full integration support, guaranteeing a versatile out-of-the-box solution to accept online payments easily:
- Ideal solution for businesses of any size using Wordpress.
- Supports Hosted Checkout Page and Hosted Tokenization Page integration modes.
- Supports individual payment buttons on the WooCommerce checkout page for popular payment methods
- Offers the following payment methods on our platform:
Alipay+
American Express
Apple Pay
Bancontact
Bank Transfer
Bizum
Carte Bancaire
Diners Club
FloaPay
Google Pay
iDEAL
Illicado
Intersolve
JCB
Klarna
Multibanco
Oney 3x-4x
PayPal
PostFinancePay
Maestro
MasterCard
Twint
Visa
WeChatPay
Keep an eye on our Release Notes to stay informed about updates and new features (i.e. payment methods, features, integration modes) we have added to this plugin!
Check out our documentation to learn how to link your store with our platform to profit from all these features!
To process transactions with this plugin, you need an account on our platform.
This plugin works with both our test and live environment. A test account is a great way to get familiar with both the plugin and our platform. Once you want to go live, create a production account or contact us!
Installation
Install plugin
The first step to use the plugin is the installation process. Before you proceed, make sure your infrastructure meets these system requirements:
Item |
Description |
Plugin package |
|
Direct credentials |
|
Dependencies |
|
PCI compliancy |
SAQ A (14) |
Installation process
- Log in to your WordPress Admin panel.
- Navigate to Plugins > Add New.
- Search for the “Worldline Global Online Pay for WooCommerce” plugin.
- Click on Install Now and wait until the plugin is installed successfully.
- Activate the plugin immediately by clicking Activate on the success page. Alternatively, activate it later via Plugins > Installed Plugins.
Configure plugin
After the installation, you need to configure the plugin to link your store to our platform.
- Login to the WooCommerce Back office. Go to WooCommerce > Payments. Select “Worldline Global Online Pay for WooCommerce” and click on “Manage”.
- Configure the following fields.
Property |
Description/Actions |
Enable/Disable the full redirection mode (and thereby all payment methods offered via the Hosted Checkout Page). Disable this option if you want to offer card and third party redirection payment methods directly on the WooCommerce checkout page. |
|
PSP ID |
Enter the PSPID on our platform you want to use for transaction processing. |
Live Mode |
Set the flag to link your shop to our platform for test/live transaction processing. |
API Key |
Enter the API Key of your test or live PSPID. Read our dedicated guide to learn how to generate one |
API Secret |
Enter the API secret of your test or live PSPID. Read our dedicated guide to learn how to generate one |
API Endpoint |
It would be prefilled depending upon the mode selected. |
Webhook ID |
Enter the Webhook Key of your test or live PSPID. Read our dedicated guide to learn how to generate one |
Webhook Secret |
Enter the Webhook secret of your test or live PSPID. Read our dedicated guide to learn how to generate one |
Webhook Endpoint |
Copy the "Endpoint URL" from the plugin settings and paste it into the appropriate field in the back office under Developer > Payment API. You can add up to 5 URLs in this section. |
Advanced Logging |
When advanced logging is activated, additional details such as purchase amount, customer address, incoming webhook data, and HTTP requests/responses from the API are recorded. |
Primary Gateway title |
Your commercial name as it appears on the Hosted Checkout Page. |
Payment Button title |
Adjust the text on the submit button, which defaults to “Place Order” in WooCommerce. |
Checkout Type |
(De)activate specific payment methods to appear on the Hosted Checkout Page. Applies only if the full redirection mode is disabled. Other checkout modes are managed separately. |
Grouped cards |
Enable this option to display all card payment methods as a single payment method on the Hosted Checkout Page. |
Show Tokenized cards |
Enable this option to display stored/tokenized payment methods on the checkout page, above the active payment methods. Customers can manage these payment methods under My Account > Payment Methods, where they can also set a default payment method or delete existing ones. |
Hosted Checkout Page template |
Enter the file name of your template to adapt our payment page to the look and feel of your shop. To learn how to create templates, see our dedicated chapters in the Hosted Checkout Page guide. |
Hosted Tokenization Page template |
Enter the file name of your template to adapt our payment page to the look and feel of your shop. To learn how to create templates, see our dedicated chapters in the Hosted Tokenization Page guide. |
Surcharge |
The surcharge feature allows adding an extra fee to transactions using a PAYONE payment method. This feature is available in specific countries and must be activated in your account |
Authorization Mode |
Define whether to process the transactions as authorisation mode or as direct sale. Select one of the following options:
If "Authorization Mode" is set to "Authorization", make sure you capture authorised transaction later. Only then will the transaction reach statusCode=9, for which you receive the actual payment for the transaction. |
Authorization Mode for Credit Cards
|
Define whether to process credit card transactions as authorisation mode or as direct sale. Select one of the following options:
If "Authorization Mode for Credit Cards" is set to "Authorization", make sure you capture authorised transaction later. Only then will the transaction reach statusCode=9, for which you receive the actual payment for the transaction. |
Capture mode |
Choose to capture transactions in statusCode=5 either manually or automatically. This cron job is already configured within the plugin, requiring no extra setup. |
3-d Secure Authenticaton |
Enable 3-D Secure to enhance transaction security by adding an authentication layer, reducing fraud risk. If your business is located in Europe, you have this feature activated by default. |
Enforce 3DS Challenge |
Define whether to enforce Strong Customer Authentication (SCA). We strongly recommend setting it to YES to avoid a high rate of declined transactions. This will also ensure liability shift for transactions with successful 3-D Secure authentication. |
Exempt transactions from 3DS |
Some markets may allow exemption from 3-D Secure checks. Selecting this option potentially exempts your customers. Two exemption types are available:
|
Exemption Limit |
Select the exemption limit based on transaction type.
Mind that exemptions may not function correctly with currencies other than EUR |
Send Shopping Cart |
Enabling basket data ensures it is sent to the API, which is necessary for certain payment methods. We recommend always enabling this feature. |
Clear data on Uninstall |
Select if you want to uninstall the plugin. You can also choose to reset the data for reinstallation attempts. |
In addition to the standard Hosted Checkout Page mode as described above, the plugin offers onsite payments with
Apple Pay
Bank Transfer
Credit cards
Google Pay
iDEAL
Klarna
PostFinance Pay
Twint
Make sure these payment methods are active in your account before activating them in the store.
(De)Activate or manage these payment methods in the WooCommerce back office via WooCommerce > Payments. Click on "Enable" or "Manage" for the respective payment methods accordingly.
The following options are available:
Payment method |
Description/Actions |
Credit cards |
|
Apple Pay |
(De)Activate |
Test connection
Once you have filled in the data from the table, a built-in connection validation between the plugin and our platform will take place.
If the API Key/Secret throws an error, the plugin will not save the data. Contact your system administrator for troubleshooting and verify:
- You are using the correct credentials.
- Whether your PSPID is active.
- You are sending the request to the correct PSPID/environment (Test vs Production).
If the API Key/Secret are correct, the plugin will save the data.
Manage payments
We have designed the plugin to follow-up on your orders automatically and autonomously, freeing you from the administration involved. Learn here how to use our plugin effectively to make your business thrive!
Perform maintenance operations
Captures, refunds and cancellations of authorisations are standard processes (also known as maintenance operations) in your everyday business logic. Learn here how to perform these operations in the WooCommerce back office:
- Go to WooCommerce > Orders. Click on the order.
- You can perform Capture/Refunds through the options provided.
Maintenance operations |
Description/Actions |
Capture |
The order will be captured and the Order notes section will display the response from our platform. |
Refunds |
Cancel authorised transactions or refund:
|
Perform test transactions
Use our platform's test environment to make sure your plugin works as intended. We offer test data sets on our dedicated Test cases page. Target our test environment as described in the "Configure Plugin" section.