Integration
Unser WooCommerce Plugin wird regelmäßig aktualisiert und bietet eine vielseitige, sofort einsetzbare Lösung für die einfache Akzeptanz von Online-Zahlungen.
Sie haben 2 Möglichkeiten, unser Plugin zu installieren:
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
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
Unter Allgemein setzen Sie die zusätzlichen Response-Daten sowohl für Live als auch für Test auf "an".
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:
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.
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.
|
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.
|
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.
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.
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.
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.
Hier finden Sie separate Einstellungsoptionen, die es Ihnen ermöglichen, unser Plugin genauer an Ihre Bedürfnisse anzupassen.
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.
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.