Sign up

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 methodsfeaturesintegration 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!

    Download plugin

    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

    1. Install plugin
    2. Configure plugin
    3. Manage payments

    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

    Download the plugin

    Direct credentials

    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.

    Installation process

    1. Log in to your WordPress Admin panel.
    2. Navigate to Plugins > Add New.
    3. Search for the “Worldline Global Online Pay for WooCommerce” plugin.
    4. Click on Install Now and wait until the plugin is installed successfully.
    5. 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.

    1. Login to the WooCommerce Back office. Go to WooCommerce > Payments. Select “Worldline Global Online Pay for WooCommerce” and click on “Manage”.
    2. Configure the following fields.

    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.

    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:

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

    Capture mode

    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.

    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.

    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

    • 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

    (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

    • Click on “order actions” and select Capture Authorized PAYONE 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 PAYONE".

    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.


    Was this page helpful?

    Do you have any comments?

    Thank you for your response.