# Ingenico ALIAS GATEWAY

## General Information <a href="#features" id="features"></a>

Ingenico ALIAS GATEWAY is an extension of [Ingenico E-COMMERCE](https://docs.payrexx.com/merchant/english/payment-provider/external-payment-provider/creditcards/ingenico/ingenico-e-commerce), designed for the secure storage of payment data.

Instead of processing sensitive card information directly, an "alias" is created, which merchants can use for recurring payments or one-click checkouts.

### Links

* Ingenico [Website](https://ingenico.com/)

## Features <a href="#features" id="features"></a>

### 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

* <img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252FchmLS894v8pkN7Nehls5%252Fimage.png%3Falt%3Dmedia%26token%3Da96e6129-3b30-4835-893d-b7d70def3013&#x26;width=60&#x26;dpr=4&#x26;quality=100&#x26;sign=604bb5a7&#x26;sv=2" alt="" data-size="line"> Visa
* <img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252FATPrScnHIbkx2yvUcqyQ%252Fimage.png%3Falt%3Dmedia%26token%3D0c7ab097-3736-4a03-a4fb-832e8d19bb6c&#x26;width=60&#x26;dpr=4&#x26;quality=100&#x26;sign=d286a2ae&#x26;sv=2" alt="" data-size="line"> Mastercard
* <img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252FOtvcA9S6y7Koi5cWC2E6%252Fimage.png%3Falt%3Dmedia%26token%3Da81b2338-c2c9-403f-acd0-76679ac94a3b&#x26;width=60&#x26;dpr=4&#x26;quality=100&#x26;sign=a504ae90&#x26;sv=2" alt="" data-size="line"> American Express
* <img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252FOQDbOLnSJqpBiQbs9B2Q%252Fimage.png%3Falt%3Dmedia%26token%3Db02b0d3a-18a4-4723-ac5c-4ddca01edf81&#x26;width=53&#x26;dpr=4&#x26;quality=100&#x26;sign=2219fca6&#x26;sv=2" alt="" data-size="line"> Diners Club International
* <img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252Fabg6kdxmdazOeDRyb33F%252Fimage.png%3Falt%3Dmedia%26token%3D976d916a-87aa-49be-8c94-5e44821b348e&#x26;width=60&#x26;dpr=4&#x26;quality=100&#x26;sign=701b65ce&#x26;sv=2" alt="" data-size="line"> Discover Card
* <img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252FBjvmzHr8lEkHUBvz0YDR%252Fcard_masterpass.svg%3Falt%3Dmedia%26token%3D9600706f-f1ce-4ce3-bf15-88b9ab14569e&#x26;width=60&#x26;dpr=4&#x26;quality=100&#x26;sign=c5706d28&#x26;sv=2" alt="" data-size="line"> Masterpass
* <img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252FS8FIgaTgQ0Q0Zwzta4ny%252Fcard_klarna_paylater.svg%3Falt%3Dmedia%26token%3D822e02a0-34f0-4a48-b086-67e5165960d1&#x26;width=60&#x26;dpr=4&#x26;quality=100&#x26;sign=ffccc58f&#x26;sv=2" alt="" data-size="line"><img src="https://docs.payrexx.com/~gitbook/image?url=https%3A%2F%2F3244062149-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYJhU4qriZCz_Wxs0T0-543259558%252Fuploads%252FhwFChllXfqdTZ64sg6sz%252Fimage.png%3Falt%3Dmedia%26token%3D07f340b8-4d88-46b1-8e25-592715b04489&#x26;width=60&#x26;dpr=4&#x26;quality=100&#x26;sign=a0034b6a&#x26;sv=2" alt="" data-size="line"> Klarna
* and many more

## Setup <a href="#setup" id="setup"></a>

Please follow the instructions below to integrate Ingenico ALIAS GATEWAY as an external payment provider in Payrexx.

### Configuration of Payrexx <a href="#configuration-payment-provider" id="configuration-payment-provider"></a>

{% hint style="info" %}
Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now.
{% endhint %}

* In the main menu of your Payrexx account, navigate to **Payment Providers**.
* Under "Credit Cards and Debit Cards", click on "Show":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FvWWQFXAHQKMo9Bmlwflf%2Fimage.png?alt=media&#x26;token=9838d33d-edd7-4bb9-9afc-e9dadc113961" alt=""><figcaption><p>Displaying the different external payment providers in Payrexx</p></figcaption></figure></div>

* Click the green Setup button next to Ingenico ePayments (Alias Gateway):

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FErPtBV63sa7tBZrG5WYI%2Fimage.png?alt=media&#x26;token=544064eb-305b-4582-9f63-506722336b06" alt=""><figcaption><p>Setting up Ingenico ePayments (Alias Gateway) in Payrexx</p></figcaption></figure></div>

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

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FvZLdNwUGbJHH3gTzZsnB%2Fimage.png?alt=media&#x26;token=fcd1c8fa-65dd-41f7-9411-53c5bdfa7376" alt=""><figcaption><p>Requesting a contract offer from Ingenico</p></figcaption></figure></div>

* Fill out the form and submit it.

### Configuration of Ingenico

After receiving an email from Ingenico, log in to your Ingenico account and activate the following options:

#### Minimum Requirements

* OPC | One Page Checkout (Alias Gateway)
* DPR | DirectLink (new payments)
* USR1 | User Manager for up to 2 users

#### Optional

* D3D | DirectLink 3D Secure
* DMT | DirectLink (management)
* DQY | DirectLink (inquiry)
* RECX | Alias Manager

### Configuration of Payrexx

* Log in to your Payrexx account and enter the credentials you received from Ingenico via email.
* Make sure that test mode is enabled.

### Configuration of Ingenico

1. Log in to the Ogone back office of Ingenico.
2. Activate the payment method "Ogone Alias Gateway".
3. Test the payment process on the frontend.
4. Request activation for live mode from Ingenico by sending an email to Ogone, including your PSPID.
5. Once you receive confirmation that live mode has been enabled, you can switch from test to production mode.

{% hint style="success" %}
Your integration is now ready for operation.
{% endhint %}

### Configuration of the Ogone account

#### Basic configuration

Begin by setting up the basic configuration of your Ingenico (Ogone) account.

#### Adding required options

To use the Payrexx Alias Gateway, you must purchase the options "One Page Checkout (OPC)" and "User Manager for up to 2 users (USR1)". Once activated, you can add an API user under **Configuration > User Managemen**t by checking the box "Special user for API" when creating the user. The credentials of this user must then be entered accordingly in Payrexx.

#### Setting up DirectLink

In the Ingenico back office, go to **Configuration > Technical Information > Data and origin verification**:

1. In the section "Checks for DirectLink and Batch", leave the "IP address" field empty.
2. In the "SHA-IN Signature" field, enter the signature defined in your Payrexx backend. You can find this under **Settings > Payment Providers > Ingenico ePayments (Alias Gateway)**.

### Configuration of Masterpass

* Log in to the Ingenico website using your credentials.
* Navigate to **Configuration > Technical Information > Transaction Feedback**.
* Under "DirectLink", move the "REDIRECTIONURL" and all "ECOM\_" parameters to the right side of the screen.

{% hint style="info" %}
To configure the Masterpass Full Checkout, you will need your DirectLink product from Ingenico.
{% endhint %}