# 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="/files/EYEkyeAbqbFj5wMD4a2C" alt="" data-size="line"> Visa
* <img src="/files/YgEMSM0uuzu0zEr7G3N2" alt="" data-size="line"> Mastercard
* <img src="/files/nhJpDEF5siSiZ1PYf2sD" alt="" data-size="line"> American Express
* <img src="/files/KyMObC4NB9XLN5w6nG3b" alt="" data-size="line"> Diners Club International
* <img src="/files/hWsNhEecDhAgfFSuqIwO" alt="" data-size="line"> Discover Card
* <img src="/files/vVqolGGjmYXfjT0umfC4" alt="" data-size="line"> Masterpass
* <img src="/files/Si85FKzqMR7QhlMIwlW1" alt="" data-size="line"><img src="/files/5tUKnraMZivl4tDWvGfp" 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="/files/C0OhWmJ8klWBmZCc4jk0" 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="/files/lOGMRpq43TKwCMGiCFty" 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="/files/sCLGaBzSdgD3eMJttWZw" 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="/files/zjkzV5mQCwdKcegQdeC3" 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="/files/NGICGUqSfIVeEBsdhqwP" 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](/merchant/payrexx-administration/tools/terminal.md) 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](/merchant/bezahldienste/externe-zahlungsanbieter/kreditkarten/ingenico/ingenico-epayments-alias-gateway-integration-in-payrexx.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payrexx.com/merchant/bezahldienste/externe-zahlungsanbieter/kreditkarten/ingenico/ingenico-epayments-e-commerce-integration-in-payrexx.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.