# Ingenico ALIAS GATEWAY

## Allgemein

Ingenico ALIAS GATEWAY ist eine Erweiterung von [Ingenico E-COMMERCE](https://docs.payrexx.com/merchant/bezahldienste/externe-zahlungsanbieter/kreditkarten/ingenico/ingenico-epayments-e-commerce-integration-in-payrexx), die für die sichere Speicherung von Zahlungsdaten entwickelt wurde.

Anstatt sensible Karteninformationen direkt zu verarbeiten, wird ein sogenanntes "Alias" erstellt, das der Händler für wiederkehrende Zahlungen oder One-Click-Checkouts nutzen kann.

### Links

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

## Funktionen

### Zahlungsmöglichkeiten

Die folgenden Funktionen stehen in der Händler-Administration von Payrexx zur Verfügung:

* ✅ Einmalige Zahlung
* ✅ Rückerstattung
* ✅ Teil-Rückerstattung
* ✅ Wiederkehrende Zahlungen (Abonnement)
* ❌ Tokenisierung
* ❌ Vorautorisierung

### Zahlungsmethoden

* <img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FchmLS894v8pkN7Nehls5%2Fimage.png?alt=media&#x26;token=a96e6129-3b30-4835-893d-b7d70def3013" alt="" data-size="line"> Visa
* <img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FATPrScnHIbkx2yvUcqyQ%2Fimage.png?alt=media&#x26;token=0c7ab097-3736-4a03-a4fb-832e8d19bb6c" alt="" data-size="line"> Mastercard
* <img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FOtvcA9S6y7Koi5cWC2E6%2Fimage.png?alt=media&#x26;token=a81b2338-c2c9-403f-acd0-76679ac94a3b" alt="" data-size="line"> American Express
* <img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FOQDbOLnSJqpBiQbs9B2Q%2Fimage.png?alt=media&#x26;token=b02b0d3a-18a4-4723-ac5c-4ddca01edf81" alt="" data-size="line"> Diners Club International
* <img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2Fabg6kdxmdazOeDRyb33F%2Fimage.png?alt=media&#x26;token=976d916a-87aa-49be-8c94-5e44821b348e" alt="" data-size="line"> Discover Card
* <img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FBjvmzHr8lEkHUBvz0YDR%2Fcard_masterpass.svg?alt=media&#x26;token=9600706f-f1ce-4ce3-bf15-88b9ab14569e" alt="" data-size="line"> Masterpass
* <img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FS8FIgaTgQ0Q0Zwzta4ny%2Fcard_klarna_paylater.svg?alt=media&#x26;token=822e02a0-34f0-4a48-b086-67e5165960d1" alt="" data-size="line"><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FhwFChllXfqdTZ64sg6sz%2Fimage.png?alt=media&#x26;token=07f340b8-4d88-46b1-8e25-592715b04489" alt="" data-size="line"> Klarna
* und viele weiter

## Setup

Gehe bitte nach der folgenden Anleitung vor, um Ingenico ePayments ALIAS GATEWAY als externen Zahlungsanbieter in Payrexx zu integrieren.

### Konfiguration von Payrexx

{% hint style="info" %}
Bitte beachte, dass Du bei Payrexx [eingeloggt](https://login.payrexx.com/de) sein musst, bevor Du beginnst. Falls Du noch kein Konto hast, [registriere](https://signup.payrexx.com/de/email-validation/) Dich bitte bei Payrexx.
{% endhint %}

* Navigiere im Hauptmenü Deines Payrexx-Kontos zu **Zahlungsanbieter**.
* Klicke bei "Kredit- und Debitkarten" auf "Anzeigen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FSXvrhdmKOHyYeqJ84IIo%2Fimage.png?alt=media&#x26;token=be3228e0-b458-448a-8881-fb2fa12be484" alt=""><figcaption><p>Anzeigen der verschiedenen externen Zahlungsanbieter in Payrexx</p></figcaption></figure></div>

* Klicke neben "Ingenico ePayments (Alias Gateway)" auf die grüne Schaltfläche "Einrichten":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FObPCxWtqFGy2nW5yDn3r%2Fimage.png?alt=media&#x26;token=dcfadebb-6344-4fc6-bcb0-ff7cba8912ff" alt=""><figcaption><p>Einrichtung von Ingenico ePayments (Alias Gateway) in Payrexx</p></figcaption></figure></div>

* Fordere ein Vertragsangebot von Ingenico an, indem Du auf die grüne Schaltfläche klickst:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FsZNEtgnT7A30gRC3y3Gy%2Fimage.png?alt=media&#x26;token=a6b8d5b6-b5b6-4d0c-8c27-cf11311c138d" alt=""><figcaption><p>Anfordern eines Vertragsangebots von Ingenico</p></figcaption></figure></div>

* Fülle das Formular aus und sende es ab.

### Konfiguration von Ingenico

Nachdem Du von Ingenico eine E-Mail erhalten hast, logge Dich in Dein Konto bei Ingenico ein und aktiviere die folgenden Optionen:

#### Mindestanforderungen

* OPC ¦ One Page Checkout (Alias Gateway)&#x20;
* DPR ¦ DirectLink (neue Zahlungen)&#x20;
* USR1 ¦ Benutzer Manager für bis zu 2 Benutzer &#x20;

#### Optional:

* D3D ¦ D3D (Direct Link 3D)&#x20;
* DMT ¦ DirectLink (Verwaltung)&#x20;
* DQY ¦ DirectLink (Anfrage)
* RECX ¦ Alias Manager

### Konfiguration von Payrexx

* Logge Dich in Dein Konto von Payrexx ein und erfasse die Zugangsdaten, die Dir Ingenico via E-Mail zugeschickt hat.
* Stelle sicher, dass der Testmodus aktiviert ist.

### Konfiguration von Ingenico

1. Melde Dich in der Ogone-Administration von Ingenico an.
2. Aktiviere die Zahlungsmethode "Ogone Alias Gateway".
3. Teste den Zahlungsvorgang im Frontend.
4. Beantrage bei Ingenico die Schaltung in den produktiven Betrieb. Sende hierfür eine E-Mail an Ogone und gib Deine PSPID an.
5. Nach Erhalt der Bestätigung für die Produktivschaltung kannst Du den Modus auf produktiv wechseln.

{% hint style="success" %}
Die Lösung ist damit betriebsbereit.
{% endhint %}

### Konfiguration des Kontos bei Ogone

#### Basiskonfiguration

Nimm bitte als Erstes die Basiskonfiguration Deines Kontos bei Ingenico vor.

#### Optionen hinzufügen

Um den Payrexx Alias Gateway verwenden zu können, musst Du die Optionen "One Page Checkout (OPC)" und den Benutzer-Manager für bis zu 2 Benutzer (USR1) erwerben.\
Nach der Freischaltung kannst Du unter **Konfiguration > Benutzerverwaltung** einen API-Benutzer hinzufügen, indem Du beim Erstellen des Benutzers das Kontrollkästchen "Spezieller Benutzer für API" aktivierst. Die Zugangsdaten dieses Benutzers müssen in Payrexx entsprechend hinterlegt werden.

#### Einrichtung DirectLink

Navigiere im Backoffice von Ingenico zu **Konfiguration > Technische Informationen > Daten- und Ursprungsüberprüfung**:

1. Lasse beim Abschnitt "Überprüfungen für DirectLink und Batch" das Feld "IP-Adresse" leer.
2. Füge im Feld "SHA-IN Signatur" die im Payrexx-Backend definierte Signatur ein. Du findest sie unter **Einstellungen > Zahlungsanbieter > Ingenico E-Payments (Alias Gateway)**.

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11027068831/original/-pbB4nY7S9eB5cAvQWhImAOY-xYsDDfr5w.png?1517239463" alt="Daten- und Ursprungsüberprüfung in Ingenico"></div>

### Konfiguration von Masterpass

1. Melde Dich auf der Webseite von Ingenico mit Deinen Zugangsdaten an.
2. Navigiere zu **Konfiguration > Technische Informationen > Transaktions-Feedbac**k:

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11021584469/original/VuY0Rc7oG-JDYSGmOyDPBcoYp1YuqH_cBg.png?1504161208" alt="Einstellungen zum Transaktions-Feedback in Ingenico"></div>

* Verschiebe unter "Directlink" die "REDIRECTIONURL" und alle "ECOM\_"-Parameter auf die rechte Seite der Maske:

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11021584486/original/fr2Pay-Du1Eddo3jQyWg34nVtCnyurKu7Q.png?1504161235" alt="Konfiguration der Parameter in Ingenico"></div>

{% hint style="info" %}
Zur Konfiguration des Masterpass Full-Checkouts benötigst Du Dein DirectLink-Produkt von Ingenico.
{% endhint %}