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 WooCommerce 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, Mastercard, American Express
- JCB, Diners Club
📱 Digitale Wallets
- Google Pay
- Amazon Pay (v2)
- PayPal und PayPal Express
- PayPal v2 und PayPal Express v2
- Alipay
- WERO
🏦 PAYONE Lösungen
- PAYONE Sicherer Rechnungskauf
- PAYONE Gesicherte Zahlungen
- PAYONE Lastschrift
- PAYONE Offener Rechnungskauf
- PAYONE Vorkasse
🌍 Lokale Zahlungsarten
- Klarna Payments
- Ratepay Lösungen
- Bancontact
- EPS, iDEAL
- Przelewy24
Voraussetzungen
Plugin Installation
Sie haben 2 Möglichkeiten, unser Plugin zu installieren:
Installation direkt in WooCommerce - Admin
- Laden Sie das kostenlose PAYONE Plugin aus dem WordPress Store herunter.
- Laden Sie das Plugin in Ihrem Shop unter WooCommerce → Plugins → Neu hinzufügen hoch.
- Installieren und aktivieren Sie das Plugin.
Installation via GitHub
Laden Sie die neueste Version direkt von GitHub herunter und installieren Sie sie manuell in Ihrer WooCommerce Installation.
Extrahieren Sie das Archiv nach: /wp-content/plugins/payone-woocommerce-3
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 auf "an".
Es ist wichtig, dass die Permalink-Einstellungen unter Einstellungen → Permalinks nicht auf "Einfach" gesetzt sind.
WooCommerce - Admin Konfiguration
Klicken Sie auf PAYONE. Bitte geben Sie hier Ihre Zugangsdaten ein:
Durch Klicken auf "Test API Einstellung" können Sie prüfen, ob Ihre Daten korrekt eingegeben wurden.
| Feld | Beschreibung |
|---|---|
| Merchant-ID | Sie finden Ihre PAYONE Merchant ID oben rechts im PAYONE Merchant Interface (PMI) und auf allen PAYONE Rechnungen. |
| Portal-ID | Sie finden die Portal ID im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Zahlungsportale |
| Subaccount-ID | Sie finden die ID im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Konten |
| Schlüssel | Bitte geben Sie hier den Schlüssel ein, um die Datenkommunikation gegen Manipulation zu schützen. Dieser muss identisch mit dem im entsprechenden PAYONE Zahlungsportal hinterlegten Schlüssel sein. |
| Modus | Hier können Sie für die jeweilige Zahlungsart angeben, ob die Zahlungen im Testmodus verarbeitet werden sollen oder ob sie "live" ausgeführt werden sollen. Sie können auch den Testmodus für einzelne Zahlungsarten konfigurieren. |
| Warenkorb übermitteln | Hier können Sie konfigurieren, ob die Warenkorbinformationen bei jeder Anfrage an die PAYONE Plattform übertragen werden sollen. |
| PDF Download aktivieren | Wenn aktiviert, 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.
|
| Dynamischer Rechnungstext | Gibt an, ob und (wenn ja) welcher dynamische Text auf einer von PAYONE generierten Rechnung erscheinen soll.
Der Inhalt des Feldes wird im Parameter "invoiceappendix" übertragen. Die maximale Länge beträgt 255 Zeichen und verschiedene WooCommerce-Variablen können als Platzhalter verwendet werden. Sie können {{order}} verwenden, um die aktuelle Bestellnummer in WooCommerce in der Anfrage zu referenzieren.
|
| Dynamischer Erstattungstext | Sie können den dynamischen Text angeben, der auf von der PAYONE Plattform erstellten Gutschriften erscheint. (siehe oben) |
| API-Log | Gibt an, ob das Log für API-Aufrufe von WooCommerce an PAYONE aktiviert werden soll.
Die API-Logs können persönliche Informationen enthalten. Bitte fragen Sie Ihren Rechtsberater oder Datenschutzbeauftragten zu datenschutzrechtlichen Auswirkungen.
|
| Transaktionsstatus Log | Gibt an, ob ein Log über die vom Shop-System empfangenen Transaktionsstatusmeldungen geführt werden soll.
|
Die erforderlichen Daten für die Einrichtung finden Sie im PMI:
Zahlungsarten Einrichtung
Sie können auf die Einstellungen für die einzelnen Zahlungsarten über das WooCommerce-Menü zugreifen (WooCommerce → Einstellungen → Zahlungen). Zahlungsarten, die vom PAYONE Plugin bereitgestellt werden, sind mit dem Präfix "PAYONE" gekennzeichnet.
Konfigurationsoptionen
Alle Zahlungsarten bieten bestimmte Grundoptionen.
| Feld | Beschreibung |
|---|---|
| Aktivieren/Deaktivieren | Gibt an, ob die Zahlungsart im Checkout angezeigt werden soll. |
| Titel | Gibt den Namen der Zahlungsart im Checkout an. |
| Kundennachricht | Hier können Sie eine zusätzliche Nachricht definieren, die angezeigt wird, wenn Sie die Zahlungsart auswählen. |
| Mindestbestellwert | Die Zahlungsart wird erst ab diesem Warenkorbwert angezeigt. |
| Höchstbestellwert | Die Zahlungsart wird nicht mehr angezeigt, wenn der Warenkorbwert diese Summe überschreitet. |
| Autorisierungsmethode | Gibt an, ob die Zahlungsart durch "Autorisierung" oder "Vorautorisierung" angesprochen wird.
Welche Autorisierungsmethode für welche Zahlungsart verwendet wird, kann Auswirkungen auf den Cashflow haben. Welche Methode Sie verwenden sollten, hängt stark vom Geschäftsmodell und der Zahlungsart ab.
|
| Aktive Länder | In welchen Ländern soll die ausgewählte Zahlungsart aktiv sein? Standardmäßig sind Deutschland, Österreich und die Schweiz aktiv. Sie können weitere Länder durch "Strg+Klick" hinzufügen oder abwählen. |
| Globale Einstellungen verwenden | Mit dieser Option können die globalen Einstellungen für den Shop für spezifische Zahlungsarten überschrieben werden.
|
Spezielle Anpassungen
Einige Zahlungsarten erfordern spezielle Anpassungen. Die nächsten Punkte sind nur für Sie relevant, wenn Sie die spezifische Zahlungsart verwenden:
Diese beiden Zahlungsarten erfordern ihr eigenes Zahlungsportal. Bitte geben Sie unter WooCommerce → Einstellungen → Zahlungen → PAYONE Gesicherter Rechnungskauf bzw. PAYONE Gesicherte Ratenzahlung → Globale Einstellungen verwenden "nein" → Portal ID eine separate Portal ID ein.
| Feld | Beschreibung |
|---|---|
| Kreditkartenmarke | Hier können Sie die Kreditkartenmarken aktivieren, die für den Checkout verwendet werden sollen. Sie können auch benutzerdefinierte Namen für die einzelnen Marken definieren. |
| Mindestgültigkeit der Karte | Gibt die Anzahl der Tage an, die eine verwendete Kreditkarte für eine Transaktion noch gültig sein muss.
Gutschriften auf abgelaufene Kreditkarten sind nicht möglich.
|
Benutzerdefinierte Anzeige für das gehostete iFrame
Die WooCommerce Erweiterung bietet 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 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 |
|---|---|
| Typ |
|
| Stellenanzahl | Länge des Feldes in Zeichen (HTML-Attribut size) |
| Max Stellen | Maximale Länge der Eingabe (HTML-Attribut maxlength) |
| IFrame |
|
| Breite | CSS - Breite angeben |
| Höhe | CSS - Höhe angeben |
| Stil |
|
| CSS | Spezifikation von CSS-Eigenschaften für das Feld. Deaktiviert, wenn Standard zuvor ausgewählt wurde.
Alle CSS-Eigenschaften außer "url" sind erlaubt. Die folgenden Zeichen sind verboten: "\", "/", "?", "<" und ">"
|
| Standardstil | |
| Texteingabe | CSS-Spezifikation für alle Eingabefelder (HTML input) |
| Auswahl | CSS-Spezifikation für alle Auswahlfelder (HTML select) |
| Fehlerausgabe | |
| Fehlerausgabe aktiv | Gibt an, ob Kartenzahlungsfehler im Checkout angegeben werden sollen. |
| Fehlerausgabe aktiv (Sprache) | Wählen Sie die Sprache aus, in der die Fehlermeldung zurückgegeben werden soll. |
Bei dieser Zahlungsart ist eine sorgfältige Auswahl der Autorisierungsmethode besonders wichtig. Da bei "Autorisierung" die Forderung sofort auf der PAYONE Plattform geschrieben wird, sendet die Plattform auch sofort eine entsprechende Rechnung. Sie sollten diese Autorisierungsmethode daher vor allem dann verwenden, wenn Sie die Leistung sofort erbringen.
Bearbeitung der Bestellungen
Bestellungen, die über die PAYONE Erweiterung für WooCommerce aufgegeben wurden, werden wie gewohnt in der Bestellübersicht von WooCommerce aufgelistet. Die Bestellbearbeitung unterscheidet sich je nach der verwendeten Autorisierungsmethode zur Verarbeitung der Bestellung.
Einzug (Capture)
Bestellungen, die mit der Autorisierungsmethode "Vorautorisierung" aufgegeben wurden, erhalten nach der Bestellung den Status "Wartend".
Nur eine Statusänderung auf "In Bearbeitung" aktiviert die Forderung auf der PAYONE Plattform und leitet (wo möglich) den Einzug der Gelder ein. Setzen Sie den Status auf "In Bearbeitung" und klicken Sie auf den blauen "Aktualisieren" Button rechts.
Der Einzug wird dann auf der PAYONE Plattform eingeleitet und in den Bestellnotizen bestätigt:
Mögliche Fehler können auch in den Bestellnotizen gefunden werden.
- Kreditkarte - 7 Tage (manchmal länger, variiert von Bank zu Bank)
- PayPal - 29 Tage
- PAYONE Sicherer Rechnungskauf - 28 Tage
Erstattung
Gutschriften verwenden den bekannten WooCommerce Gutschriftenprozess. Ein Klick auf den Button "Erstattung" in der Bestellung öffnet das Menü für Gutschriften:
Hier können Sie den gutgeschriebenen Betrag und einen Grund eingeben. Wichtig: "Manuell erstatten" schreibt das Geld nicht auf der Zahlungsart gut, sondern nur in WooCommerce. Verwenden Sie diese Option nur, wenn Sie kein Geld zurücküberweisen möchten oder wenn Sie andere Wege als die PAYONE Plattform verwenden.
Erweiterte Konfigurationen
Hier finden Sie separate Einstellungsoptionen, die es Ihnen ermöglichen, unser Plugin genauer an Ihre Bedürfnisse anzupassen.
API Log
Unter "API-Log" finden Sie die detaillierten API-Aufrufe, die WooCommerce an die PAYONE Plattform sendet. Hier finden Sie auch detaillierte technische Informationen zur Antwort der PAYONE API.
Transaktionsstatus Log
Das Transaktionsstatus Log zeigt alle Rückmeldungen zu getätigten Zahlungen an, die der Shop von der PAYONE API erhält.
Es ist wichtig, dass die Permalink-Einstellungen unter Einstellungen → Permalinks nicht auf "Einfach" gesetzt sind.
Häufige Probleme und Lösungen
Problem: Zahlungen werden nicht verarbeitet
- Überprüfen Sie die API-Einstellungen im PAYONE Admin-Bereich
- Stellen Sie sicher, dass die TransactionStatus URL korrekt konfiguriert ist
- Prüfen Sie die API-Logs auf Fehlermeldungen
Problem: Kreditkarten-iFrames werden nicht angezeigt
- Überprüfen Sie die CSS-Einstellungen für die iFrames
- Stellen Sie sicher, dass keine "url"-Eigenschaften in den CSS-Einstellungen verwendet werden
- Prüfen Sie die Browser-Konsole auf JavaScript-Fehler
Problem: Transaktionsstatus wird nicht empfangen
- Überprüfen Sie die TransactionStatus URL im PMI
- Stellen Sie sicher, dass die Permalink-Einstellungen korrekt sind
- Prüfen Sie das Transaktionsstatus Log auf eingehende Nachrichten