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 to activate the checkout

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.

Payment Button title

Adjust the text on the submit button, which defaults to “Place Order” in WooCommerce.

Checkout Type

Currently, only the full redirect option is available. A Hosted Payment Page option will be added in future releases.

Grouped cards

Enable this option to display all card payment methods as a single payment method in the Worldline payment module.

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.

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 Worldline 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.

Strong Customer Authentication

Enable 3DSv2 to enhance transaction security by adding an authentication layer, reducing fraud risk. This ensures customers are verified through their bank before transaction completion, providing a safer shopping experience and potentially lowering the merchant's fraud liability

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 Worldline.

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.