Documentation

Setup

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 Ingenico account. The Ingenico team will supply you with two logins, one for test and the other for live. You can get to both the test and live logins from here.

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.

Note

Before and after you start following our setup guide, please do make sure that you have done everything in this list:

You are using a test Ingenico account, and you will apply everything below on your test Ingenico account.
I have followed step#1  –  where I activated my plugin and license key.

I have followed step#2  –  where I have logged in to my test Ingenico back-office account.
I have followed step#3  –  where I created an API user

I have followed step#4  –  where I decided to either pick SHA-256 or SHA-512 as my SHA encryption method, which matches what I chose in my plugin settings.
I have followed step#5  –  where I added the SHA-IN passphrase key and matches what I placed on my plugin settings.

I have followed step#6  –  where I made sure to tick the required checkbox, placed my SHA-OUT passphrase key, matches what I placed on my plugin settings, and chose the Dynamic e-Commerce parameter options correctly.
I have followed step#7  – where I made sure that 3D secure is active on the cards that I wish to use on my website.

I have followed step#8 – where I made sure that I processed a sample transaction and it was processed successfully.

 

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:

Note
WooCommerce > Settings > Payments > Ingenico Direct Link Checkout

The key items here for the setup are in the red boxes.

These settings will need to be matched with what you enter in the Ingenico back office.

 

Step 2 – Login to the test Ingenico back office.

The next set of items is done in the Ingenico 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.

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

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

If you don’t have access to the test account, you/your client will need to reach out to the Ingenico team here: https://www.ingenico.com/support and ask for logins again. It’s also important to note that if the Ingenico account is new, you won’t be able to switch to live mode until you have done several test orders and applied to go live (You will see the option on the main Ingenico Home screen).

 

Step 3 – Create an API user.

This section will create the API user, which the plugin will use to make API payment calls to the Ingenico system. You will need to go to Configuration > Users.

Here we want to add a new user; clicking the new user button shows us the following:

The most important element here is the tick box in the red box. This will make this new user work with the API.

Note
Enter your desired UserID, User’s name, and email address.

You will need to enter your password, the one you signed in with. Once you do that, you will set this new API user’s password on another screen.

Note
It’s important that for the API user passwords, please use numbers and letters and no special characters used by the Ingenico system like £ since the Ingenico system will not allow this. The Ingenico system will not accept special characters that are used in code (e.g. £) to prevent someone from injecting bad code and compromising accounts. Alternatively, you could use a symbol like the exclamation mark !. An example password would be something like November5!. We recommend using another and more secure password as this is just an example that you could follow.

Step 4 – Global security parameters.

In this section, we pick and match the SHA encryption method we set in the plugin settings.

Note
We recommend using SHA-256 or SHA-512.

Step 5 – Data and origin verification.

The next item here is the SHA-IN; this must match what you have in the plugin settings. We recommend that you use letters and numbers only in this setting and that it has a maximum of 16 characters. You should follow the NCSC guidance on choosing and storing passwords. from the National Cyber Security Centre (NCSC). You cannot use ^, {, }, [, ], “, ‘, |, <, or >.

Note
You only need to place the ‘SHA-IN pass phrase’ field under the ‘Checks for DirectLink and Batch’ section.

Step 6 – Transaction feedback.

Again, in this section, we have only two items. The first one is to make sure that the tick box labeled “I would like to receive transaction feedback parameters on the redirection URLs.” is ticked.

Without this ticked, the Ingenico system won’t send data back to the website. This means you will get orders with pending payment and then fail. This is an important setting.

As a note, there should be nothing in the four fields above this tick box; the plugin will do all the hard work of setting these URLs on its own.

Next is to make sure to untick the box labeled “I would like Ingenico to display a short text to the customer on the secure payment page if a redirection to my website is detected immediately after the payment process.”

The next item here is the SHA-OUT; you will need to scroll down a little to see the option.

Again, this must match what you have set in the plugin settings; we recommend that you use letters, and numbers and it should also have a maximum of 16 characters. You should follow the NCSC guidance on choosing and storing passwords. from the National Cyber Security Centre (NCSC). You cannot use ^, {, }, [, ], “, ‘, |, <, or >.

The final item here is the parameters, which will be sent back to the website.

You  only want the following in the selected section:

AAVADDRESS

ACCEPTANCE

COMPLUS

NCERROR

ORDERID

PAYID

STATUS

 

Step 7 – 3D Secure.

This is very important if you sell products to EU customers. From 14 September 2019, all EU (Brexit does not affect this) credit card transactions could be rejected if your store does not have 3D secure setup.

With the enforcement of the Strong Customer Authentication (SCA) & Payment Services Directive (PSD), it is important to get the Ingenico back-office set up and ready; thankfully, this is quite simple. Navigate to

Note
Advanced > Fraud detection

And you will see something like the following:

 

The key here is to ensure that 3D secure is active on the card brands you wish to use on the website.

 

Step 8 – 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 Ingenico 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 issues are and what is needed to fix them.

If you are still having issues, then enable the plugin to debug and log in to 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:

Note
WooCommerce > Status > Logs

 

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

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 & Ingenico settings and the debug log.

 

Was this helpful?

Ingenico ePayments Ogone Direct Link

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

AG Bot (BETA) - Not live chat

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? (Not live chat)