Welcome to the setup guide.

Getting this plugin setup will only take around 30 mins; this guide will be broken down into steps. You must first do a test transaction using the test WorldLine account.

It is always best practice when setting up a payment gateway to do this in test mode first and run several orders before switching to live mode. You can check out our guide from this link regarding how you can proceed in creating a test account for WorldLine.

Getting Ready

Before diving in, make sure you have:

  • An active Worldline merchant account. Don’t have one yet? Get in touch with Worldline to set it up.
  • Access to the backend of your WooCommerce website.

Step 1 – Plugin settings.

Install the plugin & activate the license key; once this is done, you want to navigate to the plugin settings page; which can be found in the WooCommerce settings:

WooCommerce > Settings > Payments > AG Worldline Hosted Checkout for WooCommerce

The key items here for the setup are PSPID/ Merchant ID, API Key, and API Secret.

You will also need to set the Test Payment URL, and the Live Payment URL from here. Here are the general URLs:

Test Payment URL –
Live Payment URL –

Different countries like Australia or New Zealand would need to use different URLs:
ANZ Worldline
Test Payment URL –
Live Payment URL –
Account login URL –
Different countries like Germany or Austria would need to use different URLs:
Test Payment URL –
Live Payment URL –
Account login URL –


These settings will need to be matched with what you generated from the WorldLine back office.

Step 2 – Signing up, and Logging in to the test WorldLine back office.

As of June 6, 2023, merchants/you can now proceed in directly signing up for a WorldLine test account here.

Once you have your test account, the next set of items is done in the WorldLine back office; you can log in to the test account here. Once logged in, you need to navigate to the technical settings area. It is important to note that whatever changes to make in the test account, you must match in the live account.

From this area, we have access to all the sections we need to change/edit.

As mentioned in the welcome section above, it’s important to make sure you use the plugin in test mode and use the WorldLine test account; linking the plugin in test mode to the live WorldLine account will not work.

How to know if you are using the WorldLine test account? When you have logged in, look at the WorldLine logo. To the right of it, you will see TEST in red like this:

Once you want to go live, create a production account or contact the WorldLine support team about it, here.

Step 3 – Global transaction parameters.

In this section, you need to decide which operation mode you want to run the payment gateway.

Based on these two steps, you can choose between two default operation codes:

  1. Authorization: our system will only ask for authorization to have the authorization and data capture (payment request) steps performed separately at different times (the money remains in the customer’s account until a data capture (payment request) has been performed).
  2. Sale: our system automatically requests the payment (transfer of the amount) immediately after a successful authorization. This procedure is often used for goods/services delivered online.
If you are unsure what to enable, ask your client what they have been using, most users enable the sale method, but it is down to how the business operates.

Step 4 – Generating API Key and Secret

You will have to generate your API key and secret from the WorldLine back office. Particularly, in Configuration > Technical Information > Ingenico Direct Settings. These will be used in the plugin’s settings.

Once the API key and secret are generated, copy the information and proceed to your WooCommerce > Settings > Payments > Hosted Checkout for WooCommerce to paste them, save your settings and proceed to the next step.

Step 5 – Test, Test & test.

Well done, you have now finished the setup of the plugin! Now, the important thing to do is test the payment gateway a few times before going live.

If you have any errors/issues, you first want to check the WorldLine error log section.

In the description field, you will most likely find an error code, something like unknown order/1/r. If you do, you can have a look here at the troubleshooting error codes. There you will find out what the issue is and what is needed to fix it.

If you are still having issues, then enable the plugin debug log in the settings.

Run some test transactions, and if the plugin finds something wrong with the plugin setup, it will log this and tell you how to fix this; you can find the log by going here:

WooCommerce > Status > Logs

Here we can see the log saying that the transaction is confirmed, and no issues found.

We also added a button that could let you test the API details with one click. This button is located in WooCommerce > Settings > Payments > AG Worldline Hosted Checkout for WooCommerce and is labeled as “Test Connection”.

We still recommend proceeding with the test payments but this button should be very useful for a quick test as well.

The plugin’s debug log is coded to log most errors and give you a tip on how to fix the issue. It’s important to check these logs if you are having issues.

If you still face issues, then send a support ticket, and we will have a look for you.

Please be ready to send screenshots of the plugin & WorldLine settings and the debug log.

Was this helpful?

Worldline Hosted Checkout

Don't already have the plugin? Get access now.

Still need help?

Our team are on hand to provide fast, helpful and professional support.

Support request

Back End Demo

Start exploring our fully functional demo site today.
Gain exclusive admin access to see what's possible.

Create your demo now

Front End Demo

Test drive our plugin on the demo site.

View Demo


Ask our bot about our products.

Welcome to our AG Bot, powered by OpenAI and trained on our documents and product pages. By continuing to use this service, please keep in mind:

Your continued use indicates acceptance of these terms. We hope you find our AI Chatbot useful!

Hello! I am AG Bot, how can I help you?