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
Einleitung
Unser Shopware 5 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
📱 Digitale 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 gesicherte Rechnung
- PAYONE gesicherter Rechnungskauf, gesicherte Lastschrift und gesicherter Ratenkauf
- PAYONE Lastschrift
- PAYONE offene Rechnung
- PAYONE Vorkasse
🌍 Lokale Zahlungsarten
- Klarna Payments
- Ratepay Rechnungskauf, Lastschrift und Ratenkauf
- Unzer Rechnungskauf, Lastschrift und Ratenkauf
- Bancontact, EPS, iDEAL
- PostFinance Card und E-Finance
- Przelewy24
Voraussetzungen
Installation des Plugins
Sie haben 2 Möglichkeiten unser Plugin zu installieren:
Installation direkt im Shopware 5 - Admin
- Laden Sie unser aktuelles Plugin aus GitHub herunter
- Unter Einstellungen → Plugin Manager → Installiert → Plugin hochladen können Sie das Plugin hochladen
- 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 Shopware 5 Installation.
Konfiguration im PAYONE Portal
Um den Transaktionsstatus an die richtige Adresse zu senden, melden Sie sich bitte im PAYONE Merchant Interface (PMI) an.
Navigieren Sie zu: Konfiguration → Zahlungsportale → IHR_PORTAL → Erweitert → TransactionStatus URL
Additional Response-data
Setzen Sie unter General, die Additional Response-data sowohl für Live als auch für Test auf "on".
Konfiguration im Shopware 5 Admin
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Grundeinstellungen → Allgemein
Sie können für jede Zahlungsart eine eigene Konfiguration erstellen. Die Standardeinstellung - Alle (global) gilt für alle Zahlungsarten.
Tragen Sie hier bitte Ihre Zugangsdaten ein:
Sobald Sie eine separate Konfiguration für eine Zahlungsart erstellt haben, gilt für die Zahlungsart die Standardeinstellung - Alle (global) nicht mehr.
| Feld | Beschreibung |
|---|---|
| Merchant-ID | Ihre PAYONE Merchant ID finden Sie oben rechts im PAYONE Merchant Interface (PMI) und auf allen PAYONE Rechnungen. |
| Portal-ID | Die Portal-ID finden Sie im PAYONE Merchant Interface (PMI) unter dem Menüpunkt Konfiguration → Zahlungsportale |
| Subaccount-ID | Die ID finden Sie 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. |
| Betriebsmodus | Hier können Sie für die jeweilige Zahlungsart festlegen, 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. |
| Autorisierung | Vorautorisierung - Der zu zahlende Betrag wird im Verlauf der Bestellung reserviert. In diesem Fall muss die Abbuchung in einem zweiten Schritt bei der Warenlieferung eingeleitet werden (Capture). Autorisierung - Der zu zahlende Betrag wird sofort bei Auftragserteilung eingezogen. Die Forderung wird sofort auf der PAYONE Plattform gebucht. |
| Warenkorbübergabe | Hier können Sie konfigurieren, ob die Warenkorb-Informationen bei jeder Anfrage an die PAYONE Plattform übertragen werden sollen. In den meisten Fällen ist es sicher, diese Einstellung aktiviert zu lassen. |
| Speichern der AGB Bestätigung | Aus - Schaltet die Speicherung der AGB-Bestätigung komplett ab. Auf der Confirm-Seite - Die Speicherung wird nur auf der Bestätigungsseite aktiviert. Global - Aktiviert die globale Speicherungseinstellung. |
| Benutze Shopware-Bestellnummer | Diese Einstellung bewirkt, dass eine vom Plugin generierte Bestellnummer als Referenz zu PAYONE gemeldet wird. Hinweis: Diese Bestellnummer muss immer eindeutig sein und kann nicht wieder verwendet werden. |
| Bestellung geändert bei TX Status | Aktualisiert den Zeitstempel der Auftragsänderung auf dem Auftrag, wenn eine neue Benachrichtigung über den Transaktionsstatus eingeht und verarbeitet wurde. Hinweis: Dies funktioniert nur in Shopware 5.5 und höher. |
| Abweichende Lieferadressen zulassen | Bei den gesicherten Zahlungsarten von PAYONE muss die Möglichkeit, an abweichende Lieferadressen zu versenden, vertraglich vereinbart sein. Erst dann kann diese Option genutzt werden. |
Aktivieren der Zahlungsarten
Wenn Sie das PAYONE Plugin installieren, werden alle verfügbaren PAYONE-Zahlungsarten automatisch in Ihrem Shop angelegt. Zur leichteren Identifizierung werden diese mit dem Präfix "PAYONE" angelegt.
Aktivieren Sie die gewünschten Zahlungsarten unter Einstellungen → Zahlungsarten
Spezielle Anpassungen
Einige Zahlungsarten benötigen spezielle Anpassungen. Die nächsten Punkte sind für Sie nur interessant, wenn Sie die jeweilige Zahlungsart nutzen:
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Zahlungsarten → Lastschrift
| Feld | Beschreibung |
|---|---|
| Bankdaten prüfen | Schaltet eine Überprüfung der Bankverbindung mittels "bankaccountcheck"-Anforderung ein. Diese Einstellung ist Teil unseres optionalen Risk Management Moduls. |
| Zusätzlich Kontonummer / Bankleitzahl anzeigen | Veraltete Abfrage. Heute nur noch wenig sinnvoll. |
| Zusätzlich zur IBAN auch BIC abfragen? | Bestimmt, ob die BIC im Checkout abgefragt wird. Verwenden Sie diese Konfiguration für eine bessere Kompatibilität mit Bankkonten von außerhalb der DACH-Region. |
| Mandatserteilung aktivieren? | Soll der SEPA-Mandatsmanager verwendet werden? Eine Prüfung der Bankverbindung ist obligatorisch. Eine Prüfung gegen die POS-Sperrliste ist nicht möglich. |
| Download Mandat als PDF? | Bei der Auswahl "Ja" wird nach der Bestellung ein Link angeboten, über den der Endkunde das SEPA-Mandat als PDF-Datei herunterladen kann. |
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Zahlungsarten → Apple Pay
| Feld | Beschreibung |
|---|---|
| Apple Pay MerchantId | Diesen Wert können Sie dem Apple Developer Portal als "Identifier" Ihrer Merchant ID entnehmen. |
| Apple Pay Visa erlauben | Bitte geben Sie an, ob Visa-Karten für Apple Pay-Transaktionen in Ihrem PAYONE-Vertrag enthalten sind. |
| Apple Pay Mastercard erlauben | Bitte geben Sie an, ob Mastercard-Karten für Apple Pay-Transaktionen in Ihrem PAYONE-Vertrag enthalten sind. |
| Apple Pay Girocard erlauben | Bitte geben Sie an, ob Girocard-Karten für Apple Pay-Transaktionen in Ihrem PAYONE-Vertrag enthalten sind. |
| Apple Pay Zertifikat | Bitte laden Sie hier Ihr Apple Pay Zertifikat (im .pem Format) hoch. Achten Sie darauf, dass das Zertifikat nicht öffentlich aufrufbar ist und nur für Shopware lesbar ist. |
| Apple Pay Private Key | Bitte laden Sie hier Ihr Apple Pay Private Key (im .key Format) hoch. |
| Apple Pay Private Key Passwort | Hier können Sie das Passwort zur Verwendung des Private Keys festlegen. |
| Apple Pay Debug | Wenn dieses Feld aktiviert ist, werden im Checkout Debug-Informationen zur Apple Pay-Session angezeigt, die bei der Einrichtung helfen können. Im Live-Betrieb sollte diese Option deaktiviert sein. |
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Zahlungsarten → Kreditkarte
Benutzerdefinierte Anzeige für die gehosteten iFrames
Unser Plugin bietet Ihnen Konformität mit dem "niedrigsten" PCI DSS Compliance Level (SAQ A). Sie können die iFrame-Felder mit verschiedenen Styling-Optionen anpassen.
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Zahlungsarten → Kreditkarte (Click to Pay)
Tragen Sie hier die DPA-ID ein. Diese erhalten Sie von PAYONE. In den Einstellungen können Sie Click to Pay aktivieren und deaktivieren. Auch können Sie entscheiden, ob die Registrierung bei Click to Pay für Kunden möglich sein soll.
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Zahlungsarten → PayPal Express
| Feld | Beschreibung |
|---|---|
| Vorläufige Versandkosten bei PayPal Express übergeben | Nein - Wenn die Versandkosten im Warenkorb noch nicht bekannt sind. Ja - Wenn die Versandkosten pauschal sind und deshalb mit übergeben werden können. |
| PayPal ECS Button auf Warenkorbseite anzeigen? | Ja - Button wird auf der Warenkorbseite angezeigt. Nein - Button wird auf der Warenkorbseite ausgeblendet. |
| Konfiguration PayPal Express Logos | Hier muss das PayPal Express Logo hochgeladen werden und die Packstation-Abfrage wird in diesem Bereich konfiguriert. Wenn keine Bilddatei verfügbar ist, wird der PayPal ECS-Button im Warenkorb nicht angezeigt. |
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Zahlungsarten → PayPal Express V2
Klicken Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Zahlungsarten → Ratepay
Damit die Ratepay-Zahlungsmethode reibungslos funktioniert, müssen Sie einige zusätzliche Konfigurationsdaten eingeben, die Ratepay festgelegt hat. Verwenden Sie den Button „Hinzufügen", um weitere Ratepay-Konfigurationen hinzuzufügen.
| Feld | Beschreibung |
|---|---|
| ShopId | Die von Ratepay angegebene Shop-ID. Diese stellt einen Konfigurationsdatensatz dar (Land, Währung, Zinsen, Laufzeiten etc.). |
| Währung | Währung, die für diese Shop-ID verwendet werden soll. |
| Ratenkauf Modus | Vorkasse - Der Käufer muss die Raten auf ein von Ratepay benanntes Konto überweisen. Lastschrift - Die Raten werden per Lastschrift vom Konto des Käufers eingezogen. |
Speichern Sie die Konfiguration und rufen Sie dann die Daten von RatePay mit "Ratepay Konfiguration abrufen" ab.
Diese beiden Zahlungsarten benötigen ein eigenes Zahlungsportal. Bitte wählen Sie unter Kunden → Zahlungen → PAYONE Kontrollzentrum die Zahlungsarten: PAYONE Gesicherter Rechnungskauf bzw. PAYONE Gesicherter Ratenkauf aus und tragen eine separate Portal ID ein.
Erweiterte Konfigurationen
Hier finden Sie separate Einstellungsmöglichkeiten, mit denen Sie unser Plugin genauer an Ihre Bedürfnisse anpassen können.
Erfassung / Capture
Unter Kunden → Bestellungen können Sie vorautorisierte Bestellungen erfassen. Dazu müssen Sie die jeweilige Bestellung mit einem Klick auf den Stift bearbeiten.
Die zu erfassenden Posten müssen markiert werden (Häkchen setzen) und dann mit dem Button "Positionen einziehen" bestätigt werden.
Gutschrift / Refund
Unter Kunden → Bestellungen können Sie Gutschriften erstellen. Dazu müssen Sie die jeweilige Bestellung mit einem Klick auf den Stift bearbeiten.
Markierung von auffälligen Bestellungen
Wenn es zu Unstimmigkeiten bei einer Bestellung kommt, wird die Bestellung mit dem Status "Überprüfung notwendig" markiert. In diesem Fall sollte der Betrag im Shopware 5 mit dem Betrag im PAYONE Merchant Interface (PMI) kontrolliert werden, da es sich hier um einen Betrugsversuch handeln könnte.
Die folgenden Optionen können Sie nur nutzen, wenn Sie das Modul Protect bei PAYONE bestellt haben. Der Einsatz von Adressprüfungen ist mit variablen Kosten pro Transaktion verbunden.
Unter Kunden → Zahlungen → PAYONE → Konfiguration → Reiter "Adressüberprüfung" können Sie festlegen, ob und in welcher Form die Adressprüfungen durchgeführt werden sollen und wie sich der Shopware eShop verhalten soll, wenn bestimmte Ergebnisse zutreffen.
| Feld | Beschreibung |
|---|---|
| Aktiv | Aktiviert die Adressprüfung |
| Betriebsmodus | Einstellung in welchem Modus die Adressprüfung stattfinden soll: im Test oder Live. Test- und Livedaten unterscheiden sich. |
| Rechnungsadresse | Nicht prüfen - Es findet keine Adressprüfung statt Basic - Adressprüfung auf Existenz und Korrektur Person - Überprüfung, ob die Person unter der angegebenen Adresse bekannt ist (nur Deutschland) |
| Automatische Korrektur | Wenn Ja ausgewählt ist, wird eine von der PAYONE Plattform korrigierte Adresse übernommen. |
| Minimaler Warenwert | Warenkorbwert, ab dem eine Adressprüfung durchgeführt wird |
| Gültigkeit in Tagen | Dauer in Tagen für registrierte Benutzer im Shop, für die das Ergebnis der Überprüfung gültig ist. |
Die folgenden Optionen können Sie nur nutzen, wenn Sie das Modul Protect bei PAYONE bestellt haben. Der Einsatz von Bonitätsprüfungen ist mit variablen Kosten pro Transaktion verbunden.
Unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Konfiguration → Reiter "Bonitätsprüfung" können Sie festlegen, ob und in welcher Form die Bonitätsprüfungen durchgeführt werden sollen.
| Feld | Beschreibung |
|---|---|
| Aktiv | Aktiviert die Bonitätsprüfung |
| Prüfungsart B2C | Infoscore (harte Merkmale) - Prüfung auf harte Merkmale Infoscore (alle Merkmale) - Prüfung auf alle Negativmerkmale Boniverse VERITA Score - Prüfung auf VERITA-Scores über Boniversum |
| Prüfungsart B2B | Legt fest, ob Firmenkunden geprüft werden sollen. |
| Minimaler Warenwert | Warenkorbwert, ab dem eine Bonitätsprüfung durchgeführt wird. |
| Gültigkeit in Tagen | Anzahl der Tage, für die der zurückgegebene Bonitätswert gültig ist. |
Unter Kunden → Zahlungen → PAYONE → API-Log finden Sie alle Informationen über die abgewickelten Zahlungen und die Kommunikation mit der PAYONE Plattform.
Unter Kunden → Zahlungen → PAYONE → Transaktionsstatus-Log haben Sie einen Überblick über die eingegangenen Transaktionsstatusmeldungen und können durch Anklicken eines Datensatzes Details einsehen.
Risikomanagement
Mit dem PAYONE Plugin für Shopware können Sie steuern, welche Zahlungsarten Ihren Kunden in Abhängigkeit von ihrer Bonität angeboten werden. Unter Einstellungen → Risikomanagement können Sie anhand eines definierten Ampelwertes feststellen, ob eine Zahlungsart gesperrt ist.
Versandkosten
Um einen reibungslosen Betrieb des Plug-ins zu gewährleisten, ist es notwendig, jeder Zahlungsart Versandtarife zuzuordnen. Als weitere Option können Sie eine alternative Versandart definieren, die immer dann zum Tragen kommt, wenn einer Zahlungsart kein konkreter Versandkosten-Satz zugeordnet ist.
Anpassen von Textbausteinen
Für die Anzeige bestimmter Texte werden bei der Installation des Plug-ins Textbausteine mitgeliefert, die Sie entsprechend der jeweils verwendeten Sprache anpassen können. Die Verwaltung der Snippets finden Sie unter Einstellungen → Textbausteine.
Zahlungsart duplizieren
Unter Einstellungen → Zahlungsarten können Sie die Zahlungsarten für eine gesonderte Verwendung, mit einem Subshop oder anderen Gründen wie Länderzuordnungen, kopieren.
