# Ingenico E-COMMERCE

## Allgemein

Ingenico E-COMMERCE ist die Standard-Schnittstelle von Ingenico und dient der Abwicklung von Online-Zahlungen. Als Händler kannst Du Deinen Webshop ans System anbinden und so Zahlungen sicher verarbeiten.

### 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 E-COMMERCE 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 (E-Commerce)" 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%2F9wgMnj6STufkPeMSbmzj%2Fimage.png?alt=media&#x26;token=2a94c8d3-5552-42a3-9360-60b94ae23b34" alt=""><figcaption><p>Einrichtung von Ingenico ePayments (E-Commerce) 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.
* Bitte stelle sicher, dass die Option "TPD ¦ Dynamische Vorlage" bei Ingenico aktiviert wird.
* Du erhältst von Ingenico eine E-Mail mit Deinen Zugangsdaten.
* Navigiere in Deinem Payrexx-Konto zu **Zahlungsanbieter**, klicke "Kredit- und Debitkarten" auf "Anzeigen" und dann neben "Ingenico ePayments (E-Commerce)" auf "Konfigurieren".
* Aktiviere den Testmodus (1) und wähle das entsprechende Paket (2):

<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%2Fn4sRwvvPggs25Hv9JMIC%2Fimage.png?alt=media&#x26;token=ad890e2d-daaa-4395-8327-5a3c7a93ef05" alt=""><figcaption><p>Aktivierung des Testmodus' und Auswahl des Pakets</p></figcaption></figure></div>

* Trage die Zugangsdaten, die Du von Ingenico erhalten hast, in die entsprechenden Felder ein und schliesse die Konfiguration wie folgt ab:

<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%2FdOZAtoImahJ6tP3oqcJC%2Fimage.png?alt=media&#x26;token=b28f588c-195f-4ba4-8c6d-843d24c65c47" alt=""><figcaption><p>Konfiguration von Ingenico im Textmodus</p></figcaption></figure></div>

1.
2. Wähle die Zahlungsarten aus, die Du anbieten möchtest.
3. Aktiviere die gewünschten Währungen.
4. Fülle die Felder unter "Testmodus" mit den Daten, die Du von INgenico erhalten hast, aus.

### Konfiguration von Ingenico ePayment

* Melde Dich bei Deinem Konto bei Ingenico an, um mit der Einrichtung zu beginnen:
  * Anmeldung bei einem [Testkonto](https://secure.ogone.com/ncol/test/backoffice)
  * Anmeldung bei einem [Live-Konto](https://secure.ogone.com/ncol/prod/backoffice)

1. Navigiere zu **Data and origin verification** (Daten- und Ursprungsüberprüfung).
2. Stelle sicher, dass das Feld "URL of the merchant page (...)" leer ist.&#x20;
3. Erfasse im Feld "SHA-IN Signature" den entsprechenden Wert aus Deinem Payrexx-Konto.

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11005566072/original/Ogone_Basic_en4.png?1465388605" alt="Konfiguration der Daten- und Ursprungsüberprüfung bei Ingenico"></div>

{% hint style="info" %}
Klicke auf "Speichern", um den Vorgang abzuschliessen.
{% endhint %}

#### Globale Transaktionsparameter

* Navigiere zu **Global transaction parameters** (Globale Transaktionsparameter).&#x20;
* Stelle sicher, dass Deine Einstellungen mit denen in der folgenden Abbildung übereinstimmen:

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11065973314/original/OgUatopiLJ5P2KtnZu3SyDDIt8c2WHnKew.png?1606321916" alt="Konfiguration der globalen Transaktionsparameter bei Ingenico"></div>

#### Globale Sicherheitsparameter

1. Navigiere zu **Global security parameters** (Globale Sicherheitsparameter).&#x20;
2. Stelle sicher, dass die benutzte Hash-Methode mit derjenigen in den Zahlungsanbieter-Einstellungen in Payrexx übereinstimmt.
3. Aktiviere zudem die erste Option unterhalb von "Character encoding":

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11005565861/original/Ogone_Basic_en.png?1465388411" alt="Konfiguration der globalen Sicherheitsparameter bei Ingenico"></div>

#### Zahlungsseite

* Navigiere zu **Payment page** (Zahlungsseite).
* Stellen sicher, dass das Kontrollkästchen unterhalb von "Cancel button" deaktiviert und das Feld unterhalb von "Back button redirection" leer ist:

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11065974713/original/cDMYVpk60WehXRixU9vgo8wmuEvLuJrOSw.png?1606323894" alt="Konfiguration der Zahlungsseite bei Ingenico"></div>

#### Transaktions-Feedback

1. Navigiere zu **Transaction feedback** (Transaktions-Feedback).
2. Stelle sicher, dass alle Eingabefelder leer sind.
3. Aktiviere die beiden Kontrollkästchen:

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11065998567/original/0smTEjFuwb-QNr5F9o5J39Il3Qn1FfpuLQ.png?1606376757" alt="Konfiguration des Transaktions-Feedbacks bei Ingenico"></div>

1. Aktiviere im Abschnitt "Direct HTTP server-to-server request" (Direkte HTTP Server-zu-Server-Anfrage) die Optionen "Always online (...)"
2. Kopiere den Wert <https://dispatcher.payrexx.com/ogone/callback.php?result=-1> ins Feld "If the payment's status is accepted (..)".
3. Kopiere den Wert <https://dispatcher.payrexx.com/ogone/callback.php?result=-2> ins Feld "If the payment's status is cancelled (..)".
4. Wähle unter "Request method" die Option "POST":

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11005566421/original/Ogone_Basic_en6.png?1465389006" alt="Konfiguration der HTTP Server-zu-Server-Anfrage in Ingenico"></div>

* Aktiviere COMPLUS, PAYID, ORDERID und STATUS und Dynamic E-Commerce Parameters.

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11065999092/original/GP8xBsv4wwLznM0C7Sg3Tbpqn_Yo5DBA2A.png?1606377658" alt="Aktivierung der dynamischen E-Commerce-Parameter in Ingenico"></div>

1. Füge den Wert für «SHA-OUT pass phrase» ins entsprechende Feld ein. Du findest diesen Wert in Payrexx unter **Einstellungen > Zahlungsanbieter > PostFinance** im Feld "SHA-OUT Signatur"
2. Wähle die Option "No request für die Einstellung "HTTP Anfrage für Statusänderungen" und speichere die Einstellungen:

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11005566527/original/Ogone_Basic_en7.png?1465389148" alt="Konfiguration in Ingenico"></div>

#### E-Mails zu Transaktionen

* Navigiere zu **E-Mails zu Transaktionen**.
* Erfasse unter "E-Mail-Adresse(n) für transaktionsbezogene E-Mails" Deine E-MailAdresse und klicke auf "Speichern".
* Aktiviere die Zahlungsmöglichkeit «Ogone by Ingenico» in Deinem Payrexx-Konto.
* Teste den Zahlungsablauf im Frontend von Payrexx. Du kannst dafür beispielsweise das [Terminal](https://docs.payrexx.com/merchant/payrexx-administration/tools/terminal) verwenden.

#### Beantragen des produktiven Modus

* Beantrage bei Ingenico ePayments, Dein Konto in den produktiven Modus (Live-Modus) zu schalten. Sende hierfür eine E-Mail an [admin.ecom@ingenico.com](https://support.payrexx.com/a/solutions/articles/1000131883/admin.ecom@ingenico.com) und gibt Deine PSPID an.&#x20;
* Nachdem Du die Bestätigung von Ingenico erhalten hast, logge Dich in Dein Konto bei Payrexx ein und navigiere zu **Zahlungsanbieter**.
* Klicke neben "Ingenico ePayments (E-Commerce)" auf "Konfigurieren".
* Überprüfe die Anmeldedaten in den entsprechenden Feldern.
* Aktiviere den Live-Modus.

{% hint style="success" %}
Ingenico ePayments (E-Commerce) ist einsatzbereit.
{% endhint %}

### Konfiguration von Masterpass

Zur Konfiguration des Full-Checkouts von Masterpass benötigst Du das Produkt "DirectLink" von Ingenico. Weitere Informationen findest Du in der entsprechenden [Anleitung](https://docs.payrexx.com/merchant/bezahldienste/externe-zahlungsanbieter/kreditkarten/ingenico/ingenico-epayments-alias-gateway-integration-in-payrexx).