Shopware 6 BlueSnap Zahlungsintegration

BlueSnap ist eine globale Payment-Orchestration-Plattform, die sichere, vielseitige Zahlungsabwicklungen direkt im Shopware-6-Store ermöglicht. Mit dem von solution25 entwickelten BlueSnap-Plugin für Shopware 6 können Händler Kredit- und Debitkarten, digitale Wallets (Apple Pay, Google Pay) sowie lokale Zahlungsmethoden über eine einzige Integration akzeptieren. Diese All-in-One-Lösung umfasst integrierten Betrugsschutz (3D Secure und Kount Risk Management) sowie Echtzeit-Bestellupdates und bietet damit ein schnelles, sicheres Checkout-Erlebnis ohne großen Aufwand. Als offizieller Shopware-Partner bringt BlueSnap gehostete Zahlungslinks, gespeicherte Käuferdaten (Tokenisierung) und die Unterstützung mobiler Wallets direkt ins Shopware-Admin.

Die BlueSnap-Plattform ist speziell für den globalen E-Commerce entwickelt: Sie ermöglicht Verkäufe in über 200 Regionen mit lokalem Karten-Acquiring in 50 Ländern, um Autorisierungsraten zu maximieren, unnötige Gebühren zu vermeiden und die bevorzugten globalen Zahlungsmethoden und Währungen der Kunden bereitzustellen. Mit nur einem BlueSnap-Konto können Kunden weltweit erreicht werden – ganz ohne mehrere Händlerkonten. Das Shopware-Plugin ist in wenigen Minuten installiert und auch für Nicht-Techniker einfach zu bedienen, während Entwickler von Open-Source-Code, APIs und Webhooks profitieren. BlueSnap macht Zahlungen für Shopware 6 schnell, sicher und unkompliziert.

• Schneller, sicherer Checkout

BlueSnaps gehosteter Checkout bietet eine PCI-konforme Zahlungsseite, die für alle Geräte optimiert ist. Die gehostete Seite minimiert den PCI-Bereich und unterstützt die 3D-Secure-Authentifizierung, um Betrug und Rückbuchungen zu reduzieren.

• Mehrere Zahlungsmethoden

Akzeptieren Sie gängige Kredit- und Debitkarten, Apple Pay, Google Pay, Click to Pay, PayPal, ACH/ECP, BECS Direct Debit und mehr. Kunden erhalten mehr Flexibilität bei der Zahlungswahl, was die Conversion-Rate verbessert.

• Integrierter Betrugsschutz – BlueSnap integriert Echtzeit-Betrugstools (einschließlich einer Partnerschaft mit Kount), um Transaktionen automatisch zu prüfen. Die Aktivierung von 3D Secure authentifiziert Karteninhaber zusätzlich und blockiert unbefugte Belastungen. Diese Funktionen werden über einfache Kontrollkästchen in den Plugin-Einstellungen verwaltet.
• Gespeicherte Käufer (Tokenisierung) Lassen Sie Kunden ihre Karten sicher für zukünftige Einkäufe speichern. Das BlueSnap-Plugin bietet die „Vaulted Shopper“-Funktionalität, sodass Käufer gespeicherte Karten in ihrem Konto aktualisieren oder löschen können. Gespeicherte Zahlungstoken beschleunigen wiederholte Checkouts und unterstützen wiederkehrende Bestellungen (Abonnements).
• Sofortige Auftragssynchronisierung Zahlungsstatus (autorisiert, erfasst, erstattet, Rückbuchung usw.) werden automatisch zwischen BlueSnap und Shopware synchronisiert. Bestelldetails und Transaktions-IDs werden in Echtzeit aktualisiert, sodass Sie Bestellungen direkt im Shopware-Admin verwalten können, ohne manuelle Abstimmungen. Webhooks (z. B. CHARGE- und CHARGEBACK-Ereignisse) steuern diese Updates im Hintergrund.
• Globale Multi-Währungsunterstützung Verarbeiten Sie Verkäufe in über 100 Währungen und lassen Sie Gelder in Ihrer gewünschten Währung auszahlen. BlueSnaps intelligentes Zahlungsrouting nutzt weltweit lokale Acquiring-Banken, um Genehmigungsraten zu erhöhen auch bei grenzüberschreitenden Transaktionen. Das bedeutet höhere internationale Verkäufe für Ihren Shopware-Store.
• Benutzerfreundliches Admin Verwalten Sie alle BlueSnap-Einstellungen innerhalb der gewohnten Shopware-6-Admin-Oberfläche. Das Plugin enthält eine geführte Setup-Seite für API-Zugangsdaten, und Zahlungsmethoden werden pro Vertriebskanal mit nur wenigen Klicks aktiviert. Selbst nicht-technische Benutzer können alles bequem über das Dashboard steuern.
• Entwicklerfreundlich Für technische Nutzer bietet BlueSnap umfangreiche APIs, SDKs und Dokumentationen. Der Plugincode (von solution25) ist als Open Source auf GitHub verfügbar und kann individuell angepasst werden. BlueSnap stellt eine voll ausgestattete REST-API sowie gehostete Felder/Checkout-Optionen bereit, falls Sie eine tiefere Integration benötigen. Detaillierte Entwicklerdokumentationen und eine Sandbox-Umgebung ermöglichen es, jedes Szenario zu testen.

cd custom/plugins

git clone https://github.com/solution25com/bluesnap-payment-shopware-6-solution25.git

• Leeren Sie anschließend den Cache und bauen Sie die Plugin-Liste neu auf (bin/console plugin:refresh). Sie sollten „BlueSnap“ unter Erweiterungen > Meine Erweiterungen sehen.
• Plugin aktivieren: Gehen Sie in Ihrem Shopware-6-Admin zu Erweiterungen > Meine Erweiterungen, suchen Sie das BlueSnap-Plugin und klicken Sie auf Installieren. Schalten Sie dann den Schalter auf Aktivieren. Ein blauer (eingeschalteter) Schalter zeigt an, dass das Plugin aktiv ist.
• BlueSnap-API-Zugangsdaten eingeben: Öffnen Sie die Plugin-Einstellungen unter Einstellungen > System > Plugins (klicken Sie auf die Auslassungspunkte … oder den Plugin-Namen). Wählen Sie im Tab „Allgemein“ Ihre Umgebung (Sandbox oder Live) und geben Sie Folgendes ein:
• API Key Live und API Password Live (aus Ihrem BlueSnap-Produktionskonto)
• Merchant ID (MID) für Ihr BlueSnap-Konto
• API Key Sandbox und API Password Sandbox (aus Ihrem BlueSnap-Sandbox-Konto).
• Kopieren Sie diese Werte exakt aus Ihrem BlueSnap-Konto. Sandbox-Zugangsdaten ermöglichen es Ihnen, Testtransaktionen ohne echtes Geld durchzuführen. Siehe Screenshot: BlueSnap-Plugin-Einstellungen, der zeigt, wo diese Schlüssel eingefügt werden.
• 3D Secure & Vaulting aktivieren: Aktivieren Sie im Plugin die Option 3DS, um 3D Secure für Kreditkartenzahlungen einzuschalten. (Hinweis: Sie müssen 3D Secure zuerst in Ihren BlueSnap-Kontoeinstellungen aktivieren.) Aktivieren Sie außerdem Karte speichern unter „Vaulted Shopper“, damit Kunden Karten in ihrem Konto speichern können. Klicken Sie auf Speichern, um die Änderungen zu übernehmen.
• Zahlungsarten zuweisen: Gehen Sie zu Einstellungen > Shop > Zahlungsmethoden und stellen Sie sicher, dass die Zahlungsmethode „BlueSnap“ aktiviert und den richtigen Vertriebskanälen zugewiesen ist. Konfigurieren Sie den Anzeigenamen und die Beschreibung nach Wunsch. BlueSnap kann als Standardoption für Kreditkarten festgelegt werden. Siehe Screenshot: Shopware-Zahlungsmethoden für ein Beispiel-Setup.

Wenn Sie diese Schritte befolgen, ist BlueSnap vollständig in Ihrem Shopware-6-Store integriert. Das Plugin fügt „BlueSnap“ automatisch als Zahlungsoption im Checkout hinzu und kümmert sich nahtlos um die Weiterleitung zur sicheren, von BlueSnap gehosteten Zahlungsseite.

Einfache Administration und Nutzung

Sobald installiert, ist das Shopware-Plugin von BlueSnap auf einfache Bedienung ausgelegt. Im Shopware-Admin können Sie alle BlueSnap-Zahlungen wie jede andere Bestellung verwalten:

• • • Kunden-Checkout: Auf der Checkout-Seite Ihres Shops sehen Kunden BlueSnap neben anderen Zahlungsoptionen. Bei Auswahl werden sie auf eine sichere, von BlueSnap gehostete Seite zur Eingabe der Zahlungsdaten weitergeleitet. Die Seite ist für Mobile und Desktop optimiert und bietet ein reibungsloses Nutzererlebnis.
    • Gespeicherte Zahlungsmethoden: Wenn Sie die Funktion „Karte speichern“ aktiviert haben, können eingeloggte Kunden ihre Kreditkarte für zukünftige Bestellungen speichern. Später können sie diese gespeicherten Karten in ihrem Kontobereich verwalten oder löschen das erhöht Komfort und Transparenz bei wiederkehrenden Zahlungen.
    • Bestellverwaltung: Nach der Zahlung wird der Bestellstatus in Shopware automatisch basierend auf der BlueSnap-Antwort aktualisiert (z. B. „Bezahlt“ oder „Erstattet“). Sie können Transaktionsdetails (Autorisierungs-ID, Erstattungsbeträge, Rückbuchungen usw.) direkt im Bestellbearbeitungsbildschirm einsehen. Die sofortige Synchronisierung des Zahlungsstatus hält Ihre Backend-Daten ohne manuelle Prüfungen aktuell.
    • Reporting & Dashboard: BlueSnap-Transaktionen erscheinen ebenfalls in Ihren Shopware-Umsatzberichten. Nutzen Sie die Shopware-Reporting-Tools, um Umsätze nach Zahlungsart (BlueSnap) zu filtern oder Erlöse in verschiedenen Währungen zu prüfen. Das BlueSnap Merchant Portal bietet erweiterte Analysen und Auszahlungsinformationen, wenn Sie tiefere Einblicke benötigen.

Insgesamt ist keine spezielle Schulung erforderlich Shop-Betreiber und Mitarbeiter können BlueSnap-Zahlungen über die vertraute Shopware-Oberfläche abwickeln. Bei Bedarf können Sie im BlueSnap Merchant Portal jederzeit detailliertere Transaktionsdaten und Berichte einsehen.

Entwicklerressourcen

Für Entwickler bietet BlueSnap ein robustes Toolkit, um Ihre Shopware-Integration anzupassen und zu erweitern:

• • • Open-Source-Plugin-Code: Das BlueSnap-Plugin (von solution25) ist auf GitHub als Open Source verfügbar. Sie können den Code prüfen oder anpassen, um individuelle Workflows abzubilden. Beispielsweise können Sie Templates überschreiben, Zahlungsbedingungen erweitern oder das Plugin mit anderen Shopware-Erweiterungen integrieren.
    • API & Webhooks: Die RESTful-API von BlueSnap bietet vollständige Kontrolle über Zahlungen, Rückerstattungen, Abonnements und mehr. Während das Plugin den Standardablauf abdeckt, können Entwickler die API für erweiterte Funktionen oder Drittanbieter-Integrationen nutzen. Das Plugin lauscht auf BlueSnap-Webhooks wie CHARGE und CHARGEBACK, um Shopware synchron zu halten; bei Bedarf können Sie diese Ereignisse auch in eigenem Code oder eigenen Plugins verarbeiten.
    • Sandbox-Tests: BlueSnap stellt eine Sandbox-Umgebung für Entwicklung und QA bereit. Verwenden Sie die im Plugin hinterlegten Sandbox-Zugangsdaten, um Transaktionen ohne echte Karten zu simulieren. So können Sie Dinge wie Fehlerbehandlung, 3DS-Abläufe und Rückerstattungen testen.
    • Sicherheit & Compliance: Die Bibliotheken und gehosteten Felder von BlueSnap erfüllen hohe Sicherheitsstandards. Entwickler sollten sicherstellen, dass auf der Shopware-Site SSL aktiviert ist (BlueSnap erfordert HTTPS für eingebettete Frames). Vermeiden Sie es, API-Zugangsdaten im Code zu protokollieren oder offenzulegen – bewahren Sie sie sicher in der Plugin-Konfiguration auf.
    • Sprach- und Plattformunterstützung: Die Dienste von BlueSnap und das Plugin unterstützen mehrsprachige Deployments (Shopware kann die Zahlungsseite in 29 Sprachen darstellen). Das Plugin ist kompatibel mit Shopware 6.x auf PHP 7.x/8.x (siehe Shopware-Anforderungen). Für benutzerdefinierte Themes oder Storefront-Anpassungen kann die gehostete Checkout-Seite bei Bedarf über den Page Designer von BlueSnap gestaltet werden.

Weitere Informationen finden Sie in den BlueSnap Developer Docs mit vollständigen API-Referenzen, Codebeispielen und Integrationsanleitungen. Die Kombination aus Shopware-Plugin und BlueSnap-APIs bietet Ihrem Entwicklungsteam eine flexible Grundlage für jede erweiterte Zahlungslösung.

Bewährte Vorgehensweisen

Um das Beste aus Ihrer BlueSnap-Shopware-Integration herauszuholen, beachten Sie diese Best Practices:

• • • Zuerst im Sandbox-Modus testen: Verwenden Sie für erste Tests immer die BlueSnap-Sandbox-Umgebung. Verifizieren Sie, dass Checkout, Rückerstattungen und Webhooks wie erwartet funktionieren, bevor Sie in den Live-Modus wechseln.
    • 3D Secure aktivieren: Schalten Sie 3D Secure (3DS) sowohl in Ihrem BlueSnap-Konto als auch im Shopware-Plugin ein. 3DS fügt für Kartenzahlungen eine zusätzliche Authentifizierungsebene (z. B. SMS-Codes) hinzu und reduziert Betrug erheblich.
    • API-Schlüssel schützen: Halten Sie Ihre BlueSnap-API-Zugangsdaten geheim. Betten Sie sie nicht in öffentlich zugänglichen Code ein und teilen Sie sie nicht. Rotieren Sie Schlüssel, wenn Sie einen Vorfall vermuten. Geben Sie Schlüssel nur in der gesicherten Shopware-Admin-Oberfläche ein.
    • Kartenspeicherung kommunizieren: Wenn Sie gespeicherte Kartenzahlungen (Vaulted Shopper) anbieten, informieren Sie Kunden darüber, dass ihre Karte sicher gespeichert werden kann. Stellen Sie klare Links bereit, über die sie gespeicherte Karten in ihrem Kontobereich verwalten oder löschen können.
    • Transaktionen überwachen: Prüfen Sie regelmäßig das BlueSnap Merchant Portal und die Shopware-Bestellprotokolle auf fehlgeschlagene oder markierte Transaktionen. Schnelles Handeln bei Streitfällen oder Ablehnungen kann Umsatzverluste minimieren.
    • Plugin aktuell halten: Aktualisieren Sie das BlueSnap-Plugin, sobald eine neue Version verfügbar ist. Updates können Sicherheitsverbesserungen, neue Funktionen oder Kompatibilitäts-Fixes enthalten. Aktuell zu bleiben sorgt für einen reibungslosen Betrieb.

Wenn Sie diese Richtlinien befolgen, ist der Shopware-BlueSnap-Zahlungsfluss sicher, zuverlässig und für Ihre Kunden wie auch Ihr Unternehmen optimiert.

BlueSnap vs. andere Zahlungs-Gateways

Wie schneidet BlueSnap im Vergleich zu anderen Zahlungslösungen wie Stripe oder PayPal ab? Hier sind einige Unterscheidungsmerkmale:

• • • • Globale Reichweite mit einem Konto: BlueSnap unterstützt den Verkauf in über 200 Regionen mit bevorzugten globalen Zahlungsmethoden und Währungen – alles über ein einziges Händlerkonto. Stripe erfordert für den internationalen Verkauf separate regionale Konten (z. B. eines für die USA, eines für die EU). Das macht BlueSnap für einen globalen Shopware-Store einfacher einmal integrieren und weltweit Zahlungen akzeptieren.
      • Breite Zahlungsoptionen: Unterstützt Kreditkarten, PayPal, Apple Pay, Google Pay, Amazon Pay, Skrill und Alipay – alles auf einer Plattform.

Zusammenfassend liegt BlueSnaps Vorteil in globaler Flexibilität und integriertem Risikomanagement in einer Lösung. Es ergänzt (oder ersetzt) Gateways wie Stripe und PayPal, indem es mehr Zahlungsarten und erweiterte Tools hinzufügt, ohne Ihre Abläufe zu fragmentieren.

Häufig gestellte Fragen

• F: Benötige ich ein BlueSnap-Konto, um dieses Plugin zu nutzen? Ja. BlueSnap ist der Zahlungsabwickler im Hintergrund. Sie müssen sich für ein BlueSnap-Händlerkonto (Live und Sandbox) registrieren, um Ihre API-Zugangsdaten (Key, Passwort, Merchant ID) zu erhalten und das Plugin nutzen zu können.
• F: Welche Zahlungsmethoden kann ich akzeptieren? BlueSnap für Shopware unterstützt alle gängigen Kredit- und Debitkarten, digitale Wallets (Apple Pay, Google Pay, Click-to-Pay) sowie viele Lastschriftoptionen (ACH, SEPA usw.) und PayPal sowie andere E-Wallets über BlueSnap. Die genauen Optionen hängen von der Konfiguration Ihres BlueSnap-Kontos ab.
• F: Ist das BlueSnap-Shopware-Plugin einfach zu installieren? Ja. Sie können es mit einem Klick aus dem Shopware Community Store installieren oder per Composer/Git klonen. Es ist keine Programmierung erforderlich; die Einrichtung erfolgt über die Shopware-Admin-Oberfläche (Einstellungen > Plugins). Der Schritt-für-Schritt-Prozess ist oben beschrieben.
• F: Wie erhalte ich meine BlueSnap-API-Zugangsdaten? Melden Sie sich in Ihrem BlueSnap-Konto (oder Sandbox) an und gehen Sie zu den API-Einstellungen. Dort können Sie Ihren API Key, das API Password erstellen oder kopieren und Ihre Merchant ID (MID) finden. Verwenden Sie diese Werte in der Plugin-Konfiguration.
• F: Welche Versionen von Shopware werden unterstützt? Das Plugin ist kompatibel mit Shopware 6 (einschließlich 6.4 und 6.5). Es nutzt das Plugin-System und die Systemanforderungen von Shopware. Stellen Sie sicher, dass Ihre Shopware-Installation die offiziellen Shopware-6-Anforderungen erfüllt.
• F: Werden Zahlungen sicher verarbeitet? Absolut. BlueSnap ist vollständig PCI-DSS-konform. Kundendaten werden auf der sicheren, verschlüsselten Checkout-Seite von BlueSnap erfasst – nicht auf Ihrem Server. Sie können zudem 3D Secure für zusätzliche Sicherheit aktivieren. BlueSnap verfügt über PCI-validierte Rechenzentren und hält strenge Sicherheitsstandards ein.
• F: Kann ich Rückerstattungen und Chargebacks verarbeiten? Ja. Sie können Rückerstattungen entweder im Shopware-Bestellbildschirm oder im BlueSnap Merchant Portal vornehmen. Der Status wird automatisch mit Shopware synchronisiert. Bei Chargebacks benachrichtigt Sie BlueSnap per Webhook, und die Streitfalldetails können über das Portal bearbeitet werden.
• F: Unterstützt BlueSnap wiederkehrende Zahlungen/Abonnements? Die Plattform von BlueSnap unterstützt Abonnements und wiederkehrende Zahlungen (mit gespeicherten Karten oder PayPal), wenn Sie deren Subscription-API oder AR Automation nutzen. Das Shopware-Plugin selbst konzentriert sich auf einmalige Zahlungen, aber gespeicherte Zahlungstoken können für benutzerdefinierte Abonnementlogik über die API verwendet werden.

Tipps zur Fehlerbehebung

• • • Plugin wird nicht angezeigt: Stellen Sie sicher, dass Sie den Plugin-Ordner in custom/plugins abgelegt und bin/console plugin:refresh ausgeführt haben. Leeren Sie den Cache und prüfen Sie Erweiterungen > Meine Erweiterungen.
    • Ungültige Zugangsdaten: Überprüfen Sie API Key, Passwort und Merchant ID. Stellen Sie sicher, dass Sie die richtigen Zugangsdaten für den gewählten Modus (Sandbox vs. Live) verwenden.
    • 3D Secure-Fehler: Wenn 3DS-Fehler auftreten, stellen Sie sicher, dass Sie 3DS zuerst in Ihrem BlueSnap-Konto aktiviert haben; andernfalls funktioniert die 3DS-Einstellung des Plugins nicht.
    • Zahlung abgelehnt: Prüfen Sie den von BlueSnap zurückgegebenen Ablehnungsgrund (unzureichende Mittel, AVS-Mismatch usw.). Verifizieren Sie außerdem die Währungs- und Ländercodes – diese müssen mit den erlaubten Einstellungen in Ihrem BlueSnap-Konto übereinstimmen.
    • Webhook- oder Benachrichtigungsprobleme: Wenn sich Bestellstatus nicht aktualisieren, prüfen Sie die Callback-/Webhook-URLs in Ihrem BlueSnap-Konto und ob diese erreichbar sind. Stellen Sie außerdem sicher, dass Ihre Shopware-Site über HTTPS zugänglich ist.
    • Styling- oder Layout-Probleme: Die von BlueSnap gehostete Seite kann über Ihr BlueSnap-Portal angepasst werden. In Shopware gilt: Wenn das Zahlungsseiten-Frame seltsam aussieht, stellen Sie sicher, dass Ihr Theme das Plugin unterstützt und keine JS-Konflikte bestehen.
    • Fehlermeldungen: Überprüfen Sie die Shopware-Logs (var/logs/) und die API-Logs im BlueSnap Merchant Portal auf Fehlermeldungen. Diese können Hinweise geben (z. B. eine fehlerhafte Anfrage oder Authentifizierungsprobleme).

Wenn Probleme bestehen bleiben, ziehen Sie die BlueSnap-Dokumentation zu Rate oder wenden Sie sich an den BlueSnap-/solution25-Support.

Starten Sie noch heute

Die Shopware-6-Integration von BlueSnap ist eine leistungsstarke Möglichkeit, Ihrem E-Commerce-Store sichere und flexible Zahlungen hinzuzufügen. Mit Unterstützung für mehrere Zahlungsmethoden, erweitertem Betrugsschutz und einer benutzerfreundlichen Einrichtung können Sie die Checkout-Konversionen und das Vertrauen Ihrer Kunden verbessern. Bereit, Ihre Shopware-Zahlungen auf die nächste Stufe zu bringen? Laden Sie das BlueSnap-Plugin aus dem Shopware Store herunter und konfigurieren Sie Ihr Konto noch heute. Weitere Informationen finden Sie auf der BlueSnap-Website oder kontaktieren Sie unser Team, um loszulegen.