Shopify

Plugin installieren

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

Danach führen Sie die folgenden Schritte aus:

1. Melden Sie sich im Shopify Back Office an. Gehen Sie zu Settings > Payments
2. Klicken Sie auf die Schaltfläche „Add payment methods“. Geben Sie „Worldline Online payments“ im Reiter „Search by provider“ in der Suchmaske ein
3. Klicken Sie auf „Activate“. In „Account status“: Klicken Sie auf „Connect“, um das Plugin zu konfigurieren

Plugin konfigurieren

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

Grundeinstellungen konfigurieren

1. Melden Sie sich im Shopify Back Office an. Gehen Sie zu Stores > Worldline Online Payments > Login
2. Gehen Sie zu Settings > Payments. Suchen Sie in Supported payment methods den Abschnitt „Worldline Online Payments“. Klicken Sie auf Manage, um die folgenden Einstellungen zu konfigurieren:
   

   Merkmal	Beschreibung/Aktionen
   Activate/Deactivate Worldline Online Payments	Klicken Sie auf die Schaltfläche „Activate/Deactivate Worldline Online Payments“, um das Plugin zu aktivieren/deaktivieren Klicken Sie auf „Save“, um Ihre Einstellungen zu bestätigen
   Test mode	(De-)Aktivieren Sie „Enable test mode“, um Ihren Shop mit der jeweiligen Umgebung zu verbinden. Je nach Ihrer Wahl sendet das Shop-Modul die Transaktionsanfragen an die Test- oder Produktionsumgebung Klicken Sie auf „Save“, um Ihre Einstellungen zu bestätigen Achten Sie auf Folgendes: bei der Konfiguration von „Merchant Credentials“-Feldern Daten aus Test/Produktion (und umgekehrt) nicht zu verwechseln „Testmodus aktivieren“ zu deaktivieren, nachdem Sie Ihre Tests beendet haben
   Settings > Merchant Credentials > Account status > Manage	Geben Sie folgende Anmeldedaten in diese Felder ein: Merchant Credentials „Production/Test Merchant Id“: Geben Sie die PSPID von unserer Plattform ein, die Sie für die Verarbeitung der Transaktionen verwenden möchten „Production/Test Api Key“: Geben Sie den Test/Live-API-Schlüssel Ihrer Test- oder Live-PSPID ein. Lesen Sie in unserer Anleitung, wie Sie einen generieren „Production/Test Api Secret“: Geben Sie das Test/Live-API-Geheimnis Ihrer Test- oder Live-PSPID ein. Lesen Sie in unserer Anleitung, wie Sie eines generieren Webhook Settings „Webhooks Key“: Geben Sie den Webhooks-Schlüssel Ihrer Test- oder Produktions-PSPID aus dem Merchant Portal wie in unserer Anleitung beschrieben ein „Webhooks Key Secret“: Geben Sie das Webhooks-Geheimnis Ihrer Test- oder Produktions-PSPID aus dem Merchant Portal wie in unserer Anleitung beschrieben ein Webhook URL „Webhooks URL“: Kopieren Sie diese URL in die Felder für die Endpoint URLs im Merchant Portal, wie in unserer Anleitung beschrieben Payment Service Provider „Payment Service Provider API URL“: Geben Sie unsere LIVE-Endpunkt-URL payment.direct.worldline-solutions.com ein „Payment Service Provider Test API URL“: Geben Sie unsere Test-Endpunkt-URL payment.preprod.direct.worldline-solutions.com ein Hosted Checkout Variant „Hosted Checkout Variant“: Geben Sie den Dateinamen Ihrer Vorlage ein, um unsere Zahlungsseite an das Design Ihres Shops anzupassen. Hier erfahren Sie, wie Sie Vorlagen erstellen Klicken Sie auf „Save“, um Ihre Einstellungen zu bestätigen

Zahlungsarten konfigurieren

1. Melden Sie sich bei Shopify Back Office an. Gehen Sie zu Stores > Worldline Online Payments > Login
2. Gehen Sie zu Settings > Payments. Konfigurieren Sie die folgenden Einstellungen:

   Merkmal	Beschreibung/Aktionen
   Add payment methods	Bei Installation des Plugins werden alle Zahlungsarten, die das Plugin unterstützt und die in Ihrem Konto aktiv sind, automatisch verfügbar gemacht
   Payment capture	Legen Sie mit einem Klick auf die Schaltfläche „Payment capture“ fest, ob die Transaktionen im Autorisierungsmodus oder als Direktverkauf bearbeitet werden sollen. Wählen Sie eine der folgenden Optionen: „Automatically capture payment for orders“: Der Betrag soll laut Bestellung in einem Durchgang ausgezahlt werden. Bei diesem Modus erhalten Sie das Geld vor dem Versand der Bestellung. Es sind keine weiteren Aktionen erforderlich, um die Transaktion zu erfassen. Bei erfolgreichen Transaktionen wird status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9 angezeigt Im Shopify Back Office ist der Status dann „Paid“ „Manually capture payment for orders“: Der Betrag wird nur auf der Karte Ihres Kunden blockiert. 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) In Shopify Back office ist der Status „Authorized“ Klicken Sie auf „Save“, um Ihre Einstellungen zu bestätigen Achten Sie auf Folgendes, wenn „Payment capture“ auf „Manually capture payment for orders“ eingestellt ist: Stellen Sie sicher, dass Sie autorisierte Transaktion später erfassen. Nur dann weist die Transaktion status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9 auf, weshalb Sie die Zahlung für die Transaktion tatsächlich erhalten Erfassen Sie die Transaktion in Shopify Back Office mit dem Order -Modul

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 diese Operationen direkt im Shopify Back Office ausgeführt werden:

1. Melden Sie sich im Shopify Back Office an und gehen Sie zu Orders. Klicken Sie auf die Bestellung in der Tabelle
2. In der Bestellungsübersicht sind je nach dem Status der Bestellung die folgenden Schaltflächen verfügbar:

   Bestellstatus	Verfügbare Schaltflächen
   statusOutput.statusCode=5 / Authorized	„Capture payment“: Den autorisierten Betrag erfassen, um die Finanzmittel für die Bestellung zu erhalten More actions > Cancel order: Den autorisierten Betrag stornieren
   statusOutput.statusCode=9 / Paid	More actions > Cancel order: Die Finanzmittel für die Bestellung zurückerstatten

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.