WooCommerce

Item

Description

Plugin package

Download the plugin

Direct credentials

• Active test/live account on our platform
• API key/secret
• Webhooks

Dependencies

• WordPress 6.3 or newer
• WooCommerce 8.7 or newer
• PHP Version 7.4 or newer

PCI compliancy

SAQ A (14)
The plugin’s in-built features ensure this security level, but you still need to get the certificate from your acquirer.

Property

Description/Actions

Enable/Disable

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.
Enable advanced logs when troubleshooting issues and share these logs with the support team for effective resolution. Logs are automatically deleted after 30 days.

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.

Generic logo displayed on your payment page

Update the default logo that is displayed next to the payment button on your checkout page.

Surcharge

The surcharge feature allows adding an extra fee to transactions using a Worldline 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:

• Authorization: The amount is only blocked on your customer's card. Successful transactions will have statusCode=5/status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT"
  Use this mode when you wish to capture a transaction only after shipping the order). In the WooCommerece Back Office, the status will be "On Hold".
• Sale: The amount has been ordered to be paid out in one go. Successful transactions will have status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9
  In the WooCommerece Back Office, the status will be "Processing".

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.
There are two sub-options for Authorization:
a.      Final Authorization – Blocks customer funds for 7 days and must be captured in full.
b.      Pre-authorization – Blocks customer funds for 30 days an the captured amount can be lower or equal to the authorized amount. Not all acquirers and sectors support pre-authorizations.

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:

• Authorization: The amount is only blocked on your customer's card. Successful transactions will have statusCode=5/status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT"
  Use this mode when you wish to capture a transaction only after shipping the order). In the WooCommerece Back Office, the status will be "On Hold".
• Sale: The amount has been ordered to be paid out in one go. Successful transactions will have status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9
  In the WooCommerece Back Office, the status will be "Processing".

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.

Choose to capture transactions in statusCode=5 either manually or automatically.
If you select automatic capture, specify the number of days, after which a cron job will process the transaction.

This cron job is already configured within the plugin, requiring no extra setup.

Orders in a "pending" status are automatically cancelled after the time you configure. This process uses standard Woo crons, so it depends on your website traffic.

You can configure this setting for up to 3 days in the future. However, we recommend setting it to 3 hours to align with the default timeout of our payment page.

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.
If your business is located outside of Europe, you should adjust the option according to your local laws.

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:

• Low value: Applicable for transactions below 30 EUR. This bypasses Strong Customer Authentication (SCA) to streamline checkout for low-value transactions. 
• Transaction Risk Analysis: Enables dynamic risk assessment by card issuers and acquirers. Transactions up to 100 EUR can qualify for exemption if deemed low risk.

Exemption Limit

Select the exemption limit based on transaction type.

• For Low Value, set the limit between 0 and 30 EUR.
• For Transaction Risk Analysis, choose between 0 and 100 EUR.

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.

Payment method

Description/Actions

Credit cards

• Change the payment title displayed on the checkout page.
• Select supported card brands from the list available in the Card Icons field.

Apple Pay
Bank Transfer
Google Pay
iDEAL
Klarna
PostFinance Pay
Twint
Mealvouchers
Chèque-Vacances Connect
EPS
PayPal

Maintenance operations

Description/Actions

Capture

• Click on “order actions” and select Capture Authorized Worldline payment
• Click “Update”.

The order will be captured and the Order notes section will display the response from our platform.

Refunds

Cancel authorised transactions or refund:

• Click on refund
• Update the quantity to refund and the amount will be reflected accordingly in the Refund Amount tab.
• Click on "Refund via Worldline".