Ingenico E-COMMERCE

This article explains how to integrate Ingenico’s ePayment solution (E-COMMERCE) as an external payment provider in Payrexx to receive payments.

General Information

Ingenico E-COMMERCE is Ingenico’s standard interface for processing online payments. As a merchant, you can connect your webshop to the system to process payments securely.

Links

• Ingenico Website

Features

Payment types

The following features are available in the Payrexx merchant administration panel:

• ✅ One-time payment

• ✅ Refund

• ✅ Partial refund

• ❌ Recurring payments (Subscription)

• ❌ Tokenization

• ❌ Pre-authorization

Payment methods

• Visa

• Mastercard

• American Express

• Diners Club International

• Discover Card

• Masterpass

• Klarna

• and many more

Setup

Please follow the instructions below to integrate Ingenico E-COMMERCE as an external payment provider in Payrexx.

Configuration of Payrexx

Make sure you're logged in to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can register now.

• In the main menu of your Payrexx account, navigate to Payment Providers.

• Under "Credit Cards and Debit Cards", click on "Show":

Displaying the different external payment providers in Payrexx

• Click the green Setup button next to Ingenico ePayments (E-Commerce):

Setting up Ingenico ePayments (E-Commerce) in Payrexx

• Request a contract offer from Ingenico by clicking the green button:

Requesting a contract offer from Ingenico

• Fill out the form and submit it.

• Please make sure that the option "TPD | Dynamic Template" is activated by Ingenico.

• You will receive an email from Ingenico with your login credentials.

• In your Payrexx account, go to Payment Providers, click "Show" under "Credit Cards and Debit Cards", and then click "Configure" next to Ingenico ePayments (E-Commerce).

• Enable Test Mode (1) and select the appropriate package (2):

Activating test mode and selecting a package

• Enter the credentials you received from Ingenico into the corresponding fields and complete the configuration as follows:

Configuring Ingenico in test mode

1. Select the payment methods you want to offer.

2. Enable the currencies you wish to support.

3. Fill in the fields under "test mode" with the data you received from Ingenico.

Configuration of Ingenico ePayment

• Log in to your Ingenico account to begin the setup:

  • Log in to a test account

  • Log in to a live account

1. Navigate to Data and origin verification.

2. Make sure the field "URL of the merchant page (...)" is left empty.

3. Enter the corresponding value from your Payrexx account into the "SHA-IN Signature" field:

Configuring data and origin verification in Ingenico

Click "Save" to complete the process.

Global transaction parameters

• Navigate to Global transaction parameters.

• Make sure your settings match those shown in the image below:

Configuring global transaction parameters in Ingenico

Global security parameters

1. Navigate to Global security parameters.

2. Make sure the selected hash algorithm matches the one configured in the Payment Provider Settings in your Payrexx account.

3. Additionally, enable the first option under "Character encoding":

Configuring global security parameters in Ingenico

Payment page

• Navigate to Payment page.

• Make sure the checkbox below "Cancel button" is unchecked, and the field below "Back button redirection" is left empty:

Configuring the payment page in Ingenico

Transaction feedback

1. Navigate to Transaction feedback.

2. Make sure all input fields are left empty.

3. Enable both checkboxes.

Configuring transaction feedback in Ingenico

1. In the Direct HTTP server-to-server request section, enable the option "Always online (...)".

2. Copy the following URL into the field "If the payment's status is accepted (...)": https://dispatcher.payrexx.com/ogone/callback.php?result=-1

3. Copy the following URL into the field "If the payment's status is cancelled (...)": https://dispatcher.payrexx.com/ogone/callback.php?result=-2

4. Under "Request method", select POST:

Configuring the HTTP server-to-server request in Ingenico

• Enable COMPLUS, PAYID, ORDERID, STATUS, and Dynamic E-Commerce Parameters.

Enabling dynamic e-commerce parameters in Ingenico

1. Enter the value for "SHA-OUT pass phrase" into the corresponding field. You can find this value in your Payrexx account under Settings > Payment Providers > PostFinance, in the field labeled "SHA-OUT Signature".

2. For the setting "HTTP request for status changes", select the option "No request" and save your changes:

Ingenico configuration

Transaction emails

• Navigate to Transaction emails.

• Enter your email address under "Email address(es) for transaction-related emails" and click "Save".

• Activate the payment option "Ogone by Ingenico" in your Payrexx account.

• Test the payment process in the Payrexx frontend — for example, by using the Terminal.

Requesting live mode activation

• Contact Ingenico ePayments to request activation of your account in live mode. To do so, send an email to [email protected] and include your PSPID.

• Once you receive confirmation from Ingenico, log in to your Payrexx account and navigate to Payment Providers.

• Click "Configure" next to "Ingenico ePayments (E-Commerce)".

• Verify the login credentials in the corresponding fields.

• Enable Live Mode.

Ingenico ePayments (E-Commerce) is ready to use.

Configuring Masterpass

To configure the full checkout with Masterpass, you need the DirectLink product from Ingenico. For more information, please refer to the corresponding setup guide.