Integration
Laden Sie die neueste Version des PAYONE Magento 1 Plugins aus unserem GitHub-Repository herunter.
Um den Transaktionsstatus an die richtige Adresse zu senden, melden Sie sich im PAYONE Merchant Interface (PMI) an.
Navigieren Sie zu: Konfiguration → Zahlungsportale → IHR_PORTAL → Erweitert → TransactionStatus URL
Setzen Sie unter Allgemein die zusätzlichen Antwortdaten sowohl für Live- als auch für Testmodus auf "ein".
Navigieren Sie zu: PAYONE → Konfiguration → Allgemein → Global
Bitte geben Sie hier Ihre Zugangsdaten aus dem PMI ein:
Hier können Sie weitere Einstellungen vornehmen
| Feld | Beschreibung |
|---|---|
| Händler-ID | Sie finden Ihre PAYONE Händler-ID oben rechts im PAYONE Merchant Interface (PMI) und auf allen PAYONE-Rechnungen. |
| Portal-ID | Sie finden die Portal-ID im PAYONE Merchant Interface (PMI) unter Konfiguration → Zahlungsportale |
| Unterkonto-ID | Sie finden die ID im PAYONE Merchant Interface (PMI) unter Konfiguration → Konten |
| Sicherheitsschlüssel | Bitte geben Sie hier den Schlüssel ein, um die Datenkommunikation vor Manipulation zu schützen. Dieser muss identisch mit dem im entsprechenden PAYONE-Zahlungsportal gespeicherten Schlüssel sein. |
| Zahlung aus anwendbaren Ländern | Auswahlmöglichkeit für den Shop, in welchen Ländern die Zahlung über PAYONE ermöglicht werden soll. |
| Autorisierungsmethode | Vorautorisierung: Der zu zahlende Betrag wird im Verlauf der Bestellung reserviert. In diesem Fall muss die Abbuchung in einem zweiten Schritt bei der Warenlieferung eingeleitet werden (Capture). Die Forderung wird erst nach erfolgter Capture gebucht. Autorisierung: Der zu zahlende Betrag wird sofort bei der Bestellung eingezogen. Die Forderung wird sofort auf der PAYONE-Plattform gebucht. |
| IP-Adresse übertragen | Wählen Sie aus, ob die IP-Adresse des Endkunden an die PAYONE-Plattform übertragen werden soll. Derzeit unterstützt die PAYONE-Plattform nur IPv4. Wenn Ihr Hoster IPv6 unterstützt, sollten Sie diese Einstellung deaktivieren, da es sonst zu abgelehnten Transaktionen kommen kann. In diesem Fall ist eine Überprüfung der IP-Adresse nicht möglich. |
| Proxy-Modus | Aktivieren Sie diese Option, um die IP aus dem HTTP_X_FORWARDED_FOR-Header zu übertragen. Dies ist nur notwendig, wenn Ihr Shop hinter einem Proxy-Server läuft. |
| Währung | Hier können Sie auswählen, ob Anfragen in der ausgewählten Währung an die PAYONE-Plattform gesendet werden oder ob die Beträge vorher Magento-intern in eine Basiswährung umgerechnet werden sollen. |
Navigieren Sie zu: PAYONE → Konfiguration → Zahlungsarten
Alle erstellten PAYONE-Zahlungsarten werden in dieser Übersicht angezeigt. Mit den Schaltflächen oben können Sie weitere Zahlungsarten hinzufügen und konfigurieren. Über den Link "Bearbeiten" kann jede einzelne Zahlungsart spezifisch konfiguriert werden. Bitte beachten Sie, dass Sie nur die Zahlungsarten konfigurieren sollten, die Sie bei PAYONE bestellt haben.
| Feld | Beschreibung |
|---|---|
| Aktiviert | Bestimmt, ob die Zahlungsart im Checkout-Prozess verfügbar ist. |
| Sortierreihenfolge | Geben Sie eine Ganzzahl ein, die bestimmt, an welcher Stelle im Checkout die Zahlungsart dem Kunden angeboten wird. |
| Name | Freie Texteingabe für den Namen der Zahlungsart, wie er dem Kunden im Checkout angezeigt wird. |
| Bearbeitungsgebühr | Bestimmung einer Bearbeitungsgebühr pro Versandart und zugehörigen Ländern. |
| Mindestbestellwert | Der Mindestwert der Waren, ab dem die Zahlungsart dem Kunden im Checkout angezeigt wird, z.B. 100 = 100 EUR |
| Höchstbestellwert | Der Höchstwert der Waren, bis zu dem die Zahlungsart dem Kunden im Checkout angezeigt wird, z.B. 100 = 100 EUR |
| Modus | Hier können Sie für die jeweilige Zahlungsart angeben, ob die Zahlungen im Testmodus verarbeitet werden sollen oder ob sie "live" ausgeführt werden sollen. Sie können auch den Testmodus für einzelne Zahlungsarten konfigurieren. |
| Globale Einstellungen verwenden | Wählen Sie Ja / Nein. Wenn Nein ausgewählt ist, können alle Parameter aus den globalen Einstellungen individuell für diese Zahlungsart konfiguriert werden. Die Dokumentation dieser Einstellungen finden Sie unter Punkt 4.2.2. |
Einige Zahlungsarten erfordern spezielle Anpassungen. Die nächsten Punkte sind nur für Sie relevant, wenn Sie die spezifische Zahlungsart verwenden.
Diese Zahlungsart erfordert ein separates Zahlungsportal. Bitte klicken Sie unter PAYONE → Konfiguration → Zahlungsarten → Rechnung mit Zahlungsgarantie → Globale Einstellungen verwenden auf Nein und geben Sie unter Portal-ID eine separate Portal-ID ein.
| Feld | Beschreibung |
|---|---|
| PayPal Express Checkout Verknüpfung im Warenkorb | Aktiviert die PayPal ECS-Schaltfläche im Warenkorb für den Checkout |
| PayPal Express Bild-Schaltfläche | Hier können Sie das entsprechende Logo für die StoreView hochladen. |
Um PayPal ECS korrekt zu verwenden, ist es notwendig, das im Magento-Standard enthaltene Modul für PayPal zu aktivieren.
| Feld | Beschreibung |
|---|---|
| Detaillierte Fehlermeldungen anzeigen | Hier können Sie auswählen, ob im Falle einer Ablehnung die von RatePay übertragene Fehlermeldung angezeigt werden soll, z.B. dass die Transaktion aufgrund der Bonitätsprüfung nicht ausgeführt werden konnte, oder ob eine generische Fehlermeldung angezeigt werden soll. |
| RatePay Shop-IDs | RatePay erfordert die Übertragung einer sogenannten Shop-ID, die die Parameter des Shops identifiziert. Geben Sie die von RatePay erhaltenen Shop-IDs und die entsprechende Währung im ISO 4217-Format ein (z.B. EUR, USD, DKK). Beim Speichern der Konfiguration werden die Parameter bei RatePay abgefragt und in die Konfiguration übertragen. |
Wenn Sie von Ratepay eine benutzerdefinierte Device Fingerprint Snippet ID erhalten haben, können Sie diese unter PAYONE → Konfiguration → Allgemein (am Ende der Seite) konfigurieren. Der Standardwert ist "ratepay".
Bei der Verwendung von Anpassungsrückerstattungen bei RatePay-Transaktionen stellen Sie bitte sicher, dass Sie die Menge aller Artikel auf 0 setzen, um die generische Rückerstattung erfolgreich auszulösen.
| Feld | Beschreibung |
|---|---|
| Kreditkartentyp | Mehrfachauswahl. Welche Kreditkartenmarken sollen im Frontend angeboten werden? |
| Kartenprüfnummer ausblenden | Blendet die Prüfnummer für Karten aus, die diese nicht anbieten |
| Kartenprüfnummer prüfen | Nein / Erste Bestellung mit Karte / Immer Bestimmt, ob die Kreditkartenprüfnummer abgefragt wird. Dies ist nur möglich, wenn der Acquirer es erlaubt
|
| Zahlungsdaten für angemeldete Benutzer speichern | Hier können Sie angeben, ob die Pseudo-Kreditkartendaten für registrierte Benutzer gespeichert werden sollen, damit der Benutzer bei einer erneuten Bestellung seine Kreditkartennummer nicht erneut eingeben muss. Die tatsächlichen Kreditkartendaten werden nur bei PAYONE gespeichert. |
| Feld | Beschreibung |
|---|---|
| Bankleitzahl validieren | Bestimmt, ob eine zusätzliche Überprüfung der Bankdaten durchgeführt werden soll. |
| Liste der unterstützten SEPA-Länder | Mehrfachauswahl der Länder, aus denen die Zahlungsart Lastschrift unterstützt wird. Die PAYONE-Plattform unterstützt derzeit nur Lastschriften für deutsche Bankkonten. |
| Zusätzliche Kontonummer/Bankleitzahl anzeigen | Legacy-Option aus der Übergangszeit von Kontonummer zu IBAN. Bitte wählen Sie NEIN. |
| Mandat aktiviert | Wählen Sie Ja / Nein. Soll der SEPA-Mandatsmanager verwendet werden? Eine Überprüfung der Bankdaten ist obligatorisch. Eine Überprüfung gegen die POS-Sperrliste ist nicht möglich. |
| Mandats-Download aktiviert | Hier können Sie festlegen, ob der Käufer am Ende des Checkouts einen Download des Mandats von PAYONE erhält. |
| Zahlungsdaten für angemeldete Kunden speichern | Hier können Sie angeben, ob IBAN und BIC eines angemeldeten Benutzers gespeichert werden sollen, damit sie bei einer neuen Bestellung nicht erneut eingegeben werden müssen. Die Kontoverbindung wird verschlüsselt in der Magento-Datenbank gespeichert. |
Zusätzlich zur Konfiguration in Magento ist es auch notwendig, die entsprechenden Zertifikate einzurichten, um Apple Pay als Zahlungsart zu betreiben. Eine Anleitung dazu finden Sie hier: Besondere Hinweise - Apple Pay
Zusätzlich verlangt Apple eine Validierung der Shop-Domain für Apple Pay. Befolgen Sie dazu die Anweisungen im Apple Developer Portal:
| Feld | Beschreibung |
|---|---|
| Firmenname | Der vollständige Name des Unternehmens muss hier erscheinen. Der Name wird in der Datenschutzerklärung verwendet. |
| Ratenkauf Muster-Benutzername | Um den Ratenkauf-Mustervertrag abzurufen, muss hier der von Unzer zugewiesene Benutzername (normalerweise Händlername Installation) gespeichert werden. |
| Ratenkauf Muster-Passwort | Das von Unzer zugewiesene Passwort muss hier gespeichert werden, um den Ratenkauf-Mustervertrag abzurufen. |
| B2B-Modus | Wenn der B2B-Modus aktiviert ist, wird automatisch angenommen, dass es sich um eine B2B-Transaktion handelt, wenn das Feld "Unternehmen" bei der Adresseingabe ausgefüllt wurde. Zur Überprüfung der Kreditwürdigkeit des Unternehmens werden dann weitere Informationen wie die Handelsregisternummer im Checkout abgefragt. |
| Typ | Mehrfachauswahl: Hier können Sie auswählen, welche Zahlungsarten von Unzer dem Käufer zur Verfügung stehen sollen. Sie können zwischen Kauf auf Rechnung, Ratenzahlung und Lastschrift wählen. |
Navigieren Sie zu: PAYONE → Bestellungen
Hier finden Sie eine PAYONE-spezifische Bestellübersicht ähnlich der Magento-Bestellübersicht. Zusätzlich zu den Standardinformationen können Sie den Zahlungsstatus auf der PAYONE-Plattform, die genaue Art der Zahlung (z.B. Kreditkartenmarken) und gegebenenfalls den Mahnstatus einsehen. Ein Klick auf "Anzeigen" öffnet die Detailansicht der entsprechenden Bestellung.
Durch Auswahl von "Online erfassen" im Dropdown wird die Forderung auf der PAYONE-Plattform eingezogen. Wenn Sie das Geld nicht erfassen, aber trotzdem eine Rechnung erstellen möchten, verwenden Sie stattdessen "Offline erfassen".
Teilerfassungen sind auch möglich, indem Sie einfach die fakturierbare Menge der Artikel anpassen.
Bereits erfasste Gelder können durch Erstellen einer Gutschrift für eine bestehende Rechnung zurückgegeben werden.
Durch Auswahl der Schaltfläche "Rückerstattung" wird Geld an die Zahlungsart des Kunden zurückgesendet. "Offline rückerstatten" erstellt die Gutschrift, löst aber keinen Geldfluss aus.
Teilrückerstattungen sind mit derselben Methode wie bei Teilerfassungen möglich. Sie können auch die Summe der Rückerstattung anpassen, um Gebühren während der Rückerstattung zu berücksichtigen, aber bedenken Sie, dass einige Zahlungsarten darauf angewiesen sind, dass die Warenkorbpositionen mit der ursprünglichen Bestellung übereinstimmen.
Hier finden Sie separate Einstellungsoptionen, mit denen Sie unser Plugin genauer an Ihre Bedürfnisse anpassen können.
Klicken Sie auf PAYONE → Allgemein → Rechnungsinformationen senden, um die Übertragung von Artikeldaten zur Erstellung einer Rechnung auf der PAYONE-Plattform zu aktivieren.
Der Text kann frei gewählt werden und erscheint als dynamischer Text auf der Rechnung oder Gutschrift. Verschiedene Magento-Variablen können als Platzhalter verwendet werden.
Navigieren Sie zu: PAYONE → Konfiguration → Allgemein → Status-Zuordnung
Die verschiedenen Transaktionsstatus der PAYONE-Plattform können Magento-Bestellstatus zugeordnet werden. Wenn ein neuer Transaktionsstatus empfangen wird, wird der entsprechende "Magento-Status" in der Bestellübersicht im Magento-Backend gesetzt. Dies kann für jede Zahlungsart separat eingegeben werden.
Unser Plugin bietet Ihnen die Konformität mit dem "niedrigsten" Compliance-Level nach PCI DSS (SAQ A). Da in diesem Compliance-Level alle Kreditkartendaten nur in Feldern eingegeben werden dürfen, die von einem PCI DSS-zertifizierten Dienstleister gehostet werden, verwendet unsere Erweiterung iFrames, die in den Checkout integriert sind. Diese erben jedoch nicht das CSS der Shop-Vorlage, sondern enthalten ihren eigenen Stil. Sie können die folgenden Einstellungen unter PAYONE → Konfiguration → Allgemein → Kreditkartenzahlung verwenden, um diese Felder anzupassen.
| Feld | Beschreibung |
|---|---|
| Mindestgültigkeitsdauer | Geben Sie eine Ganzzahl in Tagen ein. Dieser Wert definiert die Anzahl der Tage, die eine Kreditkarte gültig sein muss, bevor sie beim Checkout abgelehnt wird. |
| Anfrage-Typ | hosted-iFrame / AJAX Stellen Sie sicher, dass Sie immer "hosted iFrame" verwenden. Nur Händler mit einem PCI DSS-Zertifizierungslevel von SAQ A-EP oder höher dürfen AJAX verwenden. Wir empfehlen dennoch dringend die Verwendung von hosted iFrame!
|
| Eingabe-Konfiguration | Hier können Sie separate Parameter für die einzelnen Felder der Kreditkartenabfrage festlegen. |
| Typ | Numerisch - Nur Zahlen sind erlaubt und für mobile Geräte wird die numerische Tastatur verwendet input type="tel". Passwort - input type="password" Text - input type="text" |
| Stellenanzahl | Länge des Feldes in Zeichen (HTML-Attribut size) |
| Max-Stellen | Maximale Eingabelänge (HTML-Attribut maxlength) |
| IFrame | Standard - Verwendet Breite und Höhe aus dem Standardstil Benutzerdefiniert - Verwendet Breite und Höhe aus den folgenden Feldern |
| Breite | CSS - Breite angeben |
| Höhe | CSS - Höhe angeben |
| Stil | Standard - Verwendet CSS-Spezifikation aus Standard Benutzerdefiniert - Verwendet CSS-Spezifikation aus dem folgenden Feld |
| CSS | Spezifikation von CSS-Eigenschaften für Feld Deaktiviert bei vorheriger Auswahl von Standard |
| Standardstil | |
| Felder | Eingabe - CSS-Spezifikation für alle Eingabefelder (HTML input) Auswahl - CSS-Spezifikation für alle Auswahlfelder (HTML select) |
| IFrame | Breite - CSS-Spezifikation Höhe - CSS-Spezifikation |
| Fehlerausgabe | |
| Sprache | Wählen Sie die Sprache aus, in der die Fehlermeldung ausgegeben werden soll. |
| Automatische Erkennung der Kreditkartennummer aktivieren | Bestimmt, ob die Kartennummer automatisch bestimmt werden soll, wenn die ersten sechs Ziffern eingegeben werden. |
An dieser Stelle können Sie sehen, wie das Aussehen entsprechend der vorherigen Einstellung der Kreditkarten-Zahlungsart im Checkout aussieht.
Simple Protect ist der einfache und flexible Weg, alle Daten zu nutzen, die Sie haben, genau in dem Moment, in dem Ihr Shop den Checkout verarbeitet. Sie können z.B. Informationen gewinnen aus:
Hier ist ein Beispiel für einige komplexe Entscheidungen, die mit unserem Simple Protect Framework durchgeführt werden können:
ℹ️ Beta-Status: Simple Protect befindet sich derzeit im Beta-Stadium. Wenn Sie diese Funktionalität nutzen möchten, müssen Sie die PAYONE-Integration aus dem Simple Protect-Branch herunterladen:
https://github.com/PAYONE-GmbH/magento-2/tree/simple-protect
Danach befolgen Sie bitte die Anweisungen zur Installation der Simple Protect-Vorlage hier:
Navigieren Sie zu: PAYONE → Konfiguration → PROTECT
Navigieren Sie zu: PAYONE → Konfiguration → Sonstiges
Das Address Verification System (AVS) ist ein American Express-Adressverifizierungssystem. Die vom Endkunden eingegebene Rechnungsadresse wird mit der Rechnungsadresse der Kreditkarte verglichen.
Navigieren Sie zu: PAYONE → Konfiguration → Konfiguration exportieren
Durch Klicken auf "Konfiguration exportieren" wird eine Datei heruntergeladen.
Sie können diese Datei nun mit einem XML-Editor öffnen und anzeigen oder speichern. Dieser Export ist sehr wichtig für jede Support-Anfrage an das PAYONE-Team, um mögliche Konfigurationsprobleme zu vermeiden. Diese Datei kann auch verwendet werden, um festzustellen, ob weitere Erweiterungen installiert wurden, die Kompatibilitätsprobleme verursachen könnten.
Navigieren Sie zu: PAYONE → Transaktionen
Hier finden Sie eine Übersicht über alle über PAYONE verarbeiteten Transaktionen. Durch Klicken auf "Anzeigen" können Sie Details der entsprechenden Transaktion anzeigen. Sie haben auch die Möglichkeit, beispielsweise nach Zahlungsart, Status oder Betrag zu filtern.
Navigieren Sie zu: PAYONE → Logs
Unter dem Menüpunkt Logs finden Sie alle Informationen über verarbeitete Zahlungen und die Kommunikation mit der PAYONE-Plattform.
Navigieren Sie zu: PAYONE → Logs → Transaktionsstatus
Der Untermenüpunkt Transaktionen zeigt die von Magento empfangenen Transaktionsstatus-Benachrichtigungen für jede Bestellung und Transaktion an. Diese Benachrichtigungen werden von der PAYONE-Plattform an Ihren Shop gesendet. Bei Fehlern können Sie hier herausfinden, ob der Transaktionsstatus korrekt empfangen wurde und wie der aktuelle Status für eine Transaktion ist. Durch Klicken auf "Anzeigen" können Sie Details zu einem Transaktionsstatus anzeigen.
Auf der Detailseite sehen Sie alle Transaktionsstatus-Informationen, die über die PAYONE-Plattform an Ihren Shop übertragen wurden. So können Sie immer nachverfolgen, welche Daten Ihr Magento-Shop erhalten und verarbeitet hat.
Eine detaillierte Erklärung der jeweiligen Parameter finden Sie in der technischen Dokumentation der PAYONE-Plattform im PAYONE Merchant Interface (PMI) unter Downloads → Dokumentation.
Navigieren Sie zu: PAYONE → Logs → API
In dieser Übersicht finden Sie alle Anfragen vom Magento-Shop an die PAYONE-Plattform sowie die Antworten der PAYONE-Plattform auf diese Anfragen. Nur die Anfragen, die über die Client-API an die PAYONE-Plattform übertragen wurden, sind in dieser Übersicht nicht aufgeführt. Dies gilt für Kreditkarteninformationen, die direkt vom Browser des Käufers mit Ajax-Technologie an die PAYONE-Plattform übertragen werden, damit Ihr Shop nicht mit sensiblen Kreditkarteninformationen in Berührung kommt. Durch Klicken auf "Anzeigen" können Sie eine API-Anfrage im Detail anzeigen.
In der linken Spalte sehen Sie die Anfrage, die der Magento-Shop an die PAYONE-Plattform gesendet hat. Rechts finden Sie die Antwort. Eine detaillierte Erklärung der jeweiligen Parameter finden Sie in der technischen Dokumentation der PAYONE-Plattform im PAYONE Merchant Interface (PMI) unter Downloads → Dokumentation.