Shopware 6 Integrationsanleitung

💳 Kreditkarten

• Visa (Click to Pay), Mastercard (Click to Pay)
• American Express
• JCB, Diners Club

📱 Digital 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 Secure Invoice
• PAYONE Secured Payments
• PAYONE Lastschrift
• PAYONE Offener Rechnungskauf
• PAYONE Vorkasse

🌍 Lokale Zahlungsarten

• Klarna Payments
• Ratepay Lösungen
• Unzer Payments
• Bancontact, EPS, iDEAL
• PostFinance, Przelewy24

Diese Zahlungsart benötigt ein eigenes Zahlungsportal. Bitte geben Sie eine separate Portal-ID unter Einstellungen → Erweiterungen → PAYONE → PAYONE Secure Invoice ein.

Eine während der Plugin-Installation erstellte Regel für den Rule Builder stellt sicher, dass die Zahlungsart nur für die Währung "Euro" verwendet werden kann. Falls Sie die Währung "Euro" während der Plugin-Installation nicht in Ihrem Shop installiert hatten, wird eine zufällige, nicht existierende Währungs-ID mit der Bedingung verknüpft, sodass die Regel immer fehlschlägt. Wenn Sie dann nachträglich die Währung "Euro" erstellen, müssen Sie die Währung "Euro" in der Bedingung "Währung ist eine von" unter Einstellungen → Rule Builder → Payone secure invoice auswählen.

Um ihre Kunden über die Bankverbindung zu informieren, an die sie überweisen sollen, wurde ein Bankdaten-Block in die Rechnungsvorlage integriert.

Um Unzer anbieten zu können, müssen die Zahlungsarten zusätzlich im Backend konfiguriert werden:

PAYONE Unzer Rechnungskauf

Unter Einstellungen → Erweiterungen → PAYONE → PAYONE Unzer Rechnungskauf müssen folgende Daten hinterlegt werden: Firmenname (für die ergänzenden AGB), IBAN und BIC (beide werden neben der Zahlungsreferenz angezeigt). Aktivieren Sie den B2B-Slider, wenn Sie B2B-Bestellungen akzeptieren möchten.

PAYONE Unzer Ratenkauf

Unter Einstellungen → Erweiterungen → PAYONE → PAYONE Unzer Ratenkauf müssen folgende Daten hinterlegt werden: Firmenname (für die ergänzenden AGB), Kanalname und Kanalpasswort (beide erhalten Sie von Unzer).

In Einstellungen → Erweiterungen → PAYONE → PAYONE Apple Pay müssen folgende Daten angegeben werden: Unterstützte Kartentypen, Apple Pay Merchant ID (Identifier im Apple Developer Portal), Apple Pay Display Name (der Name, der auf dem Apple Pay Sheet angezeigt wird) und Certificate Passphrase (falls ein Passwort bei der request.csr-Erstellung gesetzt wurde).

Erstellen Sie die folgenden Dateien im Ordner config/apple-pay-cert/: merchant_id.pem und merchant_id.key.

Zusätzlich muss ein Unterordner .well-known im public-Ordner erstellt werden. In diesem Unterordner legen Sie bitte die Datei apple-developer-merchantid-domain-association.txt ab.

Zusätzlich zur Konfiguration in Shopware ist es auch notwendig, die entsprechenden Zertifikate einzurichten, um Apple Pay als Zahlungsart zu betreiben. Eine Anleitung dazu finden Sie hier: Besondere Hinweise - Apple Pay

Zusätzlich verlangt Apple eine Validierung der Shop-Domain für Apple Pay. Befolgen Sie dazu die Anweisungen im Apple Developer Portal:

Im Testsystem ist es nicht erforderlich, eine "GooglePay MerchantId" in den GooglePay-Einstellungen einzugeben. Beim Wechsel in die Live-Umgebung muss jedoch die "GooglePay MerchantId" des Händlers hier eingegeben werden.

Sie finden Ihre Merchant-ID oben im Google Merchant Center.

Vorautorisierte Transaktionen können mit dem "Capture"-Button in den Bestelldetails eingezogen werden.

Mit dem "Refund"-Button kann eine Bestellung (im Status "bezahlt") rückerstattet werden.

Sie können eine Bestellung teilweise einziehen oder rückerstatten, indem Sie einen Bestellartikel auswählen und die Menge bearbeiten. Der Einzugsbetrag wird dynamisch angepasst.

Wenn Sie die Bestellung vollständig einziehen oder rückerstatten möchten, klicken Sie auf "Complete Capture".

Sie können auch direkt den gewünschten Betrag im Feld "Capture amount" eingeben.

Einzüge und Rückerstattungen sind nur möglich, nachdem der Shop einen Transaktionsstatus für eine Bestellung erhalten hat. Daher sind die Buttons für Einzüge und Rückerstattungen direkt nach einer Bestellung ausgegraut.

Unter Einstellungen → Erweiterungen → PAYONE → Status Mapping können Sie individuell die Zustände zuweisen, auf die die Bestellungen gesetzt werden sollen, sobald die jeweilige Information von der PAYONE-Plattform gesendet wird.

Unter Einstellungen → Erweiterungen → PAYONE können Sie individuell die Zustände für jede Zahlungsart separat zuweisen. Bitte wählen Sie die Zahlungsart aus und aktivieren Sie "Display state mapping configuration".

Die folgenden Anpassungen sind nicht notwendig, um Kreditkartenzahlungen anzubieten. Die Möglichkeit, die Zahlungsart visuell im Frontend anzupassen, wird im Folgenden beschrieben:

Sie können das CSS ändern, indem Sie ein neues Plugin erstellen, das über Composer von diesem Plugin abhängt. Hier können Sie dann ein überschreibendes JavaScript-Plugin wie dieses definieren:

Dann können Sie das überschreibende Plugin in Ihrer custom/plugins/MyPlugin/src/Resources/storefront/main.js registrieren:

Wenn Sie Shopwares Rechteverwaltung verwenden, geben Sie bitte allen Benutzern die Berechtigung. Unter Einstellungen → System → Benutzer & Berechtigungen → Rolle erstellen Sie eine neue Rolle oder aktualisieren eine bestehende Rolle. Aktivieren Sie das PAYONE Transaktionsmanagement-Recht.