- Created by PAYONE Writer, last modified by PAYONE Admin on 2022-04-13
Voraussetzungen
Sie brauchen unbedingt einen aktiven PAYONE – Account. Wenn Sie noch keinen Account haben, kontaktieren Sie uns bitte.
Installation des Plugins
Sie haben 3 Möglichkeiten unser Plugin zu installieren:
- „Kaufen“ Sie sich das kostenlose PAYONE Plugin im Shopware Store.
- Laden Sie sich unser Plugin in Ihren Shop unter Erweiterungen → Meine Erweiterungen.
- Installieren und aktivieren Sie das Plugin.
composer require payone-gmbh/shopware-6 php bin/console plugin:install PayonePayment php bin/console plugin:activate PayonePayment php bin/console cache:clear
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:
<SHOPURL>/payone/webhook
Bitte belassen Sie die Hash-Prüfung auf md5, um eine korrekte Kommunikation zwischen PAYONE und dem Shop zu gewährleisten.
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 6 - Admin
Klicken Sie unter Einstellungen → Plugins → PAYONE
Tragen Sie hier bitte Ihre Zugangsdaten ein:
- Anschließend aktivieren Sie unter Verkaufskanäle → [genutzter Verkaufskanal] → Zahlung und Versand die Zahlungsarten für Ihre genutzten Vertriebskanäle:
- Jede Zahlungsart kann mit separaten Zugangsdaten genutzt werden. Diese können direkt in der Zahlungsart unter Einstellungen → Erweiterungen → PAYONE eingetragen 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:
PAYONE Gesicherter Rechnungskauf
Diese Zahlungsart benötigt ein eigenes Zahlungsportal. Bitte tragen Sie unter Einstellungen → Erweiterungen → PAYONE → Gesicherter Rechnungskauf eine separate Portal ID ein.
PAYONE Vorkasse
Um Kunden die Bankverbindung mitzuteilen, haben wir einen Block mit Verrechnungsdaten in die Rechnungsvorlage aufgenommen. Es macht Sinn, diese Daten ebenfalls in die E-Mail-Vorlage der Bestellbestätigung zu integrieren. Wir haben derzeit keine detaillierte Anleitung verfügbar.
Unzer Payments
Um Unzer anbieten zu können, müssen im Backend die Zahlungsarten zusätzlich konfiguriert werden:
Unzer Rechnungskauf
Unter Einstellungen → Erweiterungen → PAYONE → Paysafe Pay Later Rechnung müssen folgende Daten hinterlegt werden: Firmenname (für die ergänzenden AGB), IBAN und BIC (beides wird neben der Zahlungsreferenz angezeigt). Aktivieren Sie den B2B Schieber, wenn Sie B2B Bestellungen annehmen wollen.
Unzer Ratenkauf
Unter Einstellungen → Erweiterungen → PAYONE → Paysafe Pay Later Ratenzahlung müssen folgende Daten hinterlegt werden: Firmenname (für die ergänzenden AGB), Channel Name und Channel Passwort (beides erhalten Sie von Unzer).
Apple Pay
Unter Einstellungen → Erweiterungen → PAYONE → Apple Pay müssen folgende Daten hinterlegt werden: Unterstützte Kartentypen, ApplePay Merchant ID, ApplePay Dispaly Name und Certificate Passphrase (die drei letzten Daten erhalten Sie von Apple).
Erstellen Sie in dem Ordner config folgende Dateien: merchant_id.pem und merchant_id.key.
Den Inhalt der Dateien erhalten Sie im Zuge des Apple Onboardings unter Punkt 3.
Des Weiteren muss im Ordner public ein Unterordner .well-known erstellt werden. In diesen Unterordner legen Sie bitte die Datei: apple-developer-merchantid-domain-association.txt
Den Inhalt der Datei erhalten Sie nach der Domainzertifizierung von Apple.
ApplePay ist nur auf Apple Geräten sichtbar und nutzbar.
Neben der Konfiguration im Shopware ist für den Betrieb von Apple Pay als Zahlart auch das Einrichten der entsprechenden Zertifikate nötig. Hinweise dazu finden Sie hier: Special Remarks - Apple Pay
Zusätzlich verlangt Apple die Validierung der Shop-Domain für Apple Pay. Folgen Sie dafür den Anweisungen im Apple Developer Portal:
Aktivieren der Zahlungsarten
Aktivieren Sie die gewünschten Zahlungsarten unter Einstellungen → Shop → Zahlung.

Bearbeiten der Bestellungen
Das PAYONE Plugin setzt den Zahlungsstatus einer Bestellung entsprechend der eingestellten Statuszuordnung.
Erfassung/ Capture
Vorautorisierte Transaktionen können über die Schaltfläche "Capture" in den Bestelldetails erfasst werden.

Rückerstattung/ Refund
Über die Schaltfläche „Refund“ kann eine Bestellung (im Status „bezahlt“) zurückerstattet werden.

Teilerfassung und -rückerstattung
Sie können eine Bestellung teilweise erfassen oder erstatten, indem Sie eine Bestellposition auswählen und die Menge bearbeiten. Der Erfassungsbetrag wird dynamisch angepasst.
Wenn Sie die Bestellung vollständig erfassen oder erstatten wollen, klicken Sie auf "Vollständige Erfassung".
Sie können auch direkt den gewünschten Betrag in das Feld "Erfassungsbetrag" eingeben.
Erfassungen und Erstattungen sind nur möglich, nachdem der Shop einen Transaktionsstatus für eine Bestellung erhalten hat, daher sind die Schaltflächen für Erfassungen und Erstattungen direkt nach einer Bestellung ausgegraut.
Erweiterte Konfigurationen
Hier finden Sie separate Einstellungsmöglichkeiten, mit den Sie unser Plugin genauer an Ihre Bedürfnisse anpassen können
Status Mapping (global)
Unter Einstellungen → Erweiterungen → PAYONE → Statusmapping können Sie die Status individuell zuordnen, auf die die Bestellungen gesetzt werden sollen, sobald die jeweilige Information von der PAYONE Plattform gesendet wird.
Status Mapping (per Zahlungsart)
Unter Einstellungen → Erweiterungen → PAYONE können Sie die Status für jede Zahlungsmethode einzeln zuweisen. Bitte wählen Sie die Zahlungsmethode und aktivieren Sie "Statusmappingkonfiguration einblenden".
Kreditkarte - CSS Anpassungen
Folgende Anpassungen sind nicht notwendig, um Kreditkartezahlungen anzubieten. Wir beschreiben hier die Möglichkeit die Zahlungsart optisch im Frontend anzupassen:
Sie können das CSS ändern, indem Sie ein neues Plugin erstellen, das von diesem Plugin über Composer abhängt. Hier können Sie dann ein überschreibendes JavaScript-Plugin wie dieses definieren:
import PayonePaymentCreditCard from '../../../../../PayonePayment/src/Resources/storefront/credit-card/payone-payment.credit-card'; export default class MyPayonePaymentCreditCard extends PayonePaymentCreditCard { getFieldStyle() { const style = super.getFieldStyle(); style.push('height: 300px'); return style; } getSelectStyle(){ const style = super.getSelectStyle(); style.push('background-color: black'); return style; } }
Dann können Sie das überschreibende Plugin hier importieren custom/plugins/MyPlugin/src/Resources/storefront/main.js
:
import MyPayonePaymentCreditCard from './my-payone-payment/my-payone-payment.credit-card.plugin'; const PluginManager = window.PluginManager; PluginManager.override('PayonePaymentCreditCard', MyPayonePaymentCreditCard, '[data-is-payone-credit-card]'); // Necessary for the webpack hot module reloading server if (module.hot) { module.hot.accept(); }
Berechtigungsverwaltung
Wenn Sie das Rechtemanagement von Shopware nutzen, geben Sie bitte allen Nutzern die Berechtigung. Unter Einstellungen → System → Benutzer&Rechte → Rolle erstellen Sie eine neue Rolle oder updaten Sie eine bestehende Rolle. Aktivieren Sie das Recht PAYONE Transaktionsmanagement.
Fakten im Überblick
Payment methods + Features
Visa
Mastercard
American Express
JCB
Diners Club
Maestro International
Apple Pay
paydirekt
PayPal
PayPal Express
PAYONE Direct Debit
PAYONE Invoice
PAYONE Prepayment
EPS
iDEAL
Sofort
Trustly
PAYONE Secure Invoice
Unzer Lastschrift
Unzer Rechnungskauf
Unzer Ratenkauf
Open Source
Automatic Credit Card Type Detection
(Partial) Captures and Refunds
Transactionstatus URL:
<SHOPURL>/payone/webhook
Latest Release
New Features * New payment method: Open Invoice * Add checkbox for credit card payments to save or remove payment data Bugfixes * remove capturemode param if completed * update ZeroAmountCartValidator * always set data protection check Maintenance * include line items with no tax for capture * add shipping information to Unzer Tested with: Shopware 6.4.10.0
Download
Inhaltsverzeichnis
- No labels