Voraussetzungen

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

Installation des Plugins

Sie haben 2 Möglichkeiten unser Plugin zu installieren:

Installation via Composer

Oxid 6 verwendet den Composer für die Verwaltung von Abhängigkeiten, daher wird unsere Erweiterung auch über Composer installiert. Bitte führen Sie die folgenden Schritte aus, um die Erweiterung zu installieren:

Per SSH in das Verzeichnis Ihrer Oxid composer.json-Datei und führen Sie den folgenden Befehl aus:

composer require payone-gmbh/oxid-6

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:

<SHOPURL>/modules/fc/fcpayone/status.php 

Bitte belassen Sie die Hash-Prüfung auf md5, um eine korrekte Kommunikation zwischen PAYONE und dem Shop zu gewährleisten.

Additional Response-data

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

Konfiguration im Oxid - Admin

  • Aktivieren Sie das Modul im Oxid-Backend.

Konfiguration der Zahlarten

  • Unter Konfiguration → Zahlungsarten werden die Standard-Zahlungsarten und die PAYONE-Zahlungsarten angezeigt. Hier können Sie die gewünschten Zahlungsarten konfigurieren.

  • Die PAYONE Zahlungsarten erweitern die OXID Standard Zahlungsarten. Um nur die PAYONE-Zahlungsarten anzuzeigen, verwenden Sie die Filterfunktion Nur PAYONE im Kopf der Tabelle.

Übersicht

Die Übersicht zeigt Ihnen alle PAYONE Zahlungsarten, die zur Konfiguration zur Verfügung stehen. Bitte konfigurieren Sie nur die Zahlungsarten, die für Ihr Händlerkonto freigeschaltet wurden.

Basis Konfiguration

Basis Konfiguration

Sie erkennen alle PAYONE Zahlungsarten an dem abgebildeten Logo.

Feld

Beschreibung

Autorisierungs-Methode

  • Vorautorisierung - 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.
  • Autorisierung - Der zu zahlende Betrag wird sofort bei Auftragserteilung eingezogen. Die Forderung wird sofort auf der PAYONE Plattform verbucht.
PAYONE Betriebsmodus

Bestimmt für die jeweilige Zahlungsart, ob die Zahlungen im Testmodus verarbeitet werden sollen oder ob sie "live" ausgeführt werden sollen.

Aktiv

Bestimmt, ob die Zahlungsmethode im Checkout-Prozess verfügbar ist.

Name

Name der Zahlungsart, der im Checkout angezeigt wird.

Preisauf-/ abschlag

Hier können Sie einen Preisaufschlag/-abschlag für die Zahlungsart festlegen. Die Preise können auf zwei verschiedene Arten angegeben werden:

  • abs - gibt den absoluten Preis an (wenn Sie z. B. 7,50 eingeben, werden 7,50 Euro berechnet).
  • % - errechnet den Preis im Verhältnis zum Warenkorbwert. (Beispiel: Eingabe "2", werden 2% des Warenkorbwerts aufgeschlagen). Sie können auch negative Werte eingeben. (Beispiel: Eingabe "-2", werden 2 % des Warenkorbwerts abgezogen).
Ab Bonitätsindex

Hier können Sie festlegen, dass bestimmte Zahlungsarten nur Nutzern/Käufern zur Verfügung stehen, die mindestens den definierten Bonitätsindex aufweisen. Sie können den Bonitätsindex für jeden Benutzer unter Manage User → User → Advanced festkegen.

Wenn Sie das Protect-Modul bei PAYONE bestellt haben, können Sie diesen Wert über die Bonitätsprüfung automatisch beim jeweiligen Nutzer/Käufer hinterlegen.

Einstellungen für Zahlungsarten ohne PAYONE-Kennzeichen haben keine Auswirkungen auf die Abwicklung durch PAYONE.

Zahlungseinstellungen

Zahlungseinstellungen

Die globalen Konfigurationseinstellungen für die Kommunikation mit der PAYONE Plattform werden unter PAYONE → Konfiguration → PAYONE Zahlungseinstellungen vorgenommen.

Connection Konfiguration

Feld

Beschreibung

PAYONE Merchant ID

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

PAYONE Portal ID

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

PAYONE Portal Key

Den Portal Key finden Sie im PAYONE Merchant Interface (PMI) unter Konfiguration → Zahlungsportale → [Edit] → Tab [Advanced] → Key

PAYONE Sub-Account ID

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

Reference number Prefix

Hier können Sie konfigurieren, wie die Referenznummer ergänzt werden soll, um die Eindeutigkeit bei der Überweisung an PAYONE zu gewährleisten.

Diese Einstellung ist z. B. erforderlich, wenn Sie die Erweiterung auf einem Test- und einem Produktivsystem einsetzen.

Hash Method
  • md5
  • sha2-384

Diese Einstellung entspricht der Hash-Einstellung in Ihrem Zahlungsportal.

Die PMI- und Shop-Einstellungen müssen übereinstimmen, damit Kreditkartenzahlungen korrekt funktionieren. Wir empfehlen dringend, beide auf sha2 zu setzen!

Allgemein

Feld

Beschreibung

Artikelliste versenden

Hier können Sie einstellen, dass die Artikelinformationen auch an PAYONE übertragen werden.

Diese Option muss nur aktiviert werden, wenn Sie das Modul Fakturierung bei PAYONE gebucht haben.

Bestellung vor Autorisierung speichern

Hier können Sie festlegen, ob die Bestellung bereits vor der Zahlungsbestätigung gespeichert wird. Diese Aufträge befinden sich dann in einem Wartestatus.

Spezielle Anpassungen

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

Kreditkarte

Kreditkarte

Die Zahlungsmethode Kreditkarte ist in der Erweiterung in verschiedene Unterarten (Kartenbrands) unterteilt.

In der Übersicht können Sie die jeweilige Kartenart aktivieren oder deaktivieren. Sie haben auch die Möglichkeit, der jeweiligen Kartenmarke Länder zuzuordnen, aus denen Sie die Karte akzeptieren möchten. Außerdem können Sie für jede Kreditkartenmarke einstellen, ob sie im Live- oder Testmodus aktiviert ist.

Lokale Kartenmarken sollten nur für das jeweilige Land vergeben werden (z.B. Carte Bleue = Frankreich). Außerdem muss die jeweilige Kartenmarke für Ihr Händlerkonto bestellt und aktiviert worden sein.

Kreditkarten Konfiguration

Das Oxid 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 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

Anfragetyp

  • hosted-IFrame
  • AJAX

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.

Feldkonfiguration

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"
  • Auswahl - drop-down list

Anzahl Zeichen

Anzahl der Zeichen in der Breite des Eingabefeldes

Zeichen Max

Maximal zulässige Anzahl von Zeichen

Iframe

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

Breite

Festlegen der Breite im CSS

Höhe

Angabe der Höhe in CSS

Stil

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

CSS

Spezifizieren Sie das CSS, um das betreffende Feld zu formatieren.

Wenn Sie das CSS-Attribut "url" verwenden, wird das betreffende Feld nicht angezeigt

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


Aktiv

Aktiviert die Ausgabe von Fehlermeldungen im Checkout bei Kreditkartenzahlungen.

Sprache

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

PAYONE Lastschrift

PAYONE Lastschrift

Im Bereich Lastschrift können Sie Einstellungen bezüglich des SEPA-Verfahrens (Single European Payments Area) vornehmen.


Feld

Beschreibung

Länder

Auswahl der Länder, für die das Lastschriftverfahren angeboten werden kann.

Nur bei Deutschen Konten

Für deutsche Konten ist es weiterhin möglich, neben der IBAN / BIC auch die Kontonummer und Bankleitzahl anzuzeigen. Mit dieser Auswahl aktivieren Sie die Anzeige.

Mandatserteilung

Soll der SEPA-Mandatsmanager verwendet werden? Eine Prüfung der Bankverbindung ist obligatorisch.

Download Mandat als PDF

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

Dieses Produkt muss separat bestellt werden.

PayPal

PayPal

Feld

Beschreibung

Rechnungsadresse bei fehlenden Lieferadresse als Lieferadresse übergeben.

Wenn keine explizite Lieferadresse oder eine abweichende Lieferadresse angegeben wurde, wird bei der Zahlungsmethode PayPal die Rechnungsadresse als Lieferadresse übermittelt - sofern die Checkbox aktiviert ist.

Aktiv

Aktiviert den Eintrag

Sprache

Sprache, für die dieser Eintrag gilt. Es werden nur Sprachen angezeigt, die im OXID eShop erstellt wurden.

Logo

Vorschau des hochgeladenen Logos, das später im Checkout verwendet wird.

Hochladen

An dieser Stelle kann das Logo ausgewählt werden.

Standard

Wenn aktiviert, wird der Eintrag oder das Logo dieses Eintrags als Standard für alle Sprachen verwendet, für die kein Logo verfügbar ist.

Barzahlen

Barzahlen

Um die Zahlungsart zu aktivieren, empfehlen wir Ihnen, die Darstellung unter: https://integration.barzahlen.de/de/designanforderungen zu kopieren.

Beispiel:

Example Code
<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;">
Unzer Payments

Unzer Payments

Feld

Beschreibung

Payolution im B2B-Modus betreiben

Ist der B2B-Modus aktiviert, wird automatisch davon ausgegangen, dass es sich um eine B2B-Transaktion handelt, wenn bei der Eingabe der Adresse 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.

Firmenname

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

Payolution Benutzername

Um den Ratenkauf-Vertragsentwurf abrufen zu können, muss hier der von Paysafe vergebene Benutzername hinterlegt werden.

Payolution Passwort

Hier muss das von Unzer vergebene Passwort hinterlegt werden, um den Ratenkaufvertrag abrufen zu können.

Ratepay

Ratepay

Damit Ratepay funktioniert, fügen Sie bitte Ihre Profil-ID hinzu und geben Sie die entsprechende Währung an.

Wenn der B2B-Modus aktiviert ist und der Firmenname vom Benutzer angegeben wird, wird die Umsatzsteuer-Identifikationsnummer abgefragt. Bei B2C-Kunden wird stattdessen das Geburtsdatum abgefragt.

Amazon Pay

Amazon Pay

Feld

Beschreibung

Beispiel
Amazon Seller IDZeigt die aktuelle Verkäufer-ID an
Amazon Client IDZeigt die aktuelle Client-ID an
Amazon-Konfiguration von PAYONE abrufen
Klicken Sie hier um die aktuelle Konfiguration von PAYONE abzurufen.

Diese Zahlungsart funktioniert nicht, bevor die Konfiguration gespeichert wurde!


Amazon Button Typ
  • Amazon Pay (standard) 
  • Pay (slightly smaller)
  • Amazon Pay (super small)

Amazon Button Farbe
  • Gold
  • Light grey
  • Dark grey

 

Amazon-Modus
  • Immer Synchron
  • Asynchronous on failure - kann eine bessere Konversionsrate haben, kann aber Ihren Arbeitsablauf verkomplizieren.

Loginmethode
  • Automatisch - empfohlene Einstellung
  • Popup - funktioniert nur bei SSL-gesicherten Shops
  • Redirect

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.

Zusätzlich muss die Allowed Return URL auf <shoproot>/index.php?cl=user&fnc=fcpoamazonloginreturn gesetzt werden

PAYONE Gesicherter Rechnungskauf + PAYONE Gesicherter Ratenkauf

PAYONE Gesicherter Rechnungskauf + PAYONE Gesicherter Ratenkauf

Diese beiden Zahlungsarten benötigen ein eigenes Zahlungsportal. Bitte tragen Sie unter Kunden → Zahlungen → PAYONE → Gilt für Zahlart: PAYONE Gesicherter Rechnungskauf bzw. PAYONE Gesicherter Ratenkauf eine separate Portal ID ein.

Wenn die Bestellungen teilgecaptured werden, müssen die Refunds in der gleichen Höhe erstellt werden. Hintergrund ist, dass bei jedem Capture eine neue Forderung entsteht.

Paydirekt

Paydirekt

Feld

Beschreibung

Paydirekt-Express button

An dieser Stelle können Sie wählen, welches Design des Paydirekt-Express-Buttons Sie im Checkout verwenden möchten.

Die folgenden Schaltflächen stehen zur Auswahl:

GrünGrün 2WeissWeiss 2
Webaddress shipping termsDie Angabe einer Webadresse für Ihre Versandbedingungen ist für die Nutzung der Zahlungsmethode Paydirekt Express zwingend erforderlich.
DeliverysetBitte wählen Sie für Ihre PaydirektExpress-Bestellungen das passende Lieferset

Bearbeiten der Bestellungen

Bestellungen, die über die PAYONE Extension für Oxid getätigt werden, werden wie gewohnt in der Bestellübersicht von Oxid aufgeführt. Die Auftragsabwicklung unterscheidet sich je nach Autorisierungsmethode, mit der der Auftrag bearbeitet wird.

Erfassung/ Capture

Bestellungen, die über die Autorisierungsmethode "Vorautorisierung" aufgegeben werden, müssen gecaptured (abgebucht) werden.

In den Bestelldetails finden Sie einen zusätzlichen Reiter "PAYONE". Hier können Sie die Bestellung capturen.

Der Einzug wird dann auf der PAYONE Plattform veranlasst.

Gutschrift/ Refund

Gutschriften verwenden den bekannten Oxid-Gutschriftenprozess. Ein Klick auf den Button "Rückerstattung" in der Bestellung öffnet das Menü für Gutschriften.

Hier können Sie den gutgeschriebenen Betrag und einen Grund eingeben. Wichtig: Bei der "Manuellen Rückerstattung" wird das Geld nicht auf der Zahlungsmethode gutgeschrieben, sondern nur in Oxid. Nutzen Sie diese Option nur, wenn Sie kein Geld zurücküberweisen wollen oder wenn Sie andere Wege als die PAYONE Plattform nutzen.

Erweiterte Konfigurationen

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

Protect

Protect

Unter PAYONE → Protect können Sie sowohl Kredit- und Adressprüfungen als auch Bankkontoprüfungen konfigurieren.

Betriebsmodus


Hier können Sie für die Bonitätsprüfung festlegen, ob die Prüfungen im Test- oder im Livemodus durchgeführt werden.

Das Protect-Modul muss für Ihr Händlerkonto aktiviert sein, um diese Optionen nutzen zu können. Eine fehlerhafte Konfiguration führt zu unerwünschten Unterbrechungen im Checkout-Prozess.

Bonitätsprüfung

Hier können Sie festlegen, ob und in welcher Form eine Bonitätsprüfung während des Bestellvorgangs durchgeführt werden soll.

Feld

Beschreibung

Bonitätsprüfung

  • keine Bonitätsprüfung durchführen - Es wird keine Anfrage an die PAYONE Plattform gestellt
  • Infoscore (Harte Merkmale) - Prüfung auf harte Merkmale über Infoscore (z.B. Verbraucherinsolvenzverfahren, Haftbefehl  zur Erzwingung der eidesstattlichen Versicherung oder Vollstreckung der eidesstattlichen Versicherung)
  • Infoscore (alle Merkmale) - Prüfung auf sog. "harte" Negativmerkmale (s.o.) und "mittlere" Negativmerkmale (z.B. Mahnbescheid, Vollstreckungsbescheid oder Zwangsvollstreckung) und "weiche" Negativmerkmale (z.B. Mahnverfahren eingeleitet, Fortführung des außergerichtlichen Mahnverfahrens nach Teilzahlung, Einstellung des außergerichtlichen Mahnverfahrens wegen Aussichtslosigkeit)
  • Infoscore (Alle Merkmale+Boniscore) - Prüfung auf alle Merkmale (siehe oben) und Aushändigung des Boniscores, der als Score-Wert eine höhere Sensibilität für vorhandene Negativmerkmale ermöglicht.
  • Boniverse VERITA Score - Check for VERITA-Scores via Boniversum

Moment der Bonitätsprüfung

  • Vor Zahlartenauswahl
  • Nach Zahlartenauswahl - Sie können den Bonitätsindex für die Zahlungsart auswählen, so dass eine Prüfung nur für bestimmte Zahlungsarten durchgeführt wird.

Lebensdauer Bonitätsprüfung in Tagen

Anzahl der Tage, für die der zurückgegebene Bonitätswert gültig ist. Bis zum Ablauf des eingestellten Zeitraums werden für den betreffenden Shop-Käufer/ Nutzer keine neuen Bonitätsprüfungen durchgeführt. Wenn dieses Feld leer ist, wird immer eine Anfrage gestellt.

Bonitätsprüfung ab Warenwert (€)

Warenkorbwert, ab dem eine Bonitätsprüfung durchgeführt wird. Wenn dieses Feld leer ist, wird immer eine Anfrage gestellt.

Standard Bonitäts-Index

Diesen Bonitätsindex erhält der Kunde bei seiner Anmeldung.
Zweck: Wenn der Kunde noch nicht geprüft wurde und die Prüfung erst ab einem bestimmten Warenwert erfolgt, ist dies der Bonitätsindex, der bis zur ersten tatsächlichen Prüfung berücksichtigt wird. Bleibt dieses Feld leer, wird der OXID-Standard gesetzt (1000).

Bitte nehmen Sie die Einstellungen für die Bonitätsprüfung mit Bedacht vor. Falsche Konfigurationen können zu Fehlern im Checkout-Prozess und unerwünschten Kosten durch eine erhöhte Anzahl von Rückfragen und ein unnötig hohes Zahlungsausfallrisiko führen. Sie sollten die Bonitätsprüfung nur für Zahlungsarten verwenden, die für Sie ein Zahlungsausfallrisiko bedeuten (z.B. offene Rechnungen oder Lastschriften). Dies konfigurieren Sie über die Einstellung "Bonitätsindex" in der Konfiguration der jeweiligen Zahlungsart. Außerdem sollten Sie in Ihrem Shop in geeigneter Weise darauf hinweisen, dass Sie die Bonitätsprüfung über die infoscore Consumer Data GmbH durchführen.

Adressprüfung

Hier können Sie festlegen, ob und in welcher Form die Adressprüfungen durchgeführt werden sollen und wie sich der OXID eShop verhalten soll, wenn bestimmte Ergebnisse zutreffen


Feld

Beschreibung

Adressprüfung

  • Keine Adressprüfung durchführen - Es wird keine Adressprüfung durchgeführt
  • AdressCheck Basic - Adressprüfung auf Existenz (Straße, PLZ, Ort, Land) sowie Adressergänzung und -korrektur (möglich für Adressen aus Deutschland, Österreich, Schweiz, Niederlande, Belgien, Luxemburg, Frankreich, Italien, Spanien, Portugal, Dänemark, Schweden, Finnland, Norwegen, Polen, Slowakei, Tschechien, Ungarn, USA, Kanada).
  • AdressCheck Person - Prüfung, ob die Person unter der angegebenen Adresse bekannt ist, Prüfung des Vorhandenseins der Adresse und Ergänzung und Berichtigung der Adresse (nur Deutschland).
  • Boniversum Addresscheck Basic
  • Boniversum Addresscheck Person

Korrigierte Adressen anwenden

Es wird eine von der PAYONE Plattform korrigierte Adresse übernommen.

Lieferadresse prüfen

Eine abweichende Lieferadresse wird ebenfalls auf der Grundlage der gewählten Adressprüfung geprüft. 

Wenn die Option "Korrigierte Adressen anwenden" ausgewählt ist, werden auch die korrigierten Lieferadressen angewendet.

Wenn Adresse postalisch falsch wird Benutzer zum Benutzerformular zurück geschickt

Trifft die beschriebene Bedingung zu, wird der Nutzer im Checkout erneut aufgefordert, seine Rechnungs-/Lieferdaten einzugeben.

Prüfung der Bankverbindung

Hier können Sie einstellen, ob und in welcher Form die Bankverbindung bei der Zahlungsart Lastschrift während des Bestellvorgangs geprüft werden soll.


Feld

Beschreibung

Prüfung Bankverbindung

  • Deaktiviert - Es findet keine Überprüfung der Bankverbindung statt
  • Aktiviert - Das System prüft die Plausibilität der Kontodaten.

    Das Vorhandensein der Bankverbindung oder der Kontodeckung wird nicht überprüft.

  • Aktiviert, mit Prüfung gegen POS-Sperrliste - Es erfolgt eine Prüfung der Bankverbindung auf Plausibilität und eine Prüfung gegen die POS-Sperrliste. 

    Auch hier erfolgt keine Prüfung auf das Vorhandensein der Bankverbindung oder die Deckung des Kontos. Die POS-Blockdatei enthält Kontoverbindungen mit offenen Rückbelastungen aus dem stationären Handel.

Transaktionsstatus Umleitungen

Transaktionsstatus Umleitungen

Feld

Beschreibung

Logs

Wenn diese Option aktiviert ist, können Sie die Aktivität der Transaktionsstatus-Weiterleitungen protokollieren. Der Inhalt dieser Protokollierung landet in der Datei fcpo_message_forwarding.log im Log-Ordner Ihres Shops. 

UmleitungsmodusDirekte Umleitung - Bei dieser Methode wird die Transaktion nach dem Empfang direkt umgeleitet. Dieser Modus bietet eine hohe Umleitungsgeschwindigkeit und eine moderate Transaktionssicherheit.
Verzögerung durch Cronjob - Anstatt die Statusnachricht direkt weiterzuleiten, sammelt diese Methode eingehende Nachrichten und leitet sie nach dem Aufruf eines Cronjobs weiter. Dieser Modus bietet eine sehr hohe Transaktionssicherheit. Die Geschwindigkeit der Weiterleitung von Statusnachrichten hängt von der Konfiguration Ihres Servers ab.
ZeitlimitUm direkte Weiterleitungen ohne Unterbrechungen anbieten zu können, ist eine Zeitbegrenzung für den Modus "Direkte Weiterleitungen" erforderlich.
Weiterleitung des Transaktionsstatus

Weiterleitung des Transaktionsstatus

Die Weiterleitung des Transaktionsstatus ermöglicht es Ihnen, den Zahlungsstatus an andere Systeme, wie z.B. die Warenwirtschaft zu übergeben.

Feld

Beschreibung

Status

Der von PAYONE gesendete Status.

URL

Geben Sie die Empfangs-URL ein, an die der Status weitergeleitet werden soll.

Timeout

Anzahl der Sekunden, die gewartet wird, bis der Status akzeptiert wird.

löschen

Hier können Sie die jeweilige Weiterleitung löschen.

Speichern

Beim Speichern werden alle Weiterleitungen in der Datenbank gespeichert.

Hinzufügen

Sie können so viele Weiterleitungen hinzufügen, wie Sie möchten. Auch mehrere Weiterleitungen für ein und denselben Status.

Transaction Status Mapping

Transaction Status Mapping

Das Transaktionsstatus-Mapping dient dazu, den PAYONE-Status zu nutzen, um die Bestellungen nach Ihren Wünschen in einem entsprechenden Shop-Status verarbeiten zu lassen.

Feld

Beschreibung

Zahlart

Die Zahlungsart, für die das Mapping gelten soll.

PAYONE Status

Der von PAYONE an den Shop gesendete Status.

Shop - Status

Der Status, den die Bestellungen annehmen sollen, wenn die konfigurierte PAYONE-Anfrage im Shop bearbeitet wird.

löschen

Hier können Sie das jeweilige Mapping löschen.

Speichern

Beim Speichern werden alle Zuordnungen in der Datenbank gespeichert.

Hinzufügen

Sie können beliebig viele Mappings hinzufügen. Bitte beachten Sie jedoch, dass für eine Kombination aus Zahlungsart und PAYONE-Status nur ein Mapping existiert. Dies kann zu Inkonsistenzen führen.

Logs

Logs

Unter PAYONE Protokolle/Logs finden Sie alle Informationen über die abgewickelten Zahlungen, die Kommunikation mit der PAYONE Plattform sowie die Bestellübersicht.

Transaktionen

Der Untermenüpunkt Transaktionen zeigt die vom OXID eShop empfangenen Benachrichtigungen über den Transaktionsstatus der PAYONE Plattform für jede Bestellung und Transaktion an. Im Fehlerfall können Sie hier erfahren, ob der Transaktionsstatus korrekt empfangen wurde und wie der aktuelle Status einer Transaktion ist.

Übersicht

In der Übersicht sehen Sie alle empfangenen und verarbeiteten Meldungen zum Transaktionsstatus der PAYONE Plattform. Oberhalb der einzelnen Spalten stehen Ihnen Filteroptionen zur Verfügung.

Feld

Beschreibung

Zeitpunkt

Zeitpunkt, zu dem der Transaktionsstatus empfangen wurde.

Bestellnummer

Die Bestellnummer der Bestellung im OXID eShop.

Transaktionsnummer

Die eindeutige Nummer der Transaktion (TXID). Diese Nummer wird von der PAYONE Plattform vergeben.

Zahlungsmethode

Hier wird die in dieser Transaktion verwendete Zahlungsart angezeigt. 
Die folgenden Abkürzungen sind möglich:
elv - Lastschrift
cc - Kreditkarte
rec - Rechnungskauf
cod - Nachnahme
sb - Online-Überweisung
wlt - e-Wallet (z.B. PayPal)
fnc - Finanzierung (z.B. Klarna)

Kunden-E-Mail

Die E-Mail-Adresse des Kunden, die bei der Bestellung angegeben wurde.

Betrag

Der Betrag in der verwendeten Währung.

Status

Hier wird der vom Transaktionsstatus der PAYONE Plattform übermittelte Status angezeigt.

Eine Erklärung der einzelnen Status finden Sie in der technischen Dokumentation der PAYONE Plattform im PAYONE Merchant Interface (PMI) unter Downloads → Dokumentation.

Transaktionsdetails


Nach Auswahl eines Eintrags in der Übersicht erhalten Sie alle über die PAYONE Plattform an Ihren OXID eShop übermittelten Transaktionsstatusinformationen. So können Sie jederzeit nachvollziehen, welche Daten Ihr OXID eShop empfangen und verarbeitet hat.
Eine detaillierte Erläuterung der jeweiligen Parameter finden Sie in der technischen Dokumentation der PAYONE Plattform im PAYONE Merchant Interface (PMI) unter Downloads → Dokumentationen.

API logs

Im Untermenü API-Logs finden Sie alle Anfragen vom OXID eShop an die PAYONE Plattform sowie die entsprechende Antwort der PAYONE Plattform.

Die einzigen Anfragen, die nicht in diesen Protokollen enthalten sind, sind Anfragen, die die Client API nutzen. Der Grund dafür ist, dass diese Anfragen aus Gründen des Payment Card Industry Data Security Standards auf Basis der Ajax-Technologie direkt vom Browser des Käufers (Client) an die PAYONE Plattform gesendet werden, so dass Ihr OXID eShop technisch nicht mit sensiblen Kreditkartendaten in Berührung kommt.

Übersicht

In der Übersicht finden Sie eine Auflistung aller Anfragen aus dem OXID eShop an die Server-API mit Basisinformationen. Sie können die Anzeige in den Spaltenköpfen durch Eingabe von Suchbegriffen filtern.

Der gesamte Inhalt der Spalten Request und Response wird durchsucht. Der Inhalt wird in den API-Protokolldetails ausführlicher beschrieben.

Feld

Beschreibung

Zeit

Zeitpunkt der Anfrage

Channel

Der verwendete Channel

Request

Art der Anfrage

Response

Parameter "status" aus der Antwort der PAYONE Plattform auf die Anfrage

API Log Details


Wenn Sie auf eine der in der Übersicht aufgeführten Anfragen klicken, sehen Sie alle Parameter der an die PAYONE Plattform gesendeten Anfrage sowie die entsprechende Antwort der PAYONE Plattform.

Eine detaillierte Erklärung der jeweiligen Parameter finden Sie in der technischen Dokumentation der PAYONE Plattform im PAYONE Merchant Interface (PMI) unter Downloads → Dokumentation

Bestellungen

Die Bestellübersicht ist eine Standardfunktionalität des OXID eShops. Die Registerkarte PAYONE wurde zu dieser Liste hinzugefügt, um den Zahlungsstatus einer Bestellung überprüfen zu können.

Über den Menüpunkt Bestellungen verwalten → Bestellungen, der standardmäßig in jedem OXID eShop verfügbar ist, wird die gleiche Übersicht inklusive der PAYONE Registerkarte angezeigt wie unter PAYONE → Protokolle / Logs → Bestellungen.

Übersicht

In der Übersicht finden Sie eine Liste aller Aufträge mit Basisinformationen. Wie bei den Transaktionen und API-Protokollen können Sie die Anzeige in den Spaltenköpfen durch Eingabe von Suchbegriffen filtern.

Feld

Beschreibung

Bestellzeit

Zeitpunkt der Bestellung

Bezahlt

Zeitpunkt der Meldung der Zahlung über die PAYONE Plattform..

Bestellnr.

Bestellnummer des OXID eShops.

Vorname, Nachname

Name des Kunden

PAYONE Ref. Nr.

Die Referenznummer, die zur eindeutigen Identifizierung an die PAYONE Plattform übergeben wird. Die Referenznummer wird in dem Parameter "Referenz" gespeichert.

PAYONE Tab

Im Reiter PAYONE finden Sie das Transaktionskonto im Kontext der Bestellung, in dem alle Forderungen und Zahlungen angezeigt werden. Grundlage hierfür sind die Anfragen von OXID eShop über die Server-API an die PAYONE Plattform sowie die Rückmeldungen zum Transaktionsstatus von der PAYONE Plattform.

Sie haben auch die Möglichkeit, Zahlungen für vorautorisierte Zahlungsvorgänge und Erstattungen zu erfassen.

Feld

Beschreibung

Referenz-Nummer

Die Referenznummer, die zur eindeutigen Identifizierung an die PAYONE Plattform übergeben wird. Die Referenznummer wird in dem Parameter "Reference" gespeichert.

PAYONE Vorgangsnummer (TXID)

Die Transaktionsnummer, unter der die Transaktion auf der PAYONE Plattform verarbeitet wurde.

Zahlungsart

Zahlungsart, mit der die Bestellung ausgeführt wurde.

Zahlungsdetails

Je nach Zahlungsart werden hier detaillierte Informationen zur Zahlung aufgeführt. Bei Kreditkartenzahlungen werden hier die Felder Kartentyp und Maskierte Kartennummer als Information angezeigt.

Betrag

Je nach Zahlungsstatus des Auftrags können Sie an dieser Stelle eine Gutschrift (Refund) auslösen oder einen Zahlungseinzug (Capture) durchführen.

Im Debitorenmanagement im PAYONE Merchant Interface (PMI) stehen Ihnen weitergehende Möglichkeiten zur Durchführung von Captures, Refunds etc. zur Verfügung. Darüber hinaus können Sie diese Vorgangsarten über Ihr Warenwirtschaftssystem oder/und? über die Server-API der PAYONE-Plattform ansteuern.

Transaktionskonto

Alle Forderungen und Zahlungen zur Bestellung werden hier in Form eines Transaktionskontos angezeigt. Alle negativen Beträge werden in rot angezeigt. Klicken Sie auf "Zeit", um den entsprechenden Transaktionsstatus zu öffnen.

Fakten im Überblick

Payment methods + Features

6

Find our plugin documentation here .

Download our plugin from here .

Credit Cards

Visa

Mastercard

American Express

JCB

Diners Club

Maestro International

Wallets

Amazon Pay

Apple Pay

paydirekt

PayPal

PayPal Express

Wire Transfer

Cash On Delivery

PAYONE Direct Debit

PAYONE Invoice

PAYONE Prepayment

Online Bank Transfers

Bancontact

EPS

Giropay

iDEAL

PostFinance Card

PostFinance E-Finance

Przelewy24

Sofort

Trustly

Financing

PAYONE Secured Invoice

PAYONE Secured Direct Debit

PAYONE Secured Installment

Klarna Pay Later

Klarna Pay Now

Klarna Slice It

PAYONE Secure Invoice

Ratepay Open Invoice

Unzer Rechnungskauf

Unzer Lastschrift

Unzer Ratenkauf

Cash

Barzahlen

General

Open Source

Protect

Arvato

Boniversum

Transaction - Handling

(Partial) Captures and Refunds

Payment State Mapping

Backoffice Connections

Extended Logging

Transactionstatus URL:

<SHOPURL>/modules/fc/fcpayone/status.php 

Latest Release

v1.10.0

New Feature 
  • Implement B2B payments for BNPL Secured Invoice

Bugfix

  • Fixed birthday validation for secure invoice 

Maintenance

  • Performance optimization
  • Update iDEAL bank list
  • tested with Version 6.5
  • PHP 8.1

Download

Inhaltsverzeichnis


  • No labels