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:
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:
Ab Pluginversion 2.1.0: <SHOPURL>/wc-api/payoneplugin/
Bei alten Pluginversionen: <SHOPURL>/payone-callback/
Setzen Sie das Feld Verfahren Hashwert-Prüfung nicht auf sha2-384, sonst ist keine Kommunikation zwischen Shop und PAYONE möglich.
Additional Response-data
Setzen Sie unter General, die Additional Response-data sowohl für Live als auch für Test auf "on".
Konfiguration im Woocommerce - Admin
Klicken Sie unter PAYONE. Bitte geben Sie hier Ihre Zugangsdaten ein:
- Die erforderlichen Daten für die Einrichtung finden Sie in der PMI
Permalinks in Wordpress
Es ist wichtig, dass die Gebräuchliche Einstellungen unter Einstellungen → Permalinks nicht auf "Einfach" gesetzt wird.
Aktivieren der Zahlungsarten
Die Einstellungen zu den einzelnen Zahlungsarten finden Sie unter WooCommerce → Einstellungen → Zahlungen. Die vom PAYONE Plugin angebotenen Zahlungsmethoden sind mit dem Präfix "PAYONE" gekennzeichnet.
Allgemeine Konfigurationen
Alle Zahlungsarten bieten bestimmte grundlegende Optionen.
Feld | Beschreibung |
|---|---|
Aktivieren/Deaktivieren | Gibt an, ob die Zahlungsart im Checkout angezeigt werden soll. |
Bezeichnung | Gibt den Namen der Zahlungsart an. |
Kundennachricht | Hier können Sie eine zusätzliche Nachricht definieren, die bei der Auswahl der Zahlungsart angezeigt wird. |
Minimaler Wert der Bestellung | Die Zahlungsart wird erst ab diesem Warenkorbwert angezeigt. |
Maximaler Wert der Bestellung | Die Zahlungsart wird nicht mehr angezeigt, wenn der Wert des Warenkorbs diese Summe übersteigt. |
Methode der Autorisierung |
|
| Aktive Länder | In welchen Ländern soll die ausgewählte Zahlungsmethode aktiv sein? Standardmäßig sind Deutschland, Österreich und die Schweiz aktiv. Sie können weitere Länder mit "Strg+Klick" hinzufügen oder abwählen. |
| Benutze die globalen Einstellungen | Mit dieser Option können die globalen Einstellungen für die einzelnen Zahlungsarten überschrieben 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:
Kreditkarte
Feld | Beschreibung |
|---|---|
Kreditkartenfirmen | Hier können Sie die Kreditkarten aktivieren, die für den Checkout verwendet werden sollen. Sie können auch benutzerdefinierte Namen für die einzelnen Markierungen festlegen. |
| Minimale Gü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 die gehosteten iframes
Unser Plugin bietet Ihnen 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 unser Plugin iFrames, die in den Checkout integriert sind. 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 |
|---|---|
Typ |
|
| Länge | Length of the field in characters ( HTML attribute size ) |
| Max. Anzahl Zeichen | Maximal zulässige Anzahl von Zeichen (HTML attribute maxlength) |
| IFrame |
|
| Breite | CSS - Spezifiziert width |
| Höhe | CSS - Spezifiziert height |
| Stil |
|
| CSS | Spezifikation der CSS-Eigenschaften für das Feld. Alle CSS-Eigenschaften außer "url" sind zulässig. Die folgenden Zeichen sind verboten: "\", "/", "?", "<" und ">" |
| Standard Style |
|
| IFrame |
|
| Fehlerausgabe | |
| Fehlerausgabe aktiv | Gibt an, ob Fehler bei der Kartenzahlung im Checkout angegeben werden sollen. |
| Fehlerausgabe aktiv (Sprache) | Wählen Sie die Sprache, in der die Fehlermeldung ausgegeben werden soll. |
PAYONE Lastschrift
Feld | Beschreibung |
|---|---|
Check bank data | Gibt an, ob die IBAN vor der Zahlung geprüft werden soll. |
Use PAYONE Mandate Management | Gibt an, ob die Mandatsverwaltung von PAYONE genutzt werden soll..
Ohne gültiges Mandat kann der Kunde die Lastschrift bis zu 13 Monate nach der Zahlung über die Bank widerrufen! |
Download mandates as PDF | Ist diese Funktion aktiviert, wird das SEPA-Mandat dem Endkunden nach dem Bestellvorgang zum Download angeboten (nur wenn PAYONE Mandatsmanagement aktiv ist). |
PAYONE Gesicherter Rechnungskauf
Diese Zahlungsart muss eine andere Portal ID erhalten. Außerdem ist hier immer die Übertragung der Warenkorbdaten aktiv.
Feld | Beschreibung |
|---|---|
Portal ID | Portal ID des entsprechenden Zahlungsportals für den PAYONE gesicherten Rechnungskauf aus Ihrem PMI |
Schlüssel | Der entsprechende Schlüssel |
Bei dieser Zahlungsart ist die sorgfältige Auswahl der Autorisierungsmethode besonders wichtig. Da bei "Autorisierung" die Forderung sofort auf die 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.
Bearbeiten der Bestellungen
PAYONE Bestellungen, werden wie gewohnt in der Bestellübersicht von WooCommerce aufgeführt. Die Bestellabwicklung unterscheidet sich je nach Autorisierungsmethode, mit der die Bestellung angelegt wurde.
Erfassung/ Capture
Aufträge, die über die Autorisierungsmethode "Vorautorisierung" erteilt werden, erhalten nach der Auftragserteilung den Status "Zahlung ausstehend".
Erst eine Statusänderung auf "In Bearbeitung" aktiviert die Forderung auf der PAYONE Plattform und leitet den Einzug der Gelder ein. Setzen Sie den Status auf "In Bearbeitung" und klicken Sie auf die blaue Schaltfläche "Aktualisieren" auf der rechten Seite.
Der Einzug wird dann auf der PAYONE Plattform veranlasst und in den Bestell Anmerkungen dargestellt:
Mögliche Fehler sind ebenfalls in den Bestell Anmerkungen dargestellt.
Reservierte Zahlungen werden nicht auf unbestimmte Zeit reserviert. Sie sollten daher darauf achten, Aufträge rechtzeitig nach einer Vorautorisierung auf "Bearbeitung" zu setzen und damit die Zahlung einzuziehen bzw. die Forderung zu schreiben. Hier finden Sie einige (unverbindliche) Richtwerte für die Gültigkeit der Reservierung:
Kreditkarte - 7 Tage (manchmal länger, variiert von Bank zu Bank)
PayPal - 29 Tage
PAYONE Sicherer Rechnungskauf - 28 Tage
Gutschrift/ Refund
Gutschriften nutzen den bekannten WooCommerce-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: "Manuelle Rückerstattung" schreibt das Geld nicht auf der Zahlungsmethode gut, sondern nur in WooCommerce. Nutzen Sie diese Option nur, wenn Sie kein Geld zurücküberweisen wollen oder wenn Sie andere Wege als die PAYONE Plattform nutzen.
Aufgrund von Einschränkungen in der Bestellverwaltung von WooCommerce wird bei Gutschriften mit Warenkorbübertragung immer der Standardsteuersatz des Shops für den gesamten Gutschriftsbetrag übertragen. Dies ist insbesondere dann wichtig, wenn die PAYONE Plattform den Belegversand für Sie übernimmt. Dies ist z.B. bei der Zahlungsart PAYONE Sichere Rechnung der Fall.
Wenn Sie einen Warenkorb gutschreiben möchten, der Artikel mit unterschiedlichen Steuersätzen oder gemischten Steuersätzen enthält, nutzen Sie bitte die Gutschriftfunktion in der PAYONE Händleroberfläche. Dort haben Sie die Möglichkeit, einzelne Warenkorbpositionen zusammen mit dem Steuersatz anzulegen, die dann auf dem Beleg korrekt ausgewiesen werden.
Erweiterte Konfigurationen
Hier finden Sie separate Einstellungsmöglichkeiten, mit den Sie unser Plugin genauer an Ihre Bedürfnisse anpassen können.
Logs
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 über den Response an die PAYONE API.
Transaction Status Log
Das Transaktions-Statusprotokoll zeigt alle Rückmeldungen zu erfolgten Zahlungen an, die der Shop von der PAYONE API erhält.
Fakten im Überblick
Payment methods + Features
Visa
Mastercard
American Express
JCB
Diners Club
Maestro International
China Union Pay
Alipay
paydirekt
PayPal
PayPal Express
Cash On Delivery
PAYONE Direct Debit
PAYONE Invoice
PAYONE Prepayment
Bancontact
EPS
Giropay
iDEAL
PostFinance Card
Sofort
Klarna Pay Later
Klarna Pay Now
Klarna Slice It
PAYONE Secure Invoice
Open Source
Transactionstatus URL:
<SHOPURL>/wc-api/payoneplugin/
Latest Release
- New payment method: PayPal Express
- New payment method: Bancontact
- New payment method: iDEAL
- Using WC_API for callbacks
- The Transactionstatus URL has to be changed to <SHOPURL>/wc-api/payoneplugin/.
- The old Transactionstatus URL is temporarily still reachable.
Bugfix(es)
- Better generating of unique reference numbers
- TX-Log corrections
tested with
wordpress version: 5.9.2
woocommerce version: 6.4.0
Download