Registrieren

Adapter: Ingenico ePayment

Ingenico ist ein global tätiger Anbieter von Zahlungslösungen. Über die Zahlungsplattform von Ingenico bezahlen Kunden in rund 170 Ländern ihre Einkäufe.

Allgemein

Ingenico ist ein global tätiger Anbieter von Zahlungslösungen. Über die Zahlungsplattform von Ingenico bezahlen Kunden in rund 170 Ländern ihre Einkäufe.

Ingenico ePayment kannst du in zahls.ch über zwei Integrationen einbinden: E-COMMERCE und ALIAS GATEWAY. Die Einrichtung beider Varianten ist weiter unten beschrieben.

Länder-Verfügbarkeit

Die Zahlungslösungen von Ingenico sind weltweit in rund 170 Ländern verfügbar.

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.

Funktionen

Zahlungsmöglichkeiten

Die folgenden Funktionen stehen im Dashboard von zahls.ch zur Verfügung:

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

Zahlungsmethoden

  • Visa
  • Mastercard
  • American Express
  • Diners Club International
  • Discover Card
  • Masterpass
  • Klarna
  • und viele weiter

Setup

Gehe bitte nach der folgenden Anleitung vor, um Ingenico ePayments E-COMMERCE als externen Zahlungsanbieter in zahls.ch zu integrieren.

Konfiguration von zahls.ch

  • Navigiere im Hauptmenü deines zahls.ch-Kontos zu Zahlungsanbieter.

  • Klicke bei "Kredit- und Debitkarten" auf "Anzeigen":

  • Klicke neben "Ingenico ePayments (E-Commerce)" auf die grüne Schaltfläche "Einrichten":

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

  • 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 zahls.ch-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):

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

  1. Wähle die Zahlungsarten aus, die du anbieten möchtest.
  2. Aktiviere die gewünschten Währungen.
  3. 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:
  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.
  3. Erfasse im Feld "SHA-IN Signature" den entsprechenden Wert aus deinem zahls.ch-Konto.

Globale Transaktionsparameter

  • Navigiere zu Global transaction parameters (Globale Transaktionsparameter).
  • Stelle sicher, dass deine Einstellungen mit denen in der folgenden Abbildung übereinstimmen:

Globale Sicherheitsparameter

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

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:

Transaktions-Feedback

  1. Navigiere zu Transaction feedback (Transaktions-Feedback).

  2. Stelle sicher, dass alle Eingabefelder leer sind.

  3. Aktiviere die beiden Kontrollkästchen:

  4. Aktiviere im Abschnitt "Direct HTTP server-to-server request" (Direkte HTTP Server-zu-Server-Anfrage) die Optionen "Always online (...)"

  5. Kopiere den Wert https://dispatcher.zahls.ch/ogone/callback.php?result=-1 ins Feld "If the payment's status is accepted (..)".

  6. Kopiere den Wert https://dispatcher.zahls.ch/ogone/callback.php?result=-2 ins Feld "If the payment's status is cancelled (..)".

  7. Wähle unter "Request method" die Option "POST":

  • Aktiviere COMPLUS, PAYID, ORDERID und STATUS und Dynamic E-Commerce Parameters.
  1. Füge den Wert für «SHA-OUT pass phrase» ins entsprechende Feld ein. du findest diesen Wert in zahls.ch 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:

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 zahls.ch-Konto.
  • Teste den Zahlungsablauf im Frontend von zahls.ch. du kannst dafür beispielsweise das 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 und gibt deine PSPID an.
  • Nachdem du die Bestätigung von Ingenico erhalten hast, logge dich in dein Konto bei zahls.ch 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.

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.

Ingenico ALIAS GATEWAY

Allgemein

Ingenico ALIAS GATEWAY ist eine Erweiterung von Ingenico E-COMMERCE, 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.

Funktionen

Zahlungsmöglichkeiten

Die folgenden Funktionen stehen im Dashboard von zahls.ch zur Verfügung:

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

Zahlungsmethoden

  • Visa
  • Mastercard
  • American Express
  • Diners Club International
  • Discover Card
  • Masterpass
  • Klarna
  • und viele weiter

Setup

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

Konfiguration von zahls.ch

  • Navigiere im Hauptmenü deines zahls.ch-Kontos zu Zahlungsanbieter.

  • Klicke bei "Kredit- und Debitkarten" auf "Anzeigen":

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

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

  • 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)
  • DPR ¦ DirectLink (neue Zahlungen)
  • USR1 ¦ Benutzer Manager für bis zu 2 Benutzer

Optional:

  • D3D ¦ D3D (Direct Link 3D)
  • DMT ¦ DirectLink (Verwaltung)
  • DQY ¦ DirectLink (Anfrage)
  • RECX ¦ Alias Manager

Konfiguration von zahls.ch

  • Logge dich in dein Konto von zahls.ch 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.

Konfiguration des Kontos bei Ogone

Basiskonfiguration

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

Optionen hinzufügen

Um den zahls.ch 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 zahls.ch entsprechend hinterlegt werden.

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 zahls.ch-Backend definierte Signatur ein. du findest sie unter Einstellungen > Zahlungsanbieter > Ingenico E-Payments (Alias Gateway).

Konfiguration von Masterpass

  1. Melde dich auf der Webseite von Ingenico mit deinen Zugangsdaten an.
  2. Navigiere zu Konfiguration > Technische Informationen > Transaktions-Feedback:
  • Verschiebe unter "Directlink" die "REDIRECTIONURL" und alle "ECOM_"-Parameter auf die rechte Seite der Maske:

Verwandte Themen