Integration
- Integration
- Plugins
- Integration Guide Shopware 6
- Integrationsanleitung Shopware 6
- Integration Guide Magento 2
- Integrationsanleitung Magento 2
- Integration Guide Shopware 5
- Integrationsanleitung Shopware 5
- Integration Guide WooCommerce
- Integrationsanleitung WooCommerce
- Integrationsanleitung Oxid 6
- Integration Guide Oxid 6
- Integrationsanleitung Oxid 7
- Integration Guide Oxid 7
- Installationsanleitung Magento 1
- Integration Guide Magento 1
- Channel-Server-API
- Server API - Preauthorization
- Server API - Authorization
- Server API - Capture
- Server API - Refund
- Server API - Debit
- Server API - Managemandate
- Server API - Getinvoice
- Server API - Getfile
- Server API - Vauthorization
- Server API - Creditcardcheck
- Server API - Getuser
- Server API - Updateuser
- Server API - 3dscheck
- Server API - Bankaccountcheck
- Server API - Addresscheck
- Server API - Createaccess
- Server API - Updateaccess
- Server API - Updatereminder
- Server API - General Interface Definitions
- Server API - checkout demo app
- Channel-Client-API
- Client API - Preauthorization
- Client API - Authorization
- Client API - Creditcardcheck
- Client API - Managemandate
- Client API - General Interface Definitions
- Client API - Createaccess
- Client API - Vauthorization
- Client API - Bankaccountcheck
- Client API - AJAX-Mode
- Client API - Redirect-Mode
- Client API - Addresscheck
- Client API - Hosted iFrame Mode
- Client API - Calculation of the HASH value
- PAYONE Link
- Channel-Frontend
- Response Handling
- Testdata
- NEW Hosted Tokenization Form
- Plugins
Einführung
Unser OXID 6 Plugin wird regelmäßig aktualisiert und bietet eine vielseitige, sofort einsetzbare Lösung für die einfache Annahme von Online-Zahlungen.
Unterstützte Zahlungsarten
💳 Kreditkarten
- Visa (Click to Pay), Mastercard (Click to Pay), American Express
- JCB, Diners Club
📱 Wallets
- Apple Pay
- Google Pay
- PayPal und PayPal Express
- PayPal v2 und PayPal Express v2
- Alipay
- WeChat Pay
- WERO
🏦 PAYONE Lösungen
- PAYONE Sicherer Rechnungskauf
- PAYONE Gesicherter Rechnungskauf, Gesichertes Lastschriftverfahren und Gesicherte Ratenzahlung
- PAYONE Lastschrift
- PAYONE Offener Rechnungskauf
- PAYONE Vorkasse
🌍 Zusätzliche Zahlungsarten
- Klarna Payments
- Ratepay Rechnungskauf, Lastschrift und Ratenzahlung
- Unzer Rechnungskauf, Lastschrift und Ratenzahlung
- Bancontact, EPS, iDEAL
- PostFinance Card und E-Finance
- Przelewy24
Voraussetzungen
Plugin-Installation
Sie haben 2 Möglichkeiten, unser Plugin zu installieren:
Installation über Composer
OXID 6 verwendet Composer für das Dependency Management, daher wird auch unsere Erweiterung über Composer installiert. Bitte führen Sie die folgenden Schritte aus, um die Erweiterung zu installieren:
SSH in das Verzeichnis Ihrer OXID composer.json-Datei und führen Sie den folgenden Befehl aus:
Installation über GitHub
Laden Sie die neueste Version direkt von GitHub herunter und installieren Sie sie manuell in Ihrer OXID 6-Installation.
Portal-Konfiguration
Um den Transaktionsstatus an die richtige Adresse zu senden, loggen Sie sich bitte in das PAYONE Merchant Interface (PMI) ein.
Navigieren Sie zu: Konfiguration → Zahlungsportale → IHR_PORTAL → Erweitert → TransactionStatus URL
Zusätzliche Response-Daten
Unter Allgemein setzen Sie die zusätzlichen Response-Daten sowohl für Live- als auch für Test-Modi auf "an".
Admin-Konfiguration
Aktivieren Sie das Modul im OXID-Backend.
Zahlungsarten-Konfiguration
Unter Konfiguration → Zahlungsarten werden sowohl die Standard-Zahlungsarten Ihres OXID eShops als auch die über PAYONE verfügbaren Zahlungsarten angezeigt. Hier können Sie die gewünschten Zahlungsarten konfigurieren.
Die PAYONE-Zahlungsarten sind eine Erweiterung der OXID-Standard-Zahlungsarten und bieten zusätzliche Optionen. Um nur die PAYONE-Zahlungsarten anzuzeigen, verwenden Sie die Filterfunktion PAYONE Only im Header der Zahlungsarten-Tabelle.
Übersicht
Die Übersicht zeigt Ihnen alle PAYONE-Zahlungsarten, die zur Konfiguration verfügbar sind. Bitte konfigurieren Sie nur die Zahlungsarten, die für Ihr Händlerkonto aktiviert wurden.
Sie können alle PAYONE-Zahlungsarten am angezeigten Logo erkennen.
| Feld | Beschreibung |
|---|---|
| Autorisierungsverfahren | Vorautorisierung - Der zu zahlende Betrag wird reserviert. In diesem Fall muss die Abbuchung in einem zweiten Schritt beim Versand erfasst werden. Autorisierung - Der zu zahlende Betrag wird sofort bei der Bestellung abgebucht. Die Forderung wird sofort auf der PAYONE-Plattform gebucht. |
| PAYONE Betriebsmodus | Hier können Sie für die jeweilige Zahlungsart festlegen, ob die Zahlungen im Testmodus verarbeitet oder "live" ausgeführt werden sollen. Sie können auch den Testmodus für einzelne Zahlungsarten konfigurieren. |
| Aktiv | Bestimmt, ob die Zahlungsart im Checkout-Prozess verfügbar ist. |
| Name | Name der Zahlungsart, der im Checkout angezeigt wird. |
| Preisaufschlag/Rabatt | abs - gibt den absoluten Preis an (z.B. wenn Sie 7,50 eingeben, werden 7,50 Euro berechnet). % - berechnet den Preis in Relation zum Warenkorbwert. (Beispiel: geben Sie "2" ein, werden 2% des Warenkorbwerts hinzugefügt). Sie können auch negative Werte eingeben. |
| Min. Bonität | Hier können Sie festlegen, dass bestimmte Zahlungsarten nur für Benutzer/Käufer verfügbar sind, die mindestens den definierten Bonitätsindex haben. Sie können den Bonitätsindex für jeden Benutzer unter dem Menüpunkt Benutzer verwalten → Benutzer → Erweitert eingeben. |
Die globalen Konfigurationseinstellungen für die Kommunikation mit der PAYONE-Plattform werden unter PAYONE → Konfiguration → PAYONE Zahlungseinstellungen vorgenommen.
Verbindungseinstellungen
| Feld | Beschreibung |
|---|---|
| PAYONE Händler-ID | Sie finden Ihre PAYONE Händler-ID oben rechts im PAYONE Merchant Interface (PMI) und auf allen PAYONE-Rechnungen. |
| PAYONE Portal-ID | Bitte geben Sie die ID des PAYONE-Zahlungsportals ein, das Sie zur Verarbeitung der Zahlungen verwenden möchten. Die Portal-ID finden Sie im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Zahlungsportale. |
| PAYONE Portal-Schlüssel | Die Konfiguration finden Sie im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Zahlungsportale → [Bearbeiten] → Tab [Erweitert] → Schlüssel |
| PAYONE Unterkonto-ID | Bitte geben Sie die ID des Unterkontos ein, das Sie zur Verarbeitung der Zahlungen verwenden möchten. Die ID finden Sie im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Konten |
| Referenznummer-Präfix | Hier können Sie konfigurieren, wie die Referenznummer ergänzt wird, um Eindeutigkeit für die Übertragung an PAYONE zu gewährleisten.
Diese Einstellung ist beispielsweise erforderlich, wenn Sie die Erweiterung auf einem Testsystem und einem Produktionssystem betreiben.
|
| Hash-Verfahren | 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!
|
Allgemeine Informationen
| Feld | Beschreibung |
|---|---|
| Artikelliste senden | Hier können Sie konfigurieren, dass die Artikelinformationen auch an PAYONE übertragen werden.
Diese Option muss nur aktiviert werden, wenn Sie das Rechnungsmodul bei PAYONE gebucht haben.
|
| Bestellung vor Autorisierung speichern | Hier können Sie festlegen, ob die Bestellung bereits vor der Zahlungsbestätigung gespeichert wird. Diese Bestellungen befinden sich dann in einem Wartestatus. |
Spezielle Anpassungen
Die Kreditkarten-Zahlungsart in der Erweiterung ist in verschiedene Untertypen (Kartenmarken) unterteilt. Sie können den jeweiligen Kartentyp in der Übersicht aktivieren oder deaktivieren. Sie haben auch die Möglichkeit, Länder zuzuweisen, aus denen Sie die Karte für die jeweilige Kartenmarke akzeptieren möchten. Zusätzlich können Sie für jede Kreditkartenmarke festlegen, ob sie im Live- oder Testmodus aktiviert ist.
Kreditkarten-Konfiguration
Die OXID-Erweiterung 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 des Shop-Templates, sondern enthalten ihren eigenen Stil. Sie können die folgenden Einstellungen verwenden, um diese Felder anzupassen.
| Feld | Beschreibung |
|---|---|
| Request-Typ |
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" Auswahl - Dropdown-Liste |
| 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 Standard-Stil 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 das Feld
Die Verwendung des Attributs "url" führt zu einer Nicht-Anzeige des Feldes
|
| Standard-Stil | |
| Eingabefelder | 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 Fehlerausgabe im Checkout bezüglich Kreditkarteneingaben. |
| Sprache | Auswahl der Anzeigesprache für die Fehlermeldungen. |
Im Lastschriftbereich 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 Lastschrift angeboten werden darf. |
| Kontonummer Anzeige Bankleitzahl | Für deutsche Konten ist es noch möglich, zusätzlich zu IBAN / BIC die Kontonummer und Bankleitzahl anzuzeigen. Mit dieser Auswahl aktivieren Sie die Anzeige. |
| Aktive Mandatszuteilung | Aktiviert die Mandatsverwaltung von PAYONE. |
| Mandat als PDF herunterladen | Hier können Sie festlegen, ob der Käufer am Ende des Checkouts einen Download des Mandats von PAYONE erhält. |
| Feld | Beschreibung |
|---|---|
| Rechnungsadresse als Lieferadresse verwenden | Wenn keine explizite Lieferadresse oder eine andere Lieferadresse angegeben wurde, wird die Rechnungsadresse als Lieferadresse für die Zahlungsart PayPal übertragen - sofern die Checkbox aktiviert ist. |
| Aktiv | Aktiviert den Eintrag |
| Sprache | Sprache, für die dieser Eintrag gilt. Es werden nur im OXID eShop erstellte Sprachen angezeigt. |
| Logo | Vorschau des hochgeladenen Logos, das später im Checkout verwendet wird. |
| Upload | 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. |
| Feld | Beschreibung |
|---|---|
| Im B2B-Modus betreiben | Wenn der B2B-Modus aktiviert ist, wird automatisch davon ausgegangen, dass es sich um eine B2B-Transaktion handelt, wenn das Feld "Firma" bei der Adresseingabe ausgefüllt wurde. Zur Prüfung der Kreditwürdigkeit des Unternehmens werden dann weitere Informationen wie die Handelsregisternummer im Checkout abgefragt. |
| Firmenname | Hier muss der vollständige Name des Unternehmens erscheinen. Der Name wird in der Datenschutzerklärung verwendet. |
| Unzer Benutzername | Um den Ratenkauf-Vertragsentwurf abzurufen, muss hier der von Unzer zugewiesene Benutzername hinterlegt werden. |
| Unzer Passwort | Das von Unzer zugewiesene Passwort muss hier hinterlegt werden, um den Ratenkauf-Vertragsentwurf abzurufen. |
Damit Ratepay Rechnungskauf 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 wurde, wird die USt-IdNr. abgefragt. Für B2C-Kunden wird stattdessen das Geburtsdatum abgefragt.
Diese beiden Zahlungsarten benötigen ein eigenes Zahlungsportal. Bitte geben Sie unter Kunden → Zahlungen → PAYONE → Konfiguration → gilt für Zahlungsart: PAYONE Gesicherter Rechnungskauf bzw. PAYONE Gesicherte Ratenzahlung eine separate Portal-ID ein.
Erweiterte Konfigurationen
Hier finden Sie separate Einstellungsoptionen, die es Ihnen ermöglichen, unser Plugin genauer an Ihre Bedürfnisse anzupassen.
Unter dem Menüpunkt PAYONE → Protect können Sie Bonitäts- und Adressprüfungen sowie Bankverbindungsprüfungen konfigurieren.
Hier können Sie für die Bonitätsprüfung festlegen, ob die Prüfungen im Test- oder Live-Modus durchgeführt werden.
Bonitätsbewertung
Hier können Sie festlegen, ob und in welcher Form Bonitätsprüfungen während des Checkout-Prozesses durchgeführt werden sollen.
| Feld | Beschreibung |
|---|---|
| Verbraucher-Score-Prüfung | Keine Verbraucher-Score-Prü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 Abgabe der eidesstattlichen Versicherung oder Vollstreckung der eidesstattlichen Versicherung) Infoscore (Alle Merkmale) - Prüfung auf sogenannte "harte" negative Merkmale (siehe oben) und "mittlere" negative Merkmale (z.B. Zahlungsbefehl, Vollstreckungsbescheid oder Zwangsvollstreckung) und "weiche" negative Merkmale (z.B. Inkasso-Mahnverfahren eingeleitet, Fortsetzung des außergerichtlichen Inkasso-Mahnverfahrens nach Teilzahlung, Einstellung des außergerichtlichen Inkasso-Mahnverfahrens wegen Aussichtslosigkeit) Infoscore (Alle Merkmale + Boniscore) - Prüfung auf alle Merkmale (siehe oben) und Lieferung des BoniScore, der als Score-Wert eine höhere Selektivität für bestehende negative Merkmale ermöglicht. Boniverse VERITA Score - Prüfung auf VERITA-Scores über Boniversum |
| Zeitpunkt der Verbraucher-Score-Prüfung | Vor Zahlungsart-Auswahl Nach Zahlungsart-Auswahl - Sie können den Bonitätsindex für die Zahlungsart auswählen, sodass 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. Für den festgelegten Zeitraum werden keine neuen Bonitätsprüfungen für den betreffenden Shop-Käufer/Benutzer durchgeführt, bis der festgelegte Zeitraum abläuft. Wenn dieses Feld leer ist, wird immer eine Anfrage gestellt. |
| Bonitätsprüfung ab Mindestwert (€) | Warenkorbwert, ab dem eine Bonitätsprüfung durchgeführt wird. Wenn dieses Feld leer ist, wird immer eine Anfrage gestellt. |
| Standard-Bonitätsindex | Der Kunde erhält diesen Bonitätsindex bei der Registrierung. Zweck: Wenn der Kunde noch nicht geprüft wurde und die Prüfung nur ab einem bestimmten Warenwert stattfindet, ist dies der Bonitätsindex, der bis zur ersten tatsächlichen Prüfung berücksichtigt wird. Wenn dieses Feld leer bleibt, wird der OXID-Standard gesetzt (1000). |
Adressvalidierung
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. AddressCheck Basic - Adressprüfung auf Existenz (Straßennummer, Postleitzahl, Stadt, Land) sowie Ergänzung und Korrektur der Adresse (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). AddressCheck Person - Prüfung, ob die Person unter der angegebenen Adresse bekannt ist, Prüfung der Existenz der Adresse und Ergänzung und Korrektur der Adresse (nur Deutschland). Boniversum Addresscheck Basic Boniversum Addresscheck Person |
| Korrigierte Adressen übernehmen | Eine von der PAYONE-Plattform korrigierte Adresse wird übernommen |
| Lieferadresse prüfen | Eine abweichende Lieferadresse wird ebenfalls auf Basis der ausgewählten Adressprüfung geprüft.
Wenn die Option "Korrigierte Adresse übernehmen" ausgewählt ist, werden auch korrigierte Lieferadressen übernommen.
|
| Bei postalisch falscher Adresse | Wenn die beschriebene Bedingung zutrifft, wird der Benutzer erneut aufgefordert, seine Rechnungs-/Lieferdaten im Checkout einzugeben. |
Bankverbindungsprüfung
Hier können Sie konfigurieren, ob und in welcher Form Bankverbindungen während des Checkout-Prozesses geprüft werden sollen, wenn die Zahlungsart Lastschrift ausgewählt wird.
| Feld | Beschreibung |
|---|---|
| Bankkonto prüfen | Inaktiv - Keine Prüfung der Bankverbindung Aktiv - Das System prüft die Plausibilität der Kontodaten. Es wird keine Prüfung auf Existenz der Bankverbindung oder Kontodeckung vorgenommen.
Aktiv, mit Prüfung gegen POS-Sperrliste - Es wird eine Prüfung der Bankverbindung auf Plausibilität und eine Prüfung gegen die POS-Sperrliste durchgeführt.
Auch hier wird keine Prüfung auf Existenz der Bankverbindung oder Deckung des Kontos vorgenommen. Die POS-Sperrdatei enthält Kontoverbindungen mit offenen Rücklastschriften aus dem stationären Handel.
|
| Feld | Beschreibung |
|---|---|
| Logs | Mit dieser aktivierten Option können Sie die Aktivität von Transaktionsstatus-Weiterleitungen protokollieren. Der Inhalt dieser Protokollierung landet in der Datei fcpo_message_forwarding.log im Log-Ordner Ihres Shops. |
| Weiterleitungs-Methode | Direkte Weiterleitung - Mit dieser Methode wird die Transaktion direkt nach dem Empfang weitergeleitet. Dieser Modus bietet eine hohe Weiterleitungsgeschwindigkeit und eine moderate Transaktionssicherheit. Verzögert 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 Einrichtung Ihres Servers ab. |
| Timeout | Um direkte Weiterleitungen ohne Unterbrechungen anzubieten, ist ein Timeout für den Modus "Direkte Weiterleitungen" erforderlich. |
Die Transaktionsstatus-Weiterleitung ermöglicht es Ihnen, den Zahlungsstatus an andere Systeme wie Warenwirtschaft oder Logistik zu übertragen.
| 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 | Das Speichern speichert alle Weiterleitungen in der Datenbank. |
| Hinzufügen | Sie können beliebig viele Weiterleitungen hinzufügen. Auch mehrere Weiterleitungen für ein und denselben Status. |
Das Transaktionsstatus-Mapping dient dazu, den PAYONE-Status zu verwenden, um die Bestellungen entsprechend Ihren Bedürfnissen in einem entsprechenden Shop-Status bearbeiten zu lassen.
| Feld | Beschreibung |
|---|---|
| Zahlungsart | 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 verarbeitet wird. |
| Löschen | Hier können Sie das jeweilige Mapping löschen. |
| Speichern | Das Speichern speichert alle Mappings in der Datenbank. |
| Hinzufügen | Sie können beliebig viele Mappings hinzufügen. Beachten Sie jedoch, dass nur ein Mapping für eine Kombination aus Zahlungsart und PAYONE-Status existiert. Dies kann zu Inkonsistenzen führen. |
Unter dem Menüpunkt Protokolle/Logs finden Sie alle Informationen über verarbeitete Zahlungen, die Kommunikation mit der PAYONE-Plattform sowie die Bestellübersicht.
Transaktionen
Der Untermenüpunkt Transaktionen zeigt die vom OXID eShop empfangenen Benachrichtigungen des Transaktionsstatus der PAYONE-Plattform für jede Bestellung und Transaktion an. Bei Fehlern können Sie hier herausfinden, ob der Transaktionsstatus korrekt empfangen wurde und wie der aktuelle Status für eine Transaktion ist.
In der Übersicht können Sie alle empfangenen und verarbeiteten Nachrichten des Transaktionsstatus der PAYONE-Plattform sehen. Filteroptionen sind über den einzelnen Spalten verfügbar.
| Feld | Beschreibung |
|---|---|
| Zeit | Zeit, zu der 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. |
| Zahlungsart | Die in dieser Transaktion verwendete Zahlungsart wird hier angezeigt. Folgende Abkürzungen sind möglich: elv - Lastschrift cc - Kreditkarte rec - Rechnung cod - Nachnahme sb - Online-Banküberweisung wlt - e-Wallet (z.B. PayPal) fnc - Finanzierung (z.B. Klarna) |
| Kunden-E-Mail | Die E-Mail-Adresse des Kunden, die in der Bestellung angegeben wurde. |
| Betrag | Der Betrag in der verwendeten Währung. |
| Status | Hier wird der vom Transaktionsstatus der PAYONE-Plattform übertragene 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 der Auswahl eines Eintrags in der Übersicht erhalten Sie alle übertragenen Transaktionsstatus-Informationen durch die PAYONE-Plattform an Ihren OXID eShop. So können Sie jederzeit nachverfolgen, welche Daten Ihr OXID eShop empfangen 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.
API-Protokolle
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 über die Client-API. Der Grund dafür ist, dass diese Anfragen aus Gründen des Payment Card Industry Data Security Standards basierend auf Ajax-Technologie direkt vom Browser des Käufers (Client) an die PAYONE-Plattform gesendet werden, sodass Ihr OXID eShop technisch nicht mit sensiblen Kreditkartendaten in Berührung kommt.
In der Übersicht finden Sie eine Liste aller Anfragen vom OXID eShop an die Server-API mit grundlegenden Informationen. Sie können die Anzeige in den Spaltenüberschriften durch Eingabe von Suchbegriffen filtern.
Der gesamte Inhalt der Request- und Response-Spalten wird durchsucht. Der Inhalt wird in den API-Log-Details näher beschrieben.
| Feld | Beschreibung |
|---|---|
| Zeit | Zeit der Anfrage. |
| Kanal | Der verwendete Kanal. |
| Anfrage | Art der Anfrage. |
| Antwort | Parameter "status" aus der Antwort der PAYONE-Plattform auf die Anfrage. |
API-Log-Details
Nach dem Klick auf eine der in der Übersicht aufgeführten Anfragen sehen Sie alle Parameter der an die PAYONE-Plattform gesendeten Anfrage sowie die entsprechende Antwort von der PAYONE-Plattform.
Bestellungen
Die Bestellübersicht ist eine Standardfunktionalität des OXID eShops. Der PAYONE-Tab 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 dieselbe Übersicht einschließlich des PAYONE-Tabs angezeigt wie unter PAYONE → Protokolle / Logs → Bestellungen.
| Feld | Beschreibung |
|---|---|
| Bestellzeit | Zeit der Bestellung |
| Bezahlt | Zeit für die Meldung der Zahlung von der PAYONE-Plattform. |
| Bestell-Nr. | Bestellnummer des OXID eShops. |
| Kunde | Name, Vorname des Kunden. |
| PAYONE Referenznummer | Die an die PAYONE-Plattform zur eindeutigen Identifikation übertragene Referenznummer. Die Referenznummer wird im Parameter "reference" gespeichert. |
PAYONE-Tab
Im PAYONE-Tab finden Sie das Transaktionskonto im Kontext der Bestellung, in dem alle Forderungen und Zahlungen angezeigt werden. Dies basiert auf den OXID eShop-Anfragen über die Server-API an die PAYONE-Plattform sowie dem Feedback zum Transaktionsstatus von der PAYONE-Plattform.
Sie haben auch die Möglichkeit, Zahlungen für vorautorisierte Zahlungstransaktionen und Rückerstattungen zu erfassen.
| Feld | Beschreibung |
|---|---|
| Referenznummer | Die an die PAYONE-Plattform zur eindeutigen Identifikation übertragene Referenznummer. Die Referenznummer wird im Parameter "reference" gespeichert. |
| PAYONE Vorgangsnummer (TXID) | Die Transaktionsnummer, unter der die Transaktion in der PAYONE-Plattform verarbeitet wurde. |
| Zahlungsart | Zahlungsart, mit der die Bestellung ausgeführt wurde. |
| Zahlungsdetails | Je nach Zahlungsart werden hier detaillierte Informationen über die Zahlung aufgeführt. Bei Kreditkartenzahlungen werden hier die Felder Kartentyp und Maskierte Kartennummer als Information angezeigt. |
| Betrag | Je nach Zahlungsstatus der Bestellung können Sie an dieser Stelle eine Gutschrift (Rückerstattung) auslösen oder eine Zahlungserfassung (Capture) durchführen.
In der Forderungsverwaltung im PAYONE Merchant Interface (PMI) stehen weitergehende Möglichkeiten für die Durchführung von Captures, Rückerstattungen etc. zur Verfügung. Zusätzlich können Sie diese Transaktionstypen über Ihr Warenwirtschaftssystem und/oder über die Server-API der PAYONE-Plattform auslösen.
|
| Transaktionskonto | Alle Forderungen und Zahlungen für die Bestellung werden hier in Form eines Transaktionskontos angezeigt. Alle negativen Beträge werden rot angezeigt. Klicken Sie auf "Zeit", um den entsprechenden Transaktionsstatus zu öffnen. |