1. „Kaufen“ Sie sich das kostenlose PAYONE Plugin im Shopware Store.
2. Laden Sie sich das Plugin in Ihrem Shop unter Einstellungen → Pluginmanager herunter.
3. Installieren und aktivieren Sie das Plugin.

Detaillierte Beschreibung der einzelnen Felder

PAYONE Gesicherter Rechnungskauf + PAYONE Gesicherter Ratenkauf

Diese beiden Zahlungsarten benötigen ein eigenes Zahlungsportal. Bitte tragen Sie unter Kunden → Zahlungen → PAYONE → Gilt für Zahlart: PAYONE Gesicherter Rechnungskauf bzw. PAYONE Gesicherter Ratenkauf eine separate Portal ID ein.

PayPal Express Checkout

• Klicken Sie unter Kunden → Zahlungen → PAYONE → Payone PayPal

Ratepay

• Klicken Sie unter Kunden → Zahlungen → PAYONE → Payone Ratepay

• Für Ratepay müssen Sie einige zusätzliche Konfigurationsdaten eingeben, die Ratepay festgelegt hat, damit die Zahlungsmethode reibungslos funktioniert. Verwenden Sie den Button Hinzufügen, um eine weitere Ratepay-Konfiguration hinzuzufügen:

• Speichern Sie die Konfiguration und rufen Sie dann die anderen Daten von RatePay mit "Ratepay Konfiguration abrufen" ab. Achten Sie darauf, dass Sie vorher das Kontrollkästchen auswählen.
  

Amazon Pay

• Klicken Sie unter Kunden → Zahlungen → PAYONE → Payone Amazon Pay

Bei Amazon Pay müssen Sie einige zusätzliche Daten eingeben, um sicherzustellen, dass die Zahlungsmethode reibungslos funktioniert.

paydirekt

Bei paydirekt können Sie einen Expressbutton konfigurieren, der im Warenkorb eingeblendet wird.

• Klicken Sie unter Kunden → Zahlungen → PAYONE → Payone PayDirekt

Kreditkarte

• Klicken Sie unter Kunden → Zahlungen → PAYONE → Payone Kreditkartenkonfiguration

• Durch Auswahl von Bearbeiten (Stift) oder Hinzufügen wird ein Fenster mit den folgenden Parametern geöffnet:

Verwendung der automatischen Kartentyp-Erkennung

Hier sehen Sie, wie unsere automatische Erkennung des Kartentyps funktioniert. Diese Funktion kann bei der Konvertierung helfen, da der Kunde weniger Felder zu beachten hat. Wir geben auch visuelle Hinweise darauf, welche Marken vom Shop unterstützt werden.

Ohne die automatische Erkennung muss der Kunde den Kartentyp seiner Kreditkarte angeben.

Wenn die Funktion aktiviert ist, werden alle konfigurierten Kreditkartenmarkenlogos von unserem CDN geladen und über dem Kartenfeld angezeigt. Unsere Plattform ermittelt die verwendete Marke und hebt sie hervor, während Sie die Kartennummer eingeben.

Im Falle einer unbekannten Nummer wird eine Warnung angezeigt:

Dieser Fall kann eintreten, wenn der Kunde eine wirklich falsche Nummer, nicht unterstützte Zeichen oder eine Nummer aus einem sehr neuen BIN-Bereich eingibt. Wenn der Kunde sich seiner Kartennummer sicher ist, kann er auf das Symbol seiner Marke klicken, um den Kartentyp manuell auszuwählen.

Wenn der Kunde eine Karte verwenden möchte, die von der aktuellen Shop-Konfiguration nicht unterstützt wird, zeigen wir eine Fehlermeldung an und fordern den Kunden auf, eine unterstützte Karte zu verwenden.

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
Feldtyp	Numerisch - Es sind nur Zahlen erlaubt und für mobile Geräte wird die numerische Tastatur verwendet → input type="tel" Passwort - input type="password" Text - input type="text"
Zeichenanzahl	Anzahl der Zeichen in der Breite des Eingabefeldes
Zeichenanzahl Max	Maximal zulässige Anzahl von Zeichen (HTML attribute maxlength)
iFrame	Standard - Nutzt width und height vom Standard Stil Benutzerdefiniert - Nutzt width und height von den folgenden Feldern
iFrame Breite	Festlegen der Breite in CSS
iFrame Höhe	Angabe der Höhe in CSS
Stil	Standard - Nutzt CSS Spezifikation vom "Standard Stil" Benutzerdefiniert - Nutzt CSS Spezifikation von den folgenden Feldern
CSS	Spezifizieren Sie das CSS, um das betreffende Feld zu formatieren. Wenn Sie das CSS-Attribut Url verwenden, wird das betreffende Feld nicht angezeigt

Standard Stil

Feld	Beschreibung
Felder: Eingabe	Spezifikation von CSS für die Standardformatierung aller Eingabefelder. Das folgende CSS kann im Standard-Template von Shopware verwendet werden: box-shadow:inset 0 1px 1px 1px #dadae5;background:#f8f8fa;border:1px solid #dadae5;border-top-color:#cbcbdb;line-height:19px;font-size:.875rem;width:85%;padding:.625rem .625rem .625rem .5625rem .625rem;color:#8798a9;
Felder: Auswahl	Spezifikation von CSS für die Formatierung aller Auswahlfelder Das folgende CSS kann in der Shopware- Standard-Template verwendet werden: box-shadow:inset 0 1px 1px 1px #dadae5;background:#f8f8fa;border:1px solid #dadae5;border-top-color:#cbcbdb;line-height:19px;font-size:.875rem;width:85%;padding:.625rem .625rem .625rem .5625rem .625rem;color:#8798a9;
iFrame Höhe	Spezifikation der Standardhöhe in CSS für alle Felder
iFrame Breite	Spezifikation der Standardhöhe in CSS für alle Felder

Fehlerausgabe und eigene Fehlermeldungen

Feld	Beschreibung
Aktiv	Aktiviert die Fehlerausgabe
eigene Fehlermeldungen	Hier können Sie Ihre eigenen Fehlermeldungen eintragen

PAYONE Lastschrift

Wenn Sie die Zahlungsart "PAYONE Lastschrift" nutzen, achten Sie darauf der Länderauswahl die Länder anzugeben, aus denen Sie Lastschriften ziehen wollen. Wenn Sie kein Land auswählen, wird die Zahlungsart allen Kunden angezeigt. Dies kann Kunden aus Nicht-SEPA-Ländern verwirren. Außerdem ist dann die Auswahlliste des Kontolandes im Checkout leer.

Apple Pay

Unter Kunden → Zahlungen → PAYONE Kontrollzentrum → Konfiguration → Grundeinstellungen → Allgemein

Adressprüfung

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.

Bonitätsprüfung

• Unter Kunden → Zahlungen → PAYONE → Konfiguration → Reiter "Bonitätsprüfung" können Sie festlegen, ob und in welcher Form die Bonitätsprüfungen durchgeführt werden sollen und wie sich der Shopware eShop verhalten soll, wenn bestimmte Ergebnisse zutreffen.

Paymentstatus

• Unter Kunden → Zahlungen → PAYONE → Konfiguration → Reiter "Paymentstatus" können Sie festlegen, welchen Status die Bestellung in Shopware haben soll

Transaktionsstatusweiterleitung

• Unter Kunden → Zahlungen → PAYONE → Konfiguration → Reiter "Transaktionsstatusweiterleitung" können Sie bei Bedarf jeder Zahlungsstatusmeldung der PAYONE Plattform (Transaktionsstatus) eine eigene Weiterleitungs-URL zuordnen. Dies ist immer dann notwendig, wenn auch andere Systeme in Ihrer Systemumgebung diese Zahlungsinformationen benötigen.

• Wenn die Protokollierung (Logging) aktiviert ist, werden Fehler bei der Weiterleitung von Transaktionsstatusmeldungen in einem separaten Systemlog angezeigt. Sie können dann die aktuellen Logs unter Einstellungen → Logfile → Reiter "System-Log" einsehen und herunterladen

API- und Transaktionsstatus-Log

• Unter Kunden → Zahlungen → PAYONE → API-Log finden Sie alle Informationen über die abgewickelten Zahlungen und die Kommunikation mit der PAYONE Plattform.

• Die Übersicht zeigt alle eingegangenen und bearbeiteten Anfragen an die PAYONE Plattform. Durch Anklicken eines Eintrags können Sie Details zu der jeweiligen Anfrage einsehen.

• Unter Kunden → Zahlungen → PAYONE → Transaktionsstatus-Log haben Sie einen Überblick über die eingegangenen Transaktionsstatusmeldungen und können durch Anklicken eines Datensatzes Details einsehen.

Clearingdaten in html und Pdfs integrieren

Die Clearingdaten werden in der Tabelle s_order_attributes in der Spalte mopt_payone_clearing_data_ jsoncoded gespeichert. Die Spalte orderID enthält die ID der entsprechenden Bestellung, die in der Tabelle s_order gespeichert ist. Die Daten können z.B. mit der folgenden SQL-Anweisung gelesen werden:

SELECT mopt_payone_clearing_data FROM s_order_attributes WHERE orderID = desired OrderID

Die Clearingdaten können dann wieder dekodiert werden, wobei die meisten Programmiersprachen Standardfunktionen bereitstellen.

json_decode()

JSON.parse()

Anzeige der Vorauszahlungs-Clearingdaten in der E-Mail-Vorlage

Alle E-Mail-Vorlagen können unter Einstellungen > E-Mailmanagement -> E-Mail-Vorlagen angepasst werden. Die Vorlage für die Bestellbestätigungs-E-Mail finden Sie unter System eMails > sORDER.
Es gibt 2 Vorlagen; eine für Text-E-Mails und eine für HTML-E-Mails.

Text-E-Mail-Vorlage anpassen

Sie können die Vorlagen je nach der verwendeten Zahlungsmethode anpassen. Um die Vorlagen anzupassen, muss der interne Name der verwendeten Zahlungsmethode verwendet werden. Sie finden die Namen in der Übersicht der Zahlungsarten:

Das folgende Beispiel verwendet Vorkasse, kann aber für Rechnung usw. angepasst werden.

Bitte suchen Sie in der Vorlage nach dem folgenden Block (im Prinzip können die zusätzlichen Informationen bei jedem Controller eingefügt werden):

{if $additional.payment.name == "prepayment"} 
	Our bank details: 
	{config name=bankAccount} 
{/if}

und fügen Sie diesen Block ein:

{if $additional.payment.name == "mopt_payone__acc_payinadvance (or other payment name)"}
	{if $additional.moptPayoneClearingData}
		Our bank details:
		account holder:	{$additional.moptPayoneClearingData.clearing_bankaccountholder}
		bank account: 	{$additional.moptPayoneClearingData.clearing_bankaccount}
		bank code:		{$additional.moptPayoneClearingData.clearing_bankcode}
		IBAN:        	{$additional.moptPayoneClearingData.clearing_bankiban}
		BIC:         	{$additional.moptPayoneClearingData.clearing_bankbic}
		Bank:        	{$additional.moptPayoneClearingData.clearing_bankname}
		reference:		{$additional.moptPayoneClearingData.clearing_txid}
	{/if}
{/if}

Beispiel: PayPal-Ratenzahlungen

PayPal Ratenzahlung erfordert, dass der Händler zusätzliche Informationen über die Raten in den Mails und der Rechnung anzeigt. So geht's:

{if $additional.payment.name == "mopt_payone__fin_paypal_installment"}
	{if $additional.moptPayoneClearingData}
		Finanzierungskosten: $additional.moptPayoneClearingDataclearing_total_interest_value|currency}
		Gesamtbetrag(mit Finanzierungskosten):{$additional.moptPayoneClearingData.clearing_total_cost_value|currency}
	{/if}
{/if} 

Dieser Block fügt den Ratenbetrag und die Gesamtsumme einschließlich der Ratenkosten an die Mail an.

Erweitern von HTML-Vorlagen

Bitte suchen Sie den folgenden Block (die Daten können auch an anderer Stelle eingefügt werden):

{if $additional.payment.name == "prepayment"}
	our bank details:<br/>
	{config name=bankAccount}
{/if}

und fügen Sie den folgenden Block ein:

{if $additional.payment.name == "mopt_payone__acc_payinadvance" or $additional.payment.name == "mopt_payone__acc_invoice" }
	{if $additional.moptPayoneClearingData}
		{if !empty($additional.moptPayoneClearingData.clearing_bankaccountholder)
		 or !empty($additional.moptPayoneClearingData.clearing_bankaccount)
 		or !empty($additional.moptPayoneClearingData.clearing_bankcode)
 		or !empty($additional.moptPayoneClearingData.clearing_bankiban)
		 or !empty($additional.moptPayoneClearingData.clearing_bankbic)
		 or !empty($additional.moptPayoneClearingData.clearing_bankname)
		}
			<strong>our bank details</strong><br/>
			{if !empty($additional.moptPayoneClearingData.clearing_bankaccountholder)}
				account holder: {$additional.moptPayoneClearingData.clearing_bankaccountholder}<br/>
			{/if}
			{if !empty($additional.moptPayoneClearingData.clearing_bankaccount)}
				bank account: {$additional.moptPayoneClearingData.clearing_bankaccount}<br/>
			{/if}
			{if !empty($additional.moptPayoneClearingData.clearing_bankcode)}
				bank code: {$additional.moptPayoneClearingData.clearing_bankcode}<br/>
			{/if}
			{if !empty($additional.moptPayoneClearingData.clearing_bankiban)}
				IBAN: {$additional.moptPayoneClearingData.clearing_bankiban}<br/>
			{/if}
			{if !empty($additional.moptPayoneClearingData.clearing_bankbic)}
				BIC: {$additional.moptPayoneClearingData.clearing_bankbic}<br/>
			{/if}
			{if !empty($additional.moptPayoneClearingData.clearing_bankname)}
				Bank: {$additional.moptPayoneClearingData.clearing_bankname}<br/>
			{/if}
			{if !empty($additional.moptPayoneClearingData.clearing_bankcountry)}
				bank country: {$additional.moptPayoneClearingData.clearing_bankcountry}<br/>
			{/if}
			{if !empty($additional.moptPayoneClearingData.clearing_txid)}
				reference: {$additional.moptPayoneClearingData.clearing_txid}<br/>
			{/if}
		{/if}
	{/if}
{/if}

Bei Bedarf können auch die restlichen Clearingdaten, wie z.B. das Land, nach folgendem Muster angezeigt werden:

{$additional.moptPayoneClearingData.clearing_bankcountry}

Die Namen richten sich nach den Namen der PAYONE Parameter. Bei der HTML-Variante kann die Ausgabe noch mit HTML und CSS gestaltet und an das entsprechende Layout angepasst werden.

Erweitern von PDF-Vorlagen

Um die Clearing-Daten auf PDF-Dokumenten anzuzeigen, muss der JSON-kodierte Inhalt der entsprechenden Variablen zunächst dekodiert werden. Dies geschieht in der .tpl-Datei für die Rechnung (oder ähnlich) für Ihre Vorlage:

{assign var=mopt_payone_decoded_clearing_data value=$Order._order.attributes.mopt_payone_clearing_data|json_decode:true}

Diese und andere Variablen sind dann verfügbar:

{$mopt_payone_decoded_clearing_data.clearing_bankaccountholder}

{$mopt_payone_decoded_clearing_data.clearing_bankiban}

{$mopt_payone_decoded_clearing_data.clearing_bankbic}

{$mopt_payone_decoded_clearing_data.clearing_bankname}

{$mopt_payone_decoded_clearing_data.clearing_reference}

{$mopt_payone_decoded_clearing_data.clearing_txid}

{$attributes.mopt_payone_txid}

{$sBookingID}

{$Order._order.invoice_amount}

{$Order._order.invoice_amount_net}

{$mopt_payone_decoded_clearing_data|print_r}

PayPal Ratenzahlung erfordert, dass der Händler zusätzliche Informationen über die Raten in den Mails und der Rechnung anzeigt. So geht's:

PayPal-Ratenzahlungen

Die Rechnungsvorlage finden Sie in Ihrem Shopverzeichnis. (Standard für Shopware 5: shoproot/themes/Frontend/Bare/documents/index.tpl). In dem Block {block name="document_index_amount"} muss dieser Code eingefügt werden:

{if $Order._payment.name == 'mopt_payone__fin_paypal_installment' }
 <tr>
 <td align="right"><b>Finanzierungskosten:</b></td>
 <td align="right"><b>{$mopt_payone_decoded_clearing_data.clearing_total_interest_value|currency}</b></td>
 </tr>
 <tr>
 <td align="right"><b>Gesamtbetrag(mit Finanzierungskosten):</b></td>
 <td align="right"><b>{$mopt_payone_decoded_clearing_data.clearing_total_cost_value|currency}</b></td>
 </tr>
 {/if

Risiko Management

Bonitätsabhängige Steuerung des Zahlungsportfolios

Mit dem PAYONE Plugin für Shopware können Sie steuern, welche Zahlungsarten Ihren Kunden in Abhängigkeit von ihrer Bonität angeboten werden. Die Prüfung findet in Echtzeit für jeden einzelnen Käufer während des Checkout-Prozesses statt.
Die Einstellungen können für jede Zahlungsart unterschiedlich definiert werden, so dass die Risikoprüfungen nur unter bestimmten Bedingungen durchgeführt werden und eine Zahlungsart nur unter bestimmten Bedingungen angeboten wird.

Durch die Installation des PAYONE Plugins wurden die Bedingungen des Ampelwertes zu den bestehenden Regeln hinzugefügt.

• 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 Plugins Textbausteine mitgeliefert, die Sie entsprechend der jeweils verwendeten Sprache anpassen können. Die Verwaltung der Snippets finden Sie unter Einstellungen → Textbausteine.

Alle Textausgaben (außer Banknamen, z.B. bei iDeal) im Frontend werden über Textbausteine bereitgestellt, so dass eine größtmögliche Flexibilität bei der Verwendung mehrerer Sprachen gegeben ist. Entsprechend dem Shopware-Standard werden die Textbausteine bei der ersten Verwendung initialisiert und in der Datenbank gespeichert. Danach sind sie editierbar. Die wichtigsten Bestandteile werden bereits bei der Installation des Plug-ins hinterlegt. Um bestimmte Textbausteine zu bearbeiten, müssen Sie ggf. erst die entsprechende Seite im Frontend aufrufen.

Der Textrahmen für das PAYONE Plugin befindet sich im Namespace frontend/MoptPaymentPayone. Es gibt eine allgemeine Fehlermeldung "generalErrorMessage", die verwendet wird, wenn keine spezifische Fehlermeldung vorhanden ist. Spezifische Fehlermeldungen können für einzelne Fehlercodes der PAYONE Plattform konfiguriert werden. Der Textbaustein für eine Fehlernummer 888 heißt dann "errorMessage888". Ausnahmen sind die Prüfung der Bankverbindung und der Adresse, da hier keine numerischen Fehlercodes zurückgegeben werden. Die Textbausteine hierfür heissen "bankaccountcheck-blocked" oder "addrescheckcorrected".

Aus technischen Gründen können nur wenige einzelne Elemente der Kasse direkt in den Vorlagen bearbeitet werden. Diese Vorlagen finden Sie unter:

/engine/Shopware/Plugins/Default/Frontend/MoptPaymentPayone/ViewsResponsive/frontend/plugins/payment

im Shopware-Verzeichnis. 

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

Nach der Duplizierung können Sie die Zahlungsart mit einer anderen Bezeichnung versehen und einem Land oder auch einem anderen Subshop zuweisen.