Shopware

Einführung

Unser Shopware Plugin bietet regelmäßige Updates und einen vollständigen Integrationssupport. So verfügen Sie über eine flexible, sofort einsatzbereite Lösung für die reibungslose Annahme von Online-Zahlungen:

• Unterstützt Hosted Checkout PageIntegrationsmodus

• Bietet auf unserer Plattform die folgenden Zahlungsarten:
  Alipay+
  American Express
  Apple Pay
  Bancontact
  Bizum
  Carte Bancaire
  Diners Club
  iDEAL
  Illicado
  Intersolve
  JCB
  Maestro
  MasterCard
  Multibanco
  PayPal
  Visa
  WeChat Pay

Beachten Sie unser Änderungsprotokoll, um über Updates und neue Funktionen auf dem Laufenden zu bleiben (z.B. Zahlungsmethoden, Features, Integrationsmodi), die wir diesem Plugin hinzugefügt haben.

In unserer Dokumentation erfahren Sie, wie Sie Ihren Store direkt mit unserer Plattform verbinden, um von all diesen Vorteilen zu profitieren!

Plugin herunterladen

Ältere Versionen herunterladen

Konto erstellen

Um Transaktionen mit diesem Plugin zu verarbeiten, benötigen Sie ein Konto auf unserer Plattform.

Dieses Plugin funktioniert sowohl in unserer Test- als auch Live-Umgebung. Mit einem Testkonto können Sie sich mit dem Plugin und unserer Plattform vertraut machen. Wenn Sie dann live gehen möchten, erstellen Sie ein Produktionskonto oder kontaktieren uns.

Plugin installieren

Der erste Schritt zur Nutzung des Plugin ist die Installation. Vorab sollten Sie sicherstellen, dass Ihre Infrastruktur die folgenden Systemanforderungen erfüllt:

Element	Beschreibung
Plugin-Paket	Laden Sie das Plugin herunter Ältere Versionen herunterladen
Direct Anmeldedaten	Aktives Test-/Live-Konto auf unserer Plattform API key/secret Webhooks
Shopware	Dieses Plugin unterstützt Shopware Version v6.4.x.x (und höher)
Einhaltung von PCI	SAQ A Die eingebauten Eigenschaften des Plugin erfüllen die Anforderungen dieser Sicherheitsstufe. Aber dennoch müssen Sie das Zertifikat bei Ihrem Acquirer einholen.

Danach führen Sie die folgenden Schritte aus:

1. Melden Sie sich im Shopware Back Office an. Gehen Sie zu Extensions > My extensions > Upload extension
2. Klicken Sie auf die Schaltfläche „Upload extension“. Klicken Sie im Pop-up-Menü auf „Bestätigen“ und laden Sie das Paket hoch
3. Geben Sie nach der Installation „Worldline Online Zahlungen“ in die Suchleiste „Erweiterung suchen...“ ein. Aktivieren Sie die Erweiterung mit dem Schieber

Plugin konfigurieren

Nach der Installation müssen Sie das Plugin konfigurieren, um Ihren Store mit unserer Plattform zu verbinden.

1. Melden Sie sich bei Shopware Back Office an. Gehen Sie zu Extensions > My extensions > Apps
2. Geben Sie „Worldline Online payments“ in die „Find extension…“ Suchleiste ein

Merkmal

Beschreibung/Aktionen

Sales channel

Legen Sie fest, ob Sie die Einstellungen global für alle Ihre Stores („All Sales Channels“) oder für einen einzelnen Store anwenden möchten (wählen Sie die entsprechende Option aus der Dropdown-Liste) Wenn Sie einen einzelnen Store auswählen, können Sie jeden Eigenschaftswert aus den globalen Einstellungen übernehmen, die Sie in „All Sales Channels“ konfiguriert haben. Dazu klicken Sie auf „Restore inheritance“ auf dem Linker-Symbol für eine der verfügbaren Eigenschaften

Merchant Id	Geben Sie Ihre Test-/Live-PSPID von unserer Plattform ein, die Sie für die Verarbeitung der Transaktionen verwenden möchten
API Key	Geben Sie den Test/Live-API Key Ihrer Test- oder Live-PSPID ein. Lesen Sie in unserer Anleitung, wie Sie einen generieren
API Secret	Geben Sie das Test/Live-API Secret Ihrer Test- oder Live-PSPID ein. Lesen Sie in unserer Anleitung, wie Sie eines generieren
Webhook key	Geben Sie den webhooks Key Ihrer Test- oder Live-PSPID aus dem Merchant Portal wie in unserer Anleitung beschrieben ein
Webhook secret	Geben Sie das webhooks Secret Ihrer Test- oder Live-PSPID aus dem Merchant Portal wie in unserer Anleitung beschrieben ein
Live endpoint	https://payment.direct.worldline-solutions.com
Sandbox endpoint	https://payment.preprod.direct.worldline-solutions.com
Is live mode	(De-)Aktivieren Sie die Option, um Ihren Shop mit der jeweiligen Umgebung zu verbinden. Je nach Ihrer Wahl sendet das Shop-Modul die Transaktionsanfragen an die Test- oder Produktionsumgebung Beachten Sie, dass Sie diese Eigenschaften immer nur für jeweils eine Umgebung konfigurieren können Achten Sie darauf, dass Sie: alle Test-Zugangsdaten durch Live-Zugangsdaten ersetzen / „Is live mode“ aktivieren, sobald Sie Ihre Tests abgeschlossen haben bei der Konfiguration dieser Eigenschaften Daten aus Test/Produktion (und umgekehrt) nicht zu verwechseln
Payment Methods	Legen Sie, welche Zahlungsmethoden für Ihre Kunden auf der Hosted Checkout Page verfügbar sind „Wordline full redirect“ aktiv: Alle in Ihrer Test-/Live-PSPID aktiven Zahlungsmethoden sind verfügbar „Wordline full redirect“ inaktiv: Wählen Sie mit dem Schieber alle Zahlungsarten aus, um sie verfügbar zu machen Achten Sie darauf, dass Sie die Schaltfläche „Save“ für diese Eigenschaft verwenden, um die Einstellungen Ihrer Zahlungsmethode zu bestätigen
Automatic capture	Legen Sie fest, ob die Transaktionen im Autorisierungsmodus oder als Direktverkauf bearbeitet werden sollen. Wählen Sie je nach Ihren geschäftlichen Anforderungen eine der folgenden Optionen: „Disabled“: Der Betrag wird nur auf der Karte Ihres Kunden blockiert (=autorisiert). Erfolgreiche Transaktionen haben status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=5. Nutzen Sie diesen Modus, wenn Sie eine Transaktion erst nach dem Versand der Bestellung erfassen möchten Im Shopware „Orders“-Modul ist der Status „Authorized“ „Immediately“: Der Betrag wird in einem Schritt blockiert und ausgezahlt (=erfasst). Bei erfolgreichen Transaktionen wird status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9 angezeigt Im Shopware „Orders“-Modul ist der Status „Paid“ „In X day(s)“: Legt für autorisierte Transaktionen eine Verzögerung von X Tagen fest. Nach diesem Zeitraum erfasst das Shopware-Modul diese Transaktionen automatisch Im Shopware „Orders“-Modul haben die erfassten Transaktionen zunächst den noch ausstehenden Status „In Progress“. Diese Transaktionen haben den vorläufigen Status=“CAPTURE_REQUESTED“ / statusOutput.statusCategory="PENDING_CONNECT_OR_3RD_PARTY" / statusOutput.statusCode=91 Sobald unsere Plattform das endgültige Ergebnis der Erfassungsanfrage erhalten hat, aktualisiert das Shopware „Orders“-Modul die Transaktion auf „Paid“ (status=„CAPTURED“ / statusOutput.statusCategory="COMPLETED" /statusOutput.statusCode=9) oder „OPEN“ (status=„REJECTED_CAPTURE“ / statusOutput.statusCategory="UNSUCESSFUL" / statusOutput.statusCode=93) Wenn Sie diese Eigenschaft auf „Disabled“ setzen, müssen Sie Folgendes beachten: Stellen Sie sicher, dass Sie autorisierte Transaktion später erfassen. Erst dann hat die Transaktion (status="CAPTURED" / statusOutput.statusCategory="COMPLETED" /statusOutput.statusCode=9), für den Sie die tatsächliche Zahlung für die Transaktion erhalten Erfassen Sie die Transaktion im Shopware Back Office mit dem Order -Modul. Klicken Sie auf die Schaltfläche „...“ und klicken Sie auf „Configuration“

1. Klicken Sie auf die Schaltfläche „Save“ oben im Bildschirm, um Ihre Einstellungen zu bestätigen
2. Klicken Sie auf die Schaltfläche „Test connection“, um Sie die Konfiguration zu überprüfen, indem Sie eine Testverbindung zwischen dem Plugin und unserer Plattform herstellen. Vergewissern Sie sich, dass in dem Pop-up-Fenster die Meldung „Connection was successfully tested“ angezeigt wird. Wenn ein fehlgeschlagener Test angezeigt wird, gehen Sie wie folgt vor:
   a) Überprüfen Sie den/das API Key/Secret und/oder Webhook Key/Secret und konfigurieren Sie sie auf unserer Plattform/im Shopware Back Office
   b) Wenn der Verbindungstest weiterhin fehlschlägt: Wenden Sie sich an zur Fehlersuche an Ihren Systemadministrator

Zahlungen verwalten

Unser Plugin ist so konzipiert, dass Ihre Aufträge automatisch und autonom bearbeitet werden. Das befreit Sie von lästigen Verwaltungsarbeiten. Hier erfahren Sie, wie Sie Ihr Plugin effektiv für Ihre Geschäfte nutzen können.

Wartungsmaßnahmen durchführen

Erfassen, Gutschriften und die Stornierung von Autorisierungen sind Standardverfahren (Wartungsmaßnahmen) Ihrer täglichen Geschäftsabläufe. Hier erfahren Sie, wie Sie diese Tätigkeiten direkt im ShopwareBack Office ausführen:

1. Melden Sie sich bei Shopware Back Office an. Gehen Sie zu Orders > Overview. Klicken Sie auf die Bestellung in der Tabelle
2. Gehen Sie in der Bestellübersicht zu Worldline transaction control. Je nach dem Status der Bestellung (Spalte „Payment status“ Orders > Overview) sind die folgenden Schaltflächen verfügbar:
   
   

   Bestellstatus in Worldline / Shopware	Verfügbare Schaltflächen
   statusOutput.statusCode=5 / Authorized	„Capture payment“: Den autorisierten Betrag erfassen, um die Finanzmittel für die Bestellung zu erhalten „Cancel payment“: Den autorisierten Betrag stornieren
   statusOutput.statusCode=9 / Paid	„Refund payment“: Die Finanzmittel für die Bestellung zurückerstatten
   Beliebiger Status	"Check status": Send a status update request to our platform to get its current status

Testtransaktionen durchführen

Verwenden Sie die Test-Umgebung unserer Plattform, um sicher zu gehen, dass Ihr Plugin wie gewünscht funktioniert. Wir bieten Testdaten auf unserer eigens dafür eingerichteten Testszenarios-Seite. Steuern Sie unsere Test-Umgebung wie im Kapitel "Plugin konfigurieren" beschrieben an.