Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Text Box
typewarning

Magento 1 hat seine End-of-Life-Phase erreicht!

Wir werden unser Magento 1 Plugin vorerst weiter unterstützen.

Die Verwendung veralteter Software stellt jedoch ein potenzielles Sicherheitsrisiko für Ihre Daten und die Ihrer Kunden dar. PCI DSS verlangt von Händlern sogar, dass sie ihre Shops auf dem neuesten Stand halten. Wenn Sie planen, sowohl Magento 1 als auch Ihre PCI DSS-Konformität aufrechtzuerhalten, empfehlen wir Ihnen, sich mit Initiativen wie https://www.openmage.org/ oder https://mage-one.com/


UI Steps


UI Step

Voraussetzungen

Sie brauchen unbedingt einen aktiven PAYONE – Account. Wenn Sie noch keinen Account haben, kontaktieren Sie uns bitte.


UI Step

Installation des Plugins

Ihr Weg um das Plugin zu installieren:


UI Expand
titleInstallation via Github

Sie sind herzlich eingeladen, unser Plugin auf github herunterzuladen oder daran mitzuarbeiten.

Section


Column
width33%



Column
width33%

UI Button
colorgreen
newWindowtrue
sizelarge
displayblock
icondownload
titleDownload from Github
urlhttps://github.com/PAYONE-GmbH/magento-1/releases


Column
width33%






UI Step

Konfiguration im PAYONE - Portal

Um den Transaktionsstatus an die richtige Adresse zu senden, melden Sie sich bitte im PAYONE Merchant Interface (PMI) an.


Unter Konfiguration → Zahlungsportale → IHR_PORTAL → Erweitert → TransactionStatus URL tragen Sie bitte folgende URL ein:

UI Text Box
typeinfo
<SHOPURL>/index.php/payone_core/transactionStatus

Additional Response-data

Setzen Sie unter General, die Additional Response-data sowohl für Live als auch für Test auf "on".


UI Step

Konfiguration im Magento 1 - Admin

  • Klicken Sie unter PAYONE → Konfiguration → Allgemein und tragen Sie hier bitte Ihre Zugangsdaten, aus dem PMI, ein:

  • Hier können Sie weitere Einstellungen vornehmen

UI Expand
titledetaillierte Beschreibung der einzelnen Felder


Feld

Beschreibung

Merchant ID

Ihre PAYONE Merchant ID finden Sie oben rechts im PAYONE Merchant Interface (PMI) und auf allen PAYONE Rechnungen.

Portal ID

Die Portal-ID finden Sie im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Zahlungsportale

Sub-Account-ID

Die ID finden Sie im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Konten

Schlüssel

Bitte geben Sie hier den Schlüssel ein, der im entsprechenden PAYONE Zahlungsportal hinterlegt ist.
Zahlung aus zulässigen LändernAuswahlmöglichkeit für den Shop, in welchen Ländern die Zahlung über PAYONE ermöglicht werden soll.
Autorisierung
    • Vorauthorisierung Der zu zahlende Betrag wird reserviert. In diesem Fall muss die Abbuchung in einem zweiten Schritt beim Versand erfasst (Capture) werden. Die Forderung wird erst gebucht, wenn der Capture durchgeführt worden ist.
    • Authorisierung - Der zu zahlende Betrag wird sofort bei Auftragserteilung eingezogen. Die Forderung wird sofort auf der PAYONE Plattform verbucht.
Transfer IP Adresse

Wählen Sie aus, ob die IP-Adresse des Endkunden an die PAYONE Plattform übermittelt 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 Prüfung der IP-Adresse nicht möglich.

proxy mode

Aktivieren Sie diese Option, um die IP aus dem HTTP_X_FORWARDED_FOR-Header zu übernehmen. Dies ist nur notwendig, wenn Ihr Shop hinter einem Proxy-Server läuft.

WährungHier können Sie auswählen, ob die Anfragen in der gewählten Währung an die PAYONE Plattform gesendet werden, oder ob die Beträge vorher Magento-intern in eine Basiswährung umgerechnet werden sollen.




UI Step

Konfiguration der Zahlungsarten

  • Klicken Sie unter PAYONE → Konfiguration → Payment Methods

Überblick


In dieser Übersicht werden alle von PAYONE angelegten Zahlungsarten angezeigt. Über die Schaltflächen im oberen Bereich können Sie weitere Zahlungsarten hinzufügen und konfigurieren. Über den Link Bearbeiten können Sie jede einzelne Zahlungsart gezielt konfigurieren. Bitte beachten Sie, dass Sie nur die Zahlungsarten konfigurieren sollten, die Sie bei PAYONE bestellt haben.

Zahlungsarten hinzufügen/ konfigurieren

UI Expand
titledetaillierte Beschreibung der einzelnen Felder


Feld

Beschreibung

Aktiv

Aktivieren/ Deaktivieren Sie die gewünschten Zahlungsarten

Sortierreihenfolge

Geben Sie eine ganze Zahl ein, die festlegt, an welcher Stelle der Kaufabwicklung dem Kunden die Zahlungsmethode angeboten wird.

Name

Freitexteingabe für den Namen der Zahlungsmethode, wie er dem Kunden an der Kasse angezeigt wird.

Bearbeitungsgebühr

Festlegung einer Bearbeitungsgebühr pro Versandart und zugehörigen Ländern.

Minimalwert der Bestellung

Der Mindestwarenwert, ab dem die Zahlungsart dem Kunden in der Kasse angezeigt wird z.B. 100 = 100 EUR

Maximalwert der Bestellung

Der maximale Warenwert, bis zu dem die Zahlungsmethode dem Kunden in der Kasse angezeigt wird, z.B. 100 = 100 EUR

Modus

Hier wird festgelegt, ob die PAYONE Plattform im Test- oder Live-Modus angesprochen wird.

Nutze Globale Eigenstellungen

Wenn Nein gewählt wird, können alle Parameter aus den globalen Einstellungen individuell für diese Zahlungsmethode konfiguriert werden.


Spezielle Anpassungen

Einige Zahlungsarten benötigen spezielle Anpassungen. Die nächsten Punkte sind für Sie nur interessant, wenn Sie die jeweilige Zahlungsart nutzen:

UI Expand
titleKreditkarte

Feld

Beschreibung

Kreditkarten-Typ

Welche Kreditkartenmarken sollen im Frontend angeboten werden?

Kartenprüfnummer ausblenden

Verbirgt die Prüfnummer für Karten, die sie nicht anbieten

Kartenprüfnummer prüfen

  • Nein
  • Erste Bestellung mit der Karte
  • Immer

UI Text Box
typenote

Bestimmt, ob die Kreditkartenprüfnummer abgefragt wird. Dies ist nur möglich, wenn der Acquirer dies zulässt


Zahlungsdaten für registrierte Benutzer speichern

Hier können Sie festlegen, 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 eigentlichen Kreditkartendaten werden nur bei PAYONE gespeichert.



UI Expand
titlePAYONE Lastschrift



Feld

Beschreibung

Bankverbindung prüfen

Legt fest, ob eine zusätzliche Prüfung der Bankverbindung durchgeführt werden soll.

Art der Überprüfung der Bankverbindung

Wählen Sie Regelmäßige Prüfung / Prüfung gegen POS-Sperrliste. Legt fest, wie die Bankverbindung geprüft werden soll. Es besteht die Möglichkeit einer Prüfung gegen eine POS-Sperrliste mit Informationen zu offenen Forderungen aus dem stationären Einzelhandel. Die Prüfung wird von der Auskunftei KUNO durchgeführt.

Meldung, wenn Bankdaten gesperrt sind

Diese Meldung wird an der Kasse angezeigt, wenn die Prüfung der Bankverbindung ein negatives Ergebnis liefert.

Liste der unterstützten Kontolä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

Wenn Sie Ja wählen, werden zusätzlich zu den Eingabefeldern für IBAN und BIC die Felder für Kontonummer und Bankleitzahl angezeigt. Der Endkunde muss nur eine der beiden Kombinationen angeben. Die Eingabe von Kontonummer und Bankleitzahl ist nur bei deutschen Bankkonten möglich.

Zahlungsdaten für registrierte Benutzer speichern

Hier können Sie festlegen, ob die 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.

Aktivieren Sie die Mandatserteilung

Soll der SEPA-Mandatsmanager verwendet werden? Eine Prüfung der Bankverbindung ist obligatorisch. Eine Prüfung gegen die POS-Sperrliste ist nicht möglich.

Mandat als PDF herunterladen

Wenn Sie Ja wählen, wird nach der Bestellung ein Link angeboten, über den der Endkunde das SEPA-Mandat als PDF-Datei herunterladen kann.

UI Text Box
typenote

Dieses Produkt muss separat bestellt werden.




UI Expand
titlePayPal

Feld

Beschreibung

PayPal Express Checkout-Verknüpfung im Einkaufswagen

Aktiviert die PayPal ECS-Schaltfläche im Einkaufswagen für den Checkout.

Paypal Express Logo Button

Hier können Sie das entsprechende Logo für die StoreView hochladen.


UI Text Box
typeinfo

Um PayPal ECS korrekt nutzen zu können, muss das im Magento-Standard enthaltene Modul für PayPal aktiviert sein.



UI Expand
titleAmazon Pay

Integrationseinstellungen in Seller Central

Bitte tragen Sie im Punkt "Integrationseinstellungen" in Seller Central unter Integrator-URL folgende URL ein: https://gpc-sys.pay1.de/gpc/amazon/1.0/notify - die "Seller URL" kann leer bleiben. Diese URL stellt sicher, dass der Shop alle Benachrichtigungen von Amazon erhält.

Bitte stellen Sie auch sicher, dass Sie alle URLs Ihres Shops als erlaubte Javascript Origin in Seller Central speichern.

  1. Wählen Sie auf der Seller Central-Startseite in der Navigationsleiste oben links "Integration - Integration Central".
  2. Scrollen Sie auf der Seite "Integration Central" nach unten zum Abschnitt "Kunden-ID/Shop-ID(s) verwalten" und klicken Sie auf "Kunden-ID/Shop-ID(s) anzeigen".
  3. Wenn Sie eine bestehende Kunden- oder Shop-ID registriert haben, überprüfen Sie die Konfiguration des ausgewählten Shops. Sie können auf den Link "Bearbeiten" auf der rechten Seite klicken, um die Informationen zu bearbeiten.
  4. Wenn Sie auf die Schaltfläche "Bearbeiten" klicken, können Sie alle Details der Kundenkonfiguration bearbeiten.
  5. Wenn Sie ab Schritt 3 auf den Link "Neue Konfiguration erstellen" oben klicken, können Sie eine neue Kundenkonfiguration erstellen und alle relevanten Informationen angeben.

Abrufen der Konfiguration im Magento-Backend

Um die Zahlungsmethode zu aktivieren, verwenden Sie bitte den Button "get configuration". Dies ruft Ihre Kunden-ID und Verkäufer-ID von unserer Plattform ab. Sie sollten dann die Werte in den entsprechenden Feldern sehen.

Aktivieren Sie die Zahlungsmethode

Bitte beachten Sie, dass Sie nur dann Live-Zahlungen vornehmen können, wenn die Zahlungsmethode für Live-Zahlungen in Seller Central zugelassen ist.

FieldDescription

Client ID & Seller ID

Diese Felder enthalten die Kunden-ID und die Verkäufer-ID, wie sie vom Merchant Service nach Abschluss der Konfiguration auf der PAYONE Plattform gespeichert werden.


UI Text Box
typewarning

Sie müssen zunächst alle anderen Einstellungen vornehmen und die Zahlungsmethode Amazon Pay einmalig speichern, bevor Sie diese Werte über die Schaltfläche "Get Configuration" abrufen können!


JavaScript Origin & Return URL

Die URLs in diesen Feldern sind zu Ihrer Information. Sie müssen in der Amazon Seller Central hinterlegt sein, sonst lehnt Amazon die Login-Anfragen ab.

Button Type, Color, Language

Hier können Sie die Art des Buttons, die Farbe und die Sprache für den Amazon Pay Button auswählen. Die empfohlenen Einstellungen sind bereits als Standard ausgewählt.

Amazon mode

Amazon Pay unterstützt zwei grundlegende Betriebsmodus:

  • Synchron: Es wird versucht, eine direkte (synchrone) Bestätigung für die Amazon Pay-Zahlungsanfrage zu erhalten. Es kann sein, dass Amazon Pay eine Zahlungsanforderung ablehnt, weil eine längere Prüfung notwendig wäre.
  • Asynchron: Amazon Pay prüft die Zahlung über einen längeren Zeitraum. Die Zahlung wird später angenommen oder abgelehnt (asynchron). 

Im PAYONE Plugin für Magento ergeben sich daraus zwei Betriebsmodus:

  • Immer synchron: Es wird immer versucht, eine synchrone Bestätigung für die Amazon Pay-Zahlungsanfrage zu erhalten. Eine asynchrone Zahlungsanforderung findet nicht statt.
  • Asynchron bei Fehler: Es wird zunächst eine synchrone Zahlungsanforderung versucht. Wird diese von Amazon Pay abgelehnt, wird eine asynchrone Zahlungsanforderung versucht, die eine höhere Erfolgschance hat. Nur wenn auch diese abgelehnt wurde, wird der Käufer entsprechend zurückgeschickt.


UI Text Box
typenote

In manchen Fällen kann es zu einer Interferenz zwischen unserem Plugin und dem Amazon-Plugin im Magento Core kommen. Wenn Sie also ein "seltsames Verhalten" feststellen, wie z.B. das Verschwinden von Amazon-Buttons, können Sie den folgenden Befehl im Magento-Root auszuführen:

Code Block
languagebash
php bin/magento module:disable Amazon_Payment




UI Expand
titleKlarna

Feld

Beschreibung

Klarna Store IDs

Für die Klarna-Zahlungsmethode müssen bestimmte Shop-IDs konfiguriert werden. Diese Shop-IDs erhalten Sie von Klarna.

UI Text Box
typenote

Die Zahlungsabwicklung über Klarna ist nur möglich, wenn Rechnungsadresse und Lieferadresse übereinstimmen.




UI Expand
titleRatepay

Feld

Beschreibung

Detaillierte Fehlermeldungen anzeigen

Hier können Sie auswählen, ob im Falle einer Ablehnung die von RatePay übermittelte 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.

Typ

Mehrfachauswahl. Hier können Sie auswählen, welche von Ratepay angebotenen Zahlungsmethoden verfügbar sein sollen.

RatePay Shop IDs

RatePay verlangt die Übermittlung einer sogenannten Shop-ID, die die Parameter des Shops identifiziert. Tragen Sie die von RatePay erhaltenen Shop-IDs und die entsprechende Währung im ISO 4217 Format (z.B. EUR, USD, DKK) ein. Beim Speichern der Konfiguration werden die Parameter bei RatePay abgefragt und in die Konfiguration übernommen.

Device Fingerprint Snippet ID

Wenn Sie von Ratepay eine benutzerdefinierte Geräte-Fingerprint-Snippet-ID erhalten haben, können Sie diese unter PAYONE → Konfiguration → Allgemein (unten auf der Seite) konfigurieren. Der Standardwert ist "ratepay".

RatePay Goodwill-Erstattungen

Wenn Sie Anpassungserstattungen mit RatePay-Transaktionen verwenden, stellen Sie bitte sicher, dass die Menge aller Artikel auf 0 gesetzt wird, um die allgemeine Erstattung erfolgreich auszulösen.


UI Expand
titleBarzahlen

Um die Zahlungsmethode zu aktivieren, empfehlen wir Ihnen, die Anzeige unter: https://integration.barzahlen.de/de/designanforderungen
Beispiel:

Code Block
languagexml
titleSample Code
linenumberstrue
<label for="payment_barzahlen">
  <img style="height: 3em; vertical-align: -1em;" src="https://cdn.barzahlen.de/images/barzahlen_logo.png" alt="Barzahlen">
</label>
<img style="float: right; margin-left: 10px; max-width: 180px; max-height: 180px;" src="https://cdn.barzahlen.de/images/barzahlen_special.png">
Mit Abschluss der Bestellung bekommen Sie einen Zahlschein angezeigt, den Sie sich ausdrucken oder auf Ihr Handy schicken lassen können. Bezahlen Sie den Online-Einkauf mit Hilfe des Zahlscheins an der Kasse einer Barzahlen-Partnerfiliale.<br/><br/>
<strong>Bezahlen Sie bei:</strong>
 
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_01.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_02.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_03.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_04.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_05.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_06.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_07.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_08.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_09.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_10.png" style="height: 1em; vertical-align: -0.1em;">



UI Expand
titlePaysafe Pay Later

Feld

Beschreibung

Firmenname

Hier muss der vollständige Name des Unternehmens angegeben werden. Der Name wird in der Datenschutzrichtlinie verwendet.

Ratenkauf Beispiel Benutzername

Um den Ratenkauf-Vertragsentwurf abrufen zu können, muss hier der von Paysafe vergebene Benutzername (in der Regel Händlername Installation) hinterlegt werden.

Ratenkauf Beispielpasswort

Hier muss das von Paysafe vergebene Passwort hinterlegt werden, um den Ratenkauf-Vertragsentwurf abrufen zu können.

B2B Mode

Ist der B2B-Modus aktiviert, wird automatisch angenommen, dass es sich um eine B2B-Transaktion handelt, wenn bei der Adresseingabe das Feld "Firma" ausgefüllt wurde. Um die Bonität des Unternehmens zu prüfen, werden dann im Checkout weitere Informationen wie die Handelsregisternummer abgefragt.

Typ

Hier können Sie auswählen, welche Zahlungsarten von Paysafe dem Käufer zur Verfügung stehen sollen. Sie können zwischen Kauf auf Rechnung, Ratenzahlung und Lastschrift wählen.




UI Step

Bearbeiten der Bestellungen

  • Klicken Sie unter PAYONE → Bestellungen

Überblick

Hier finden Sie eine PAYONE-spezifische Bestellübersicht ähnlich der Magento-Bestellübersicht. Neben den Standardinformationen können Sie hier den Zahlungsstatus auf der PAYONE Plattform, die genaue Art der Zahlung (z.B. Kreditkartenmarken) und ggf. den Mahnstatus einsehen. Ein Klick auf Ansicht öffnet die Detailansicht der entsprechenden Bestellung.


Erfassung/ Capture

Vorautorisierte Transaktionen müssen erfasst werden, um den eigentlichen Geldfluss auszulösen. Das PAYONE Plugin übernimmt diesen Schritt bei der Erstellung der Rechnung für eine bestimmte Bestellung.

Durch die Auswahl von "Online erfassen" in der oben gezeigten Dropdown-Liste wird die Forderung auf der PAYONE Plattform eingezogen. Wenn Sie das Geld nicht erfassen, aber dennoch eine Rechnung und eine Forderung erstellen möchten, verwenden Sie bitte stattdessen "Offline erfassen".

Auch Teilerfassungen sind möglich, indem man einfach die fakturierbare Menge der Posten anpasst.

Rückerstattung/ Refund

Bereits erfasste Gelder können durch Erstellen einer Gutschrift für eine bestehende Rechnung zurückerstattet werden.

UI Text Box
typeinfo

Bitte achten Sie darauf, dass Sie eine Gutschrift innerhalb eines Rechnungsobjektes anlegen, nicht im Auftrag!

Mit Klick auf die Schaltfläche "Refund", wird das Geld an die Zahlungsmethode des Kunden zurückgeschickt. "Refund Offline" erstellt die Gutschrift, löst aber keinen Geldfluss aus.

Teilerstattungen sind nach der gleichen Methode wie bei Teilerfassungen möglich. Sie können auch die Summe der Rückerstattung anpassen, um die Gebühren während der Rückerstattung zu berücksichtigen. Bedenken Sie, dass einige Zahlungsarten darauf angewiesen sind, dass die Artikel im Warenkorb mit der ursprünglichen Bestellung übereinstimmen.


UI Step

Erweiterte Konfigurationen

Hier finden Sie separate Einstellungsmöglichkeiten, mit den Sie unser Plugin genauer an Ihre Bedürfnisse anpassen können:

UI Expand
titleRechnungsinformationen senden

Klicken Sie unter PAYONE → Allgemein → Send invoicing information um die Übermittlung von Artikeldaten zur Erstellung einer Rechnung auf der PAYONE Plattform aktivieren.

Der Text kann frei gewählt werden und erscheint als dynamischer Text auf der Rechnung oder Gutschrift. Als Platzhalter können verschiedene Magento-Variablen verwendet werden.


UI Expand
titleStatus Mapping

Klicken Sie unter PAYONE → Allgemein → Status Mapping können die verschiedenen Transaktionsstatus der PAYONE-Plattform auf Magento-Bestellstatus abgebildet werden. Geht ein neuer Transaktionsstatus ein, wird der entsprechende "Magento-Status" in der Bestellübersicht im Magento-Backend gesetzt. Dieser kann für jede Zahlungsart separat eingegeben werden.

UI Text Box
typenote

Wenn Sie den Status "bestellt" auf "Zahlungsprüfung" setzen, werden die PDF-Rechnungen nicht automatisch erstellt. Hier sollte ein anderer Status gewählt werden.



UI Expand
titleBenutzerdefinierte Anpassung hosted-Iframe

Die Magento 1 Extension bietet Ihnen die Konformität mit dem "niedrigsten" Compliance Level nach PCI DSS (SAQ A). Da in diesem Compliance Level alle Kreditkartendaten nur in Felder eingegeben werden dürfen, die von einem PCI DSS zertifizierten Dienstleister gehostet werden, verwendet unsere Extension iFrames, die in den Checkout integriert werden. Diese erben jedoch nicht das CSS des Shop-Templates, sondern enthalten einen eigenen Stil. Sie können die folgenden Einstellungen verwenden, um diese Felder anzupassen.

Feld

Beschreibung

Minimale Gültigkeitsdauer

Geben Sie eine ganze Zahl in Tagen ein. Dieser Wert gibt die Anzahl der Tage an, bis zu der eine Kreditkarte gültig sein muss, bevor sie an der Kasse abgelehnt wird.

Anfragetyp

  • hosted-iFrame
  • AJAX
UI Text Box
typewarning

Stellen Sie sicher, dass Sie immer "hosted iFrame" verwenden. Nur Händler mit einer PCI DSS-Zertifizierungsstufe von SAQ A-EP oder höher dürfen AJAX verwenden. Wir empfehlen nach wie vor die Verwendung von gehostetem iFrame!


Feld Konfiguration

Hier können Sie separate Parameter für die einzelnen Felder der Kreditkartenabfrage einstellen.

Typ

  • Numerisch - Es sind nur Zahlen erlaubt und für mobile Geräte wird die numerische Tastatur verwendet input type="tel".
  • Passwort - input type="password"
  • Text - input type="text"

Anzahl Zeichen

Länge des Feldes in Zeichen (HTML attribute size)

Zeichen Max

Maximale Länge der Eingabe (HTML attribute maxlength)

iFrame

  • Standard - Verwendet Breite und Höhe vom Standardstils
  • Benutzerdefiniert - Verwendet Breite und Höhe aus den folgenden Feldern

Breite

CSS - Spezifiziert width

Höhe

CSS - Indikator height

Stil

  • Standard - Nutzt CSS Spezifikation vom Standard
  • Benutzerdefiniert - Nutzt CSS Spezifikation von den folgenden Feldern

CSS

Spezifikation von CSS properties für das Feld
Deaktiviert mit der Vorauswahl des Standard

Standardstil

Felder

  • Eingabe - CSS Spezifikation für alle Eingabefelder (HTML input)
  • Auswahl - CSS Spezifikation für alle Auswahlfelder (HTML select )

iFrame

  • Width - CSS Spezifikation
  • Height - CSS Spezifikation

Error-output

 

Sprache

Wählen Sie die Sprache, in der die Fehlermeldung ausgegeben werden soll.

Aktivieren Sie die automatische Erkennung der Kreditkartennummer

Bestimmt, ob die Kartennummer bei der Eingabe der ersten sechs Ziffern automatisch ermittelt werden soll.

Vorschau

An dieser Stelle sehen Sie, wie das Erscheinungsbild entsprechend der vorherigen Einstellung der Zahlungsart Kreditkarte im Checkout aussieht.


UI Expand
titleSimple Protect

Simple Protect

Simple Protect ist die einfache und flexible Art, alle Daten zu nutzen, die Sie haben, und zwar genau in dem Moment, in dem Ihr Shop den Checkout durchführt. Sie können z.B. Informationen von:

  • die Datenbank Ihres Magento 2 Shops
  • die aktuelle Checkout-Sitzung
  • externe Quellen, die vom Shopserver aus erreicht werden können
    • Datawarehouse
    • csv / xml / txt - Dateien, auf die mit PHP zugegriffen werden kann
    • APIs oder Erweiterungen wie die PAYONE Protect Funktionen
  • und viele mehr.

Im Folgenden finden Sie ein Beispiel für einige komplexe Entscheidungen, die mit Hilfe unseres simple protect framework getroffen werden können:


UI Text Box

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-Zweig herunterladen:

Githubdownload
Repohttps://github.com/PAYONE-GmbH/magento-2/tree/simple-protect
TooltipSimple Protect Framework

Danach folgen Sie bitte den Anweisungen zur Installation der Simple Protect-Vorlage hier:

Githubdownload
Repohttps://github.com/PAYONE-GmbH/magento-2-simple-protect
TooltipSimple Protect Template


UI Text Box
typewarning

Bitte beachten Sie, dass alle im Legacy-Teil dieser Dokumentation beschriebenen Funktionen bei der Verwendung von simple protect nicht mehr zur Verfügung stehen. Zur Zeit bieten wir auch keinen Migrationsmechanismus an.

Entry points / Points of action

Die Klasse app/code/Payone/SimpleProtect/Model/SimpleProtect/SimpleProtect.php ist der zentrale Punkt zur Umsetzung der Entscheidungen.

Die folgenden Methoden geben die Punkte wieder, an denen die Aktionen stattfinden.

Code Block
languagephp
titleExample of full implementation
linenumberstrue
collapsetrue
<?php

/**
 * PAYONE Magento 2 Connector is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * PAYONE Magento 2 Connector is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with PAYONE Magento 2 Connector. If not, see <http://www.gnu.org/licenses/>.
 *
 * PHP version 5
 *
 * @category  Payone
 * @package   Payone_Magento2_SimpleProtect
 * @author    FATCHIP GmbH <support@fatchip.de>
 * @copyright 2003 - 2019 Payone GmbH
 * @license   <http://www.gnu.org/licenses/> GNU Lesser General Public License
 * @link      http://www.payone.de
 */

namespace Payone\SimpleProtect\Model\SimpleProtect;

use Magento\Payment\Model\MethodInterface;
use Magento\Quote\Model\Quote;
use Payone\Core\Model\SimpleProtect\SimpleProtect as OrigSimpleProtect;
use Payone\Core\Model\PayoneConfig;
use Magento\Customer\Api\Data\CustomerInterface;
use Magento\Quote\Model\Quote\Address;
use Payone\Core\Model\Source\AddressCheckType;
use Payone\Core\Model\Source\CreditratingCheckType;
use Magento\Framework\Exception\LocalizedException;
use Payone\Core\Model\Exception\FilterMethodListException;
use Payone\Core\Model\Api\Response\AddresscheckResponse;
use Payone\Core\Model\Api\Response\ConsumerscoreResponse;
use Magento\Quote\Api\Data\AddressInterface;
use Magento\Store\Model\ScopeInterface;

class SimpleProtect extends OrigSimpleProtect
{
    const MODULE_VERSION = '1.0.0';

    /**
     * Whitelist of safe payment methods
     *
     * @var array
     */
    protected $safePaymentMethods = [
        PayoneConfig::METHOD_ADVANCE_PAYMENT,
        PayoneConfig::METHOD_CREDITCARD,
        PayoneConfig::METHOD_PAYPAL
    ];

    /**
     * PAYONE Protect model providing access to consumerscore and addresscheck requests
     *
     * @var \Payone\Core\Model\SimpleProtect\ProtectFunnel
     */
    protected $protectFunnel;

    /**
     * Database connection resource
     *
     * @var \Magento\Framework\App\ResourceConnection
     */
    protected $databaseResource;

    /**
     * Checkout session object
     *
     * @var \Magento\Checkout\Model\Session\Proxy
     */
    protected $checkoutSession;

    /**
     * Scope config object
     *
     * @var \Magento\Framework\App\Config\ScopeConfigInterface
     */
    protected $scopeConfig;

    /**
     * Constructor
     *
     * @param \Payone\Core\Model\SimpleProtect\ProtectFunnel     $protectFunnel
     * @param \Magento\Framework\App\ResourceConnection          $resource
     * @param \Magento\Checkout\Model\Session\Proxy              $checkoutSession
     * @param \Magento\Framework\App\Config\ScopeConfigInterface $scopeConfig
     */
    public function __construct(
        \Payone\Core\Model\SimpleProtect\ProtectFunnel $protectFunnel,
        \Magento\Framework\App\ResourceConnection $resource,
        \Magento\Checkout\Model\Session\Proxy $checkoutSession,
        \Magento\Framework\App\Config\ScopeConfigInterface $scopeConfig
    ) {
        parent::__construct($protectFunnel);
        $this->databaseResource = $resource;
        $this->checkoutSession = $checkoutSession;
        $this->scopeConfig = $scopeConfig;
    }

    /**
     * Returns configured operation mode used for the addresscheck and consumerscore
     *
     * @return string
     */
    public function getOperationMode()
    {
        return $this->scopeConfig->getValue('payone_general/global/protect_mode', ScopeInterface::SCOPE_STORES);
    }

    /**
     * Get count of customers orders
     *
     * @param CustomerInterface $oCustomer
     * @return int
     */
    protected function getCustomersOrderCount(CustomerInterface $oCustomer)
    {
        $db = $this->databaseResource->getConnection();
        $oSelect = $db->select()
            ->from($this->databaseResource->getTableName('sales_order'), ['COUNT(entity_id)'])
            ->where("customer_id = :customerId");
        $iCount = $db->fetchOne($oSelect, ['customerId' => $oCustomer->getId()]);
        if ($iCount === null) {
            return 0;
        }
        return $iCount;
    }

    /**
     * Check if the customer has ordered before
     *
     * @param CustomerInterface $oCustomer
     * @return bool
     */
    protected function isRecurringCustomer(CustomerInterface $oCustomer)
    {
        if ($this->getCustomersOrderCount($oCustomer) == 0) {
            return false;
        }
        return true;
    }

    /**
     * Possibility to whiteliste customers with custom functionality
     *
     * @param  CustomerInterface $oCustomer
     * @return bool
     */
    protected function isCustomerWhitelisted(CustomerInterface $oCustomer)
    {
        return true; // implement this for yourself or remove completely
    }

    /**
     * Generate hash of given address for comparison
     *
     * @param  Address $oAddress
     * @return string
     */
    protected function getAddressHash(Address $oAddress) {
        $sAddress  = $oAddress->getFirstname();
        $sAddress .= $oAddress->getLastname();
        $sAddress .= $oAddress->getCity();
        $sAddress .= $oAddress->getPostcode();
        $sAddress .= $oAddress->getCountry();
        $sAddress .= $oAddress->getStreetFull();

        return md5($sAddress);
    }

    /**
     * Compare given addresses, return true if they are the same
     *
     * @param  Address $oBilling
     * @param  Address $oShipping
     * @return bool
     */
    protected function isBillingAndShippingAddressTheSame(Address $oBilling, Address $oShipping)
    {
        if ($this->getAddressHash($oBilling) != $this->getAddressHash($oShipping)) {
            return false;
        }
        return true;
    }

    /**
     * Filter out all payment methods except for the safe payment methods
     *
     * @param  MethodInterface[] $aPaymentMethods
     * @return MethodInterface[]
     */
    protected function getSafePaymentMethods($aPaymentMethods)
    {
        $aReturn = [];
        foreach ($aPaymentMethods as $oPaymentMethod) {
            if (in_array($oPaymentMethod->getCode(), $this->safePaymentMethods) === true) {
                $aReturn[] = $oPaymentMethod;
            }
        }
        return $aReturn;
    }

    /**
     * Examples of all the options for addresscheck usage
     *
     * @param  Quote $oQuote
     * @return AddresscheckResponse|bool
     */
    protected function executeAddresscheck(Quote $oQuote)
    {
        $oAddress = $oQuote->getBillingAddress();
        #$oAddress = $oQuote->getShippingAddress();

        #$sAddresscheckType = AddressCheckType::NONE;
        $sAddresscheckType = AddressCheckType::BASIC;
        #$sAddresscheckType = AddressCheckType::PERSON;
        #$sAddresscheckType = AddressCheckType::BONIVERSUM_BASIC;
        #$sAddresscheckType = AddressCheckType::BONIVERSUM_PERSON;

        return $this->protectFunnel->executeAddresscheck($oAddress, $this->getOperationMode(), $sAddresscheckType, $this->getModuleVersion());
    }

    /**
     * Examples of all the options for consumerscore usage
     *
     * @param  Quote $oQuote
     * @return ConsumerscoreResponse|bool
     */
    protected function executeConsumerscore(Quote $oQuote)
    {
        $oAddress = $oQuote->getBillingAddress();
        #$oAddress = $oQuote->getShippingAddress();

        #$sConsumerscoreType = CreditratingCheckType::INFOSCORE_HARD;
        $sConsumerscoreType = CreditratingCheckType::INFOSCORE_ALL;
        #$sConsumerscoreType = CreditratingCheckType::INFOSCORE_ALL_BONI;
        #$sConsumerscoreType = CreditratingCheckType::BONIVERSUM_VERITA;

        $sAddresscheckType = AddressCheckType::NONE;
        #$sAddresscheckType = AddressCheckType::BASIC;
        #$sAddresscheckType = AddressCheckType::PERSON;
        #$sAddresscheckType = AddressCheckType::BONIVERSUM_BASIC;
        #$sAddresscheckType = AddressCheckType::BONIVERSUM_PERSON;

        return $this->protectFunnel->executeConsumerscore($oAddress, $this->getOperationMode(), $sConsumerscoreType, $sAddresscheckType, $this->getModuleVersion());
    }

    /**
     * Check rules for recurring registered customers
     *
     * @param  Quote $oQuote
     * @return bool
     */
    protected function isOnlySafePaymentApplicableForRecurringCustomer(Quote $oQuote)
    {
        if ($oQuote->getBaseGrandTotal() > 400 || $this->isCustomerWhitelisted($oQuote->getCustomer()) === false) {
            return true;
        }
        return false;
    }

    /**
     * Check rules for first time registered customer
     *
     * @param  Quote $oQuote
     * @param  bool  $blIsPrePaymentSelection
     * @return bool
     */
    protected function isOnlySafePaymentApplicableForInitialOrder(Quote $oQuote, $blIsPrePaymentSelection)
    {
        if ($blIsPrePaymentSelection === false && $this->isBillingAndShippingAddressTheSame($oQuote->getBillingAddress(), $oQuote->getShippingAddress()) === false) {
            return true;
        }

        if ($oQuote->getBaseGrandTotal() > 120) {
            return true;
        }

        if ($blIsPrePaymentSelection === false && !in_array($oQuote->getPayment()->getMethodInstance()->getCode(), $this->safePaymentMethods)) {
            $oResponse = $this->executeConsumerscore($oQuote);
            if ($oResponse instanceof ConsumerscoreResponse && ($oResponse->getStatus() != 'VALID' || $oResponse->getScore() != 'G')) {
                return true;
            }
        }
        return false;
    }

    /**
     * Check if only safe payment methods are applicable
     *
     * @param  Quote $oQuote
     * @param  bool  $blIsPrePaymentSelection
     * @return bool
     */
    protected function isOnlySafePaymentApplicable(Quote $oQuote, $blIsPrePaymentSelection)
    {
        if ($this->checkoutSession->getPayoneSimpleProtectOnlySafePaymentsAllowed() === true) {
            return true;
        }

        if ($oQuote->getCustomerId() === null) { // if guest checkout
            return true;
        }

        if ($this->isRecurringCustomer($oQuote->getCustomer()) === true) {
            return $this->isOnlySafePaymentApplicableForRecurringCustomer($oQuote);
        }
        return $this->isOnlySafePaymentApplicableForInitialOrder($oQuote, $blIsPrePaymentSelection);
    }

    /************************* MAIN SIMPLEPROTECT HOOKS *************************/

    /**
     * This method can be extended for individual custom behaviour
     *
     * Extending this method gives the following possibilities:
     * 1. Filtering out payment methods based on your own rule set
     * 2. Throwing a LocalizedException to send the user back to shipping method selection
     *
     * @param  Quote             $oQuote
     * @param  MethodInterface[] $aPaymentMethods
     * @return MethodInterface[]
     */
    public function handlePrePaymentSelection(Quote $oQuote, $aPaymentMethods)
    {
        if ($this->isOnlySafePaymentApplicable($oQuote, true) === true) {
            return $this->getSafePaymentMethods($aPaymentMethods);
        }
        return $aPaymentMethods;
    }

    /**
     * This method can be extended for individual custom behaviour
     *
     * Extending this method gives the following possibilities:
     * 1. Throwing a LocalizedException will stop the order creation and throw the user back to payment selection with the given thrown message
     * 2. Throwing a FilterMethodListException with an array of safe payment methods will stop the order creation and
     *    throw the user back to payment selection with the given thrown message and remove all other payment methods except for the given ones
     * 3. Finishing the method - so throwing no Exception will finish the order creation
     *
     * @param  Quote $oQuote
     * @return void
     * @throws LocalizedException
     * @throws FilterMethodListException
     */
    public function handlePostPaymentSelection(Quote $oQuote)
    {
        if ($this->isOnlySafePaymentApplicable($oQuote, false) === true) {
            $sMethodCode = $oQuote->getPayment()->getMethodInstance()->getCode();
            if (!in_array($sMethodCode, $this->safePaymentMethods)) {
                $this->checkoutSession->setPayoneSimpleProtectOnlySafePaymentsAllowed(true);
                throw new FilterMethodListException(__('Please select another payment method.'), $this->safePaymentMethods);
            }
        }
    }

    /**
     * This method can be extended to transfer the version of your Simple-Protect implementation to Payone
     * It is recommended to transfer the name of your module and the version, otherwise Payone doesn't know that it is a Simple-Protect call
     *
     * @return string|null
     */
    public function getModuleVersion()
    {
        return 'Payone_SimpleProtect-'.self::MODULE_VERSION;
    }
}


UI Text Box
typetip

Wir haben weitere Beispiele unter Magento 2 - Simple Protect zusammengestellt. Hier finden Sie weitere Informationen darüber, wie Sie Daten für Ihre Entscheidungen gewinnen können. Sie sind auch eingeladen, weitere Beispiele als Themen auf Github oder per E-Mail an docs@payone.com hinzuzufügen.

handlePrePaymentSelection

Die Umsetzung dieser Methode bietet Ihnen folgende Möglichkeiten:

  1. Das Auslösen einer LocalizedException stoppt die Auftragserstellung und wirft den Benutzer mit der angegebenen Meldung zurück zur Zahlungsauswahl
  2. Das Auslösen einer FilterMethodListException mit einem Array von sicheren Zahlungsmethoden stoppt die Auftragserstellung und wirft den Benutzer mit der angegebenen Meldung zurück zur Zahlungsauswahl und entfernt alle anderen Zahlungsmethoden außer den angegebenen
  3. Beenden der Methode - also keine Exception auslösen, beendet die Auftragserstellung

Code Block
languagephp
linenumberstrue
@param  Quote $oQuote
@param  MethodInterface[] $aPaymentMethods
@return MethodInterface[]

public function handlePrePaymentSelection(Quote $oQuote, $aPaymentMethods)
{
    if ($this->isOnlySafePaymentApplicable($oQuote, true) === true) {
        return $this->getSafePaymentMethods($aPaymentMethods);
    }
    return $aPaymentMethods;
}

handlePostPaymentSelection

Die Umsetzung dieser Methode bietet Ihnen folgende Möglichkeiten:

  1. Das Auslösen einer LocalizedException stoppt die Auftragserstellung und wirft den Benutzer mit der angegebenen Meldung zurück zur Zahlungsauswahl
  2. Das Auslösen einer FilterMethodListException mit einem Array von sicheren Zahlungsmethoden stoppt die Auftragserstellung und wirft den Benutzer mit der angegebenen Meldung zurück zur Zahlungsauswahl und entfernt alle anderen Zahlungsmethoden außer den angegebenen
  3. Beenden der Methode - also keine Exception auslösen, beendet die Auftragserstellung

Code Block
languagephp
linenumberstrue
@param  Quote $oQuote
@return void
@throws LocalizedException
@throws FilterMethodListException

public function handlePostPaymentSelection(Quote $oQuote)
{
    if ($this->isOnlySafePaymentApplicable($oQuote, false) === true) {
        $sMethodCode = $oQuote->getPayment()->getMethodInstance()->getCode();
        if (!in_array($sMethodCode, $this->safePaymentMethods)) {
            $this->checkoutSession->setPayoneSimpleProtectOnlySafePaymentsAllowed(true);
            throw new FilterMethodListException(__('Please select another payment method.'), $this->safePaymentMethods);
        }
    }
}

handleEnterOrChangeBillingAddress

Die Umsetzung dieser Methode bietet Ihnen folgende Möglichkeiten:

  1. Wenn true zurückgegeben wird, wird der Prozess fortgesetzt, ohne dass etwas geändert wird.
  2. Die Rückgabe einer (geänderten) Adressobjektinstanz von AddressInterface zeigt dem Kunden eine Aufforderung zur Adresskorrektur
  3. Das Auslösen einer LocalizedException zeigt dem Kunden die angegebene Ausnahmemeldung an
Code Block
languagephp
linenumberstrue
@param AddressInterface $oAddressData
@param bool $blIsVirtual
@param double $dTotal
@return AddressInterface|bool
@throws LocalizedException

public function handleEnterOrChangeBillingAddress(AddressInterface $oAddressData, $blIsVirtual, $dTotal)
    {
        $response = $this->protectFunnel->executeAddresscheck($oAddressData, $this->getOperationMode(), AddressCheckType::BASIC);
        if ($oAddressData->getCity() == "FalscheStadt") {
            $oAddressData->setCity($response->getCity());
            return $oAddressData;
        }
        return true;
    }

handleEnterOrChangeShippingAddress

Die Umsetzung dieser Methode bietet Ihnen folgende Möglichkeiten:

  1. Wenn true zurückgegeben wird, wird der Prozess fortgesetzt, ohne dass etwas geändert wird.
  2. Die Rückgabe einer (geänderten) Adressobjektinstanz von AddressInterface zeigt dem Kunden eine Aufforderung zur Adresskorrektur
  3. Das Auslösen einer LocalizedException zeigt dem Kunden die angegebene Ausnahmemeldung an
Code Block
languagephp
linenumberstrue
@param AddressInterface $oAddressData
@param bool $blIsVirtual
@param double $dTotal
@return AddressInterface|bool
@throws LocalizedException

public function handleEnterOrChangeShippingAddress(AddressInterface $oAddressData, $blIsVirtual, $dTotal)
    {
        $response = $this->protectFunnel->executeAddresscheck($oAddressData, $this->getOperationMode(), AddressCheckType::BASIC);
        if ($oAddressData->getCity() == "FalscheStadt") {
            $oAddressData->setCity($response->getCity());
            return $oAddressData;
        }
        return true;
    }


UI Expand
titleProtect (Legacy)
  • Klicken Sie unter PAYONE → Konfiguration → PROTECT

Adressprüfung

Feld

Beschreibung

Aktiviert

Aktiviert die Adressprüfung

Betriebsmodus

Hier wird bestimmt, ob die PAYONE Plattform im Test- oder Live-Modus angesprochen wird.

Prüfe Rechnungsadresse

Konfiguration, mit welcher Prüfung die Rechnungsadresse geprüft werden soll.

Prüfe Lieferadresse

Konfiguration, mit welcher Prüfung die Lieferadresse geprüft werden soll.

Prüfe Rechnungsadresse für

virtuelle Bestellungen

Wählen Sie, ob die Rechnungsadresse bei virtuellen Bestellungen geprüft werden soll.

Bestätigung der Adresskorrektur

Auswahl, ob eine Adresskorrektur vom Käufer bestätigt werden muss.

Meldung bei ungültigen Daten

Tragen Sie hier die Fehlermeldung ein, die beim Status "INVALID" angezeigt werden soll.

Behandlung von Fehlern

Was soll nach einem Fehler in der Extension oder der PAYONE Plattform ausgeführt werden?

Minimaler Warenwert

Mindestbetrag für die Durchführung einer Adressprüfung.

Maximaler Warenwert

Maximalbetrag für die Durchführung einer Adressprüfung

Gültigkeit

Anzahl der Tage, an denen keine neue Adressüberprüfung durchgeführt wird.


UI Text Box
typeinfo

Für die Adress- und Bonitätsprüfung stehen verschiedene Dienstleister zur Verfügung. Unser Support-Team erklärt Ihnen gerne, welchen Leistungsumfang die einzelnen Prüfungen haben und welcher Dienstleister für Sie der richtige ist.

Bonitätsprüfung

Feld

Beschreibung

Aktiviert

Aktiviert die Bonitätsprüfung

Betriebsmodus

Hier wird bestimmt, ob die PAYONE Plattform im Test- oder Live-Modus angesprochen wird.

Zeitpunkt der Prüfung

Auswahl der "Vor/Nach der Zahlartenauswahl"

Bonitätscheck-Typ

  • Infoscore
    • Harte Merkmale
    • Alle Merkmale
    • Alle Merkmale+Boniscore
  • Boniversum
    • VERITA Score

Standardwert für unbekannte Scores

Auswahl einer Ampelfarbe für den Rückgabestatus "Unbekannt"


Das betrifft nur Prüfungsergebnisse bei Verwendung des Bonitätschecks 'Boniversum VERITA Score

Erlaubte Zahlarten bei Ampelwert "Gelb/Rot"

Mehrfachauswahl der zulässigen Zahlungsarten nach Ampelfarbe

Behandlung von FehlernWas ist zu tun, wenn ein Fehler in der Integration oder auf der PAYONE Plattform auftritt?

Insufficient score error message

Meldung, die dem Kunden angezeigt wird, wenn ein unzureichender Punktwert erreicht wird.

Minimaler Warenwert

Mindestbetrag für die Durchführung einer Adressprüfung.

Maximaler Warenwert

Maximalbetrag für die Durchführung einer Adressprüfung.

Gültigkeit

Anzahl der Tage, an denen keine neue Adressüberprüfung durchgeführt wird.




UI Expand
titleWeiterleitung des Transaktionsstatus
  • Klicken Sie unter PAYONE → Konfiguration → Sonstiges


Feld

Beschreibung

cron expression

Wert für den Linux-Dienst CRON, der die Intervalle bestimmt, in denen der Transaktionsstatus verarbeitet wird.

Valid PAYONE IPs

Liste der gültigen PAYONE IP-Adressen, die einen Transaktionsstatus liefern können.

proxy mode

Aktivieren Sie diese Option für die IP-Validierung mit HTTP_X_FORWARDED_FOR. Dies ist nur notwendig, wenn Ihr Shop hinter einem Proxy-Server läuft.

Logging active

Der Fortschritt des Cronjobs bei der Verarbeitung des Transaktionsstatus wird in /var/log/payone_cron.log protokolliert.



UI Expand
titleRechnungsinformationen
  • Klicken Sie unter PAYONE → Konfiguration → Sonstiges

Rechnungsinformation - Shipping Costs

Feld

Beschreibung

SKU

Hier können Sie die Artikelnummer festlegen, wie sie an PAYONE übermittelt werden soll. Wenn Sie keine Sonderbehandlung wünschen, lassen Sie das Feld leer.

Rechnungsinformation - Credit Memo

Feld

Beschreibung

Korrektur der Erstattung - Artikelnummer

Hier können Sie die Artikelnummer für die Korrekturerstattung festlegen, wie sie an PAYONE übermittelt werden soll. Wenn Sie keine Sonderbehandlung wünschen, lassen Sie das Feld leer.

Korrektur der Erstattung - Beschreibung

Hier können Sie die Bezeichnung für die Korrekturerstattung festlegen, wie sie an PAYONE übermittelt werden soll. Wenn Sie keine Sonderbehandlung wünschen, lassen Sie das Feld leer.

Korrektur Aufschlag - Artikel-Nummer

Hier können Sie die Artikelnummer für den Korrekturzuschlag festlegen, wie er an PAYONE übermittelt werden soll. Wenn Sie keine Sonderbehandlung wünschen, lassen Sie das Feld leer.

Korrektur Aufschlag - Beschreibung

Hier können Sie die Bezeichnung für den Korrekturzuschlag festlegen, wie er an PAYONE übermittelt werden soll. Wenn Sie keine Sonderbehandlung wünschen, lassen Sie das Feld leer.



UI Expand
titleE-mail Konfiguration
  • Klicken Sie unter PAYONE → Konfiguration → Sonstiges

Konfigurations-E-Mail im Falle von Fehlern

Feld

Beschreibung

Aktiv

Aktiviert das Mail Reporting bei Fehlermeldungen, die im Zusammenhang mit der Nebenstelle auftreten.

Sender

Hier können Sie auswählen, wer der Absender der Fehlermails ist. Die Kontakte werden aus der Magento-Funktion der Adressen übernommen.

Recipient

Hier können Sie auswählen, wer der Empfänger der Fehlermails ist. Die Kontakte werden aus der Magento-Funktion der Adressen übernommen.

Copy to

Hier können Sie auswählen, wer der zusätzliche Empfänger der Fehlermails ist. Die Kontakte werden aus der Magento-Funktion der Adressen übernommen.

Template

Hier können Sie die Vorlage auswählen, mit der Sie die E-Mail erstellen möchten. Sie sollten jedoch immer die PAYONE E-Mail-Fehlervorlage verwenden.

E-mail Konfiguration AVS

Das Address Verification System (AVS) ist ein Adressverifikationssystem von American Express. Die vom Endkunden eingegebene Rechnungsadresse wird mit der Rechnungsadresse der Kreditkarte verglichen.

Feld

Beschreibung

Aktiv

Aktiviert/deaktiviert den Versand von Mails, für AVS bedingte Informationen.

E-Mail für AVS-Wert senden

Auswahl von Werten für mehrere Laufwerke, die vom AVS-System zurückgegeben werden können..

Sender

Hier können Sie auswählen, wer der Absender von AVS-Mails ist. Die Kontakte werden aus der Magento-Funktion der Adressen übernommen.

Recipient

Hier können Sie auswählen, wer der Empfänger von AVS-Mails ist. Die Kontakte werden aus der Magento-Funktion der Adressen übernommen.

Copy to

Hier können Sie auswählen, wer der zusätzliche Empfänger von AVS-Mails ist. Die Kontakte werden aus der Magento-Funktion der Adressen übernommen.

Template

Hier können Sie die Vorlage auswählen, mit der Sie die E-Mail erstellen möchten. Sie sollten jedoch immer die PAYONE Email AVS-Vorlage verwenden.



UI Expand
titleKonfiguration exportieren
  • Klicken Sie unter PAYONE → Konfiguration → Export Configuration

Wenn Sie auf Konfiguration exportieren klicken, wird eine Datei heruntergeladen.

Sie können diese Datei nun mit einem XML-Editor öffnen und ansehen oder speichern. Dieser Export ist für jede Support-Anfrage an das PAYONE Team sehr wichtig, um mögliche Konfigurationsprobleme zu vermeiden. Anhand dieser Datei kann auch festgestellt werden, ob weitere Erweiterungen installiert wurden, die Kompatibilitätsprobleme verursachen könnten.


UI Expand
titleTransaktionen
  • Klicken Sie unter PAYONE → Transactions

Überblick

Hier finden Sie eine Übersicht über alle über PAYONE abgewickelten Transaktionen. Mit einem Klick auf Ansicht können Sie sich Details zu der jeweiligen Transaktion anzeigen lassen. Sie haben auch die Möglichkeit, z.B. nach Zahlungsart, Status oder Betrag zu filtern.



UI Expand
titlePAYONE Logs
  • Klicken Sie unter PAYONE → Logs


Unter dem Menüpunkt Protokolle finden Sie alle Informationen über abgewickelte Zahlungen und die Kommunikation mit der PAYONE Plattform.

UI Expand
titleTransactionsstatus Logs
  • Klicken Sie unter PAYONE → Logs → Transactionsstatus

Überblick

Der Untermenüpunkt Transaktionen zeigt die von Magento empfangenen Benachrichtigungen über den Transaktionsstatus für jede Bestellung und Transaktion an. Diese Benachrichtigungen werden von der PAYONE Plattform an Ihren Shop gesendet. Im Fehlerfall können Sie hier erfahren, ob der Transaktionsstatus korrekt empfangen wurde und wie der aktuelle Status einer Transaktion ist. Mit einem Klick auf Ansicht können Sie sich Details zu einem Transaktionsstatus anzeigen lassen.

Details


In der linken Spalte sehen Sie die Anfrage, die der Magento-Shop an die PAYONE Plattform gesendet hat. Auf der rechten Seite 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.


UI Expand
titleAPI Logs
  • Klicken Sie unter PAYONE → Logs → API


Überblick

In dieser Übersicht finden Sie alle Anfragen des Magento Shops an die PAYONE Plattform sowie die Antworten der PAYONE Plattform auf diese Anfragen. Lediglich die Anfragen, die über die Client API an die PAYONE Plattform übermittelt wurden, sind in dieser Übersicht nicht aufgeführt. Dies gilt für Kreditkarteninformationen, die mittels Ajax-Technologie direkt vom Browser des Käufers an die PAYONE Plattform übertragen werden, so dass Ihr Shop nicht mit sensiblen Kreditkarteninformationen in Berührung kommt. Mit einem Klick auf Ansicht können Sie sich eine API-Anfrage im Detail anzeigen lassen.

Details


In der linken Spalte sehen Sie die Anfrage, die der Magento-Shop an die PAYONE Plattform gesendet hat. Auf der rechten Seite 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.





Quick Facts


Integrationquickfacts
TXURLindex.php/payone_core/transactionStatus
Repohttps://github.com/PAYONE-GmbH/magento-1/releases
Version5.2.0
SHOPID1
Systemmagento1

Inhaltsverzeichnis


Table of Contents
maxLevel2
outlinetrue
indent2em