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 Magento 2 Plugin wird regelmäßig aktualisiert und bietet eine vielseitige, sofort einsetzbare Lösung für die einfache Akzeptanz von Online-Zahlungen.
Unterstützte Zahlungsarten
💳 Kreditkarten
- Visa (Click to Pay), Mastercard (Click to Pay)
- American Express
- JCB, Diners Club
📱 Digital Wallets
- Apple Pay
- Google Pay
- Amazon Pay (v2)
- PayPal und PayPal Express
- PayPal v2 und PayPal Express v2
- Alipay
- WeChat Pay
- WERO
🏦 PAYONE Lösungen
- PAYONE Secure Invoice
- PAYONE Secured Payments
- PAYONE Lastschrift
- PAYONE Offener Rechnungskauf
- PAYONE Vorkasse
🌍 Lokale Zahlungsarten
- Klarna Payments
- Ratepay Lösungen
- Unzer Payments
- Bancontact, EPS, iDEAL
- PostFinance, Przelewy24
Voraussetzungen
Plugin Installation
Sie haben 2 Möglichkeiten, unser Plugin zu installieren:
Installation via Composer
Führen Sie die folgenden Befehle in Ihrem Magento-Verzeichnis aus:
Installation via GitHub
Laden Sie die neueste Version direkt von GitHub herunter und installieren Sie sie manuell in Ihrer Magento 2 Installation.
Portal Konfiguration
Um den Transaktionsstatus an die richtige Adresse zu senden, loggen Sie sich in das PAYONE Merchant Interface (PMI) ein.
Navigieren Sie zu: Konfiguration → Payment Portals → IHR_PORTAL → Erweitert → TransactionStatus URL
Zusätzliche Response-Daten
In den allgemeinen Einstellungen aktivieren Sie "Additional Response Data" sowohl für Live- als auch für Test-Modi.
Magento 2 - Admin Konfiguration
Klicken Sie auf PAYONE → General
Zugangsdaten eingeben
Bitte geben Sie hier Ihre Zugangsdaten aus dem PMI ein:
Rechnungs-E-Mail Konfiguration
Geben Sie an, ob automatisch eine Rechnungs-E-Mail an den Kunden gesendet werden soll nach einer erfolgreichen Zahlungsautorisierung:
Zahlungsarten einrichten
Klicken Sie auf PAYONE → Payment
Aktivieren/deaktivieren Sie die gewünschten Zahlungsarten im Feld "Enabled".
Spezielle Anpassungen
Bestimmte Zahlungsarten erfordern spezielle Konfigurationen. Die folgenden Punkte sind nur relevant, wenn Sie diese spezifischen Zahlungsarten verwenden:
Diese beiden Zahlungsarten benötigen ein eigenes Zahlungsportal. Bitte geben Sie unter PAYONE → Payment → Secured Invoice (neu) oder Secured Installment → Use Global Settings "No" ein und setzen Sie eine separate Portal-ID.
- Klarna Pay Later
- Klarna Pay Now
- Klarna Slice it
sind in einer Klarna Base Payment Methode gruppiert.
Ratepay erfordert die Konfiguration einer oder mehrerer Shop-IDs, die Sie von Ratepay erhalten. Nach dem Hinzufügen klicken Sie auf "Refresh Ratepay Shop-IDs". Gültige Shop-IDs werden mit ihren von Ratepay konfigurierten Einstellungen angezeigt.
Amazon Merchant ID eingeben
Bitte geben Sie Ihre Amazon Merchant ID in der Zahlungsart ein.
Wählen Sie unter CreditCard-Type die Kreditkarten aus, die Sie anbieten möchten.
Gibt an, ob die CVV/CVC abgefragt wird. Dies ist nur möglich, wenn der Acquirer es erlaubt.
Hier können Sie Click to Pay im Checkout aktivieren und entscheiden, ob sich Kunden für Click to Pay registrieren dürfen.
Die Click to Pay DPA ID wird direkt von PAYONE bereitgestellt.
Unter Card Type wählen Sie aus, welche Kreditkartentypen Sie anbieten möchten.
| Feld | Beschreibung |
|---|---|
| Request BIC | Schaltet um, ob die BIC im Checkout abgefragt wird. Verwenden Sie diese Konfiguration für bessere Kompatibilität mit Bankkonten außerhalb des DACH-Raums |
| Validate Bank Code | Schaltet eine Bankkonto-Prüfung mit "bankaccountcheck" Anfrage ein.
Diese Einstellung ist Teil unseres optionalen Risk Management Moduls
|
| Liste unterstützter SEPA-Länder | Mehrfachauswahl der Länder, aus denen die Zahlungsart Lastschrift unterstützt wird. Die PAYONE-Plattform unterstützt derzeit nur Lastschriften für deutsche Bankkonten. |
| Mandate aktiviert | Wählen Sie Ja / Nein. Soll der SEPA-Mandatsmanager verwendet werden? Eine Prüfung der Bankdaten ist obligatorisch. Eine Prüfung gegen die POS-Sperrliste ist nicht möglich. |
| Mandate Download aktiviert | Wählen Sie Ja / Nein. Wenn Ja ausgewählt ist, wird nach der Bestellung ein Link angeboten, über den der Endkunde das SEPA-Mandat als PDF-Datei herunterladen kann. |
Im Testsystem ist es nicht erforderlich, eine "GooglePay MerchantId" in den GooglePay-Einstellungen einzugeben. Beim Wechsel in die Live-Umgebung muss jedoch die "GooglePay MerchantId" des Händlers hier eingegeben werden.
Sie finden Ihre Merchant-ID oben im Google Merchant Center.
Im Testsystem ist es nicht erforderlich, eine "PayPal Merchant ID" in den PayPal V2-Einstellungen einzugeben. Beim Wechsel in die Live-Umgebung muss jedoch die "PayPal Merchant ID" des Händlers hier eingegeben werden.
Sie finden eine detaillierte Beschreibung, wo Sie Ihre PayPal Merchant ID in Ihrem PayPal-Konto finden.
| Feld | Beschreibung |
|---|---|
| Aktiviert | Ja/Nein |
| Titel | Name der Zahlungsart, der im Checkout erscheint |
| Apple Pay Merchant Id | Dieser Wert kann aus dem Apple Developer Portal als "Identifier" Ihrer Merchant ID übernommen werden: |
| Zertifikatsdatei | Bitte laden Sie Ihr Merchant Identification Certificate aus dem Apple Developer Portal im .pem-Format hoch. Sie können die merchant_id.cer-Datei mit diesem Konsolenbefehl in .pem konvertieren: openssl x509 -inform der -in merchant_id.cer -outform pem -out merchant_id.pem
|
| Private Key Datei | Bitte laden Sie hier die private Key-Datei hoch, die zur Erstellung des Apple Pay CSR verwendet wurde. |
| Private Key Passwort | Hier können Sie das Passwort für die Verwendung des privaten Schlüssels setzen |
| Erlaubte Kartentypen | Wählen Sie hier die Kartentypen aus, die für Apple Pay erlaubt sind. Bitte wählen Sie hier nur die Kartentypen aus, die auch Teil Ihres PAYONE-Vertrags sind. |
Zusätzlich zur Konfiguration in Magento ist es auch notwendig, die entsprechenden Zertifikate einzurichten, um Apple Pay als Zahlungsart zu betreiben. Eine Anleitung dazu finden Sie hier: Besondere Hinweise - Apple Pay
Zusätzlich verlangt Apple eine Validierung der Shop-Domain für Apple Pay. Befolgen Sie dazu die Anweisungen im Apple Developer Portal:
Bestellverwaltung
Klicken Sie auf PAYONE → Orders
Hier finden Sie eine PAYONE-spezifische Bestellübersicht ähnlich der Magento-Bestellübersicht. Zusätzlich zu den Standardinformationen können Sie den Zahlungsstatus auf der PAYONE-Plattform, den genauen Zahlungstyp (z.B. Kreditkartenmarken) und gegebenenfalls den Mahnstatus einsehen. Ein Klick auf View öffnet die Detailansicht der entsprechenden Bestellung.
Vorautorisierte Transaktionen müssen eingezogen werden, um den tatsächlichen Geldfluss auszulösen. Das PAYONE Plugin übernimmt diesen Schritt während der Erstellung der Rechnung für eine bestimmte Bestellung. Unter PAYONE → Orders → Order view → Invoices können Sie den Einzug mit der Rechnungserstellung auslösen.
Durch Auswahl von "Capture Online" in der oben gezeigten Dropdown-Liste wird die Forderung auf der PAYONE-Plattform eingezogen. Wenn Sie das Geld nicht einziehen, aber trotzdem eine Rechnung und Forderung erstellen möchten, wählen Sie stattdessen "Capture Offline".
Teileinzüge sind auch möglich, indem Sie einfach die abrechnungsfähige Menge der Artikel anpassen.
Bereits eingezogene Gelder können durch Erstellen einer Gutschrift für eine bestehende Rechnung zurückerstattet werden.
Öffnen Sie die Rechnungsdetails der zu kreditierenden Rechnung. Klicken Sie oben rechts auf Credit Memo.
Geben Sie hier den zu erstattenden Betrag ein:
Durch Auswahl des "Refund"-Buttons wird Geld an die Zahlungsart des Kunden zurückgesendet. "Refund Offline" erstellt die Gutschrift, löst aber keinen Geldfluss aus.
Teilrückerstattungen sind mit der gleichen Methode wie bei Teileinzügen möglich. Sie können auch die Summe der Rückerstattung anpassen, um Gebühren während der Rückerstattung zu berücksichtigen, bedenken Sie jedoch, dass einige Zahlungsarten darauf angewiesen sind, dass Warenkorbpositionen mit der ursprünglichen Bestellung übereinstimmen.
Erweiterte Konfigurationen
Hier finden Sie separate Einstellungsoptionen, die es Ihnen ermöglichen, unser Plugin genauer an Ihre Bedürfnisse anzupassen.
Klicken Sie auf PAYONE → General → Send invoicing information aktivieren Sie die Übertragung von Artikeldaten zur Erstellung einer Rechnung auf der PAYONE-Plattform.
Der Text kann frei gewählt werden und erscheint als dynamischer Text auf der Rechnung oder Gutschrift. Verschiedene Magento-Variablen können als Platzhalter verwendet werden.
Klicken Sie auf PAYONE → General → Status Mapping können die verschiedenen Transaktionsstatus der PAYONE-Plattform auf Magento-Bestellstatus gemappt werden. Wenn ein neuer Transaktionsstatus empfangen wird, wird der entsprechende "Magento-Status" in der Bestellübersicht im Magento-Backend gesetzt. Dies kann für jeden Zahlungstyp separat eingegeben werden.
Klicken Sie auf PAYONE → General → Payment Creditcard → Input configuration → Custom styling hosted-Iframe
| Feld | Beschreibung |
|---|---|
| Aktiv | Ja/Nein |
| Stellenanzahl | Länge des Feldes in Zeichen (HTML-Attribut size) |
| Breite | CSS - Spezifiziert Breite |
| CSS | Spezifikation von CSS-Eigenschaften für das Feld Deaktiviert bei vorheriger Auswahl von Standard |
| Höhe | CSS - Angabe der Höhe |
| iFrame | Standard - Verwendet Breite und Höhe aus Standard-Stil Custom - Verwendet Breite und Höhe aus den folgenden Feldern |
| Sprache | Wählen Sie die Sprache aus, in der die Fehlermeldung ausgegeben werden soll. |
| Standard-Stil | Input - CSS-Spezifikation für alle Eingabefelder (HTML input) Selection - CSS-Spezifikation für alle Auswahlfelder (HTML select) |
| Stil | Standard - Verwendet CSS-Spezifikation aus Standard Custom - Verwendet CSS-Spezifikation aus dem folgenden Feld |
| Typ | Numeric - Nur Zahlen sind erlaubt und für mobile Geräte wird die numerische Tastatur verwendet input type="tel" Password - input type="password" Text - input type="text" |
| Max-Stellen | Maximale Länge der Eingabe (HTML-Attribut maxlength) |
Vorschau
An dieser Stelle können Sie sehen, wie das Aussehen entsprechend der vorherigen Einstellung der Kreditkarten-Zahlungsart im Checkout aussieht.
Klicken Sie auf PAYONE → Logs
Im Logs-Bereich finden Sie alle Informationen über die verarbeiteten Zahlungen und die Kommunikation mit der PAYONE-Plattform.
API Logs
In dieser Übersicht finden Sie alle Anfragen vom Magento-Shop an die PAYONE-Plattform sowie die Antworten der PAYONE-Plattform auf diese Anfragen. Nur die Anfragen, die über die Client-API an die PAYONE-Plattform übertragen wurden, sind in dieser Übersicht nicht aufgeführt.
Transaktionsstatus Logs
Der Transaktions-Untermenüpunkt zeigt die von Magento empfangenen Transaktionsstatus-Benachrichtigungen für jede Bestellung und Transaktion an. Diese Benachrichtigungen werden von der PAYONE-Plattform an Ihren Shop gesendet.
