worldline Direct
Sign up

Einführung

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

Bietet auf unserer Plattform die folgenden Zahlungsarten:

Alipay
American Express
Apple Pay
Bancontact
Bizum
Carte Bancaire
Cpay
Diners Club
iDEAL
Illicado
Intersolve
JCB
Klarna
Maestro
MasterCard
Multibanco
Oney 3x-4x
OneyBrandedGiftCard
PayPal
Visa
WeChatPay

  • Verwaltet mehrere Stores
  • Akzeptiert Zahlungsvorgänge (Gutschriften, Autorisierungen, Erfassungen usw.) direkt von Ihrem PrestaShop Back Office

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

Schauen Sie sich unsere Dokumentation an, um zu erfahren, wie Sie Ihren Store direkt mit unserer Plattform verbinden, um von all diesen Vorteilen zu profitieren. 

Plugin herunterladen / GitHub-Repository

Plugin herunterladen

GitHub repository

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

Direct Anmeldedaten
PrestaShop

Das Plugin unterstützt die PrestaShop-Version:

  • v1.7.0+

Das Plugin wurde gegen und bis zu PrestaShop v1.7.7.8 getestet.

Voraussetzungen PrestaShop
  • Es sind keine technischen Voraussetzungen für Ihr Hosting erforderlich (nur die Ausführung der erwähnten PrestaShop-Version).
  • cURL Bibliothek sollte vorhanden sein.
    Denken Sie daran, Genehmigungen in diesem Verzeichnis zu erteilen:
    . "/modules"
  • Das PrestaShop Back Office wird während der Installation von Worldline Online Payment Module in dieses PrestaShop Standardverzeichnis hochladen: Zugriffsrechte 755 erforderlich
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.

Dieses Installationsverfahren gilt für beide Szenarien:

  • ein brandneues PrestaShop Projekt
  • Migration von einem alten PrestaShop Plugin
  • Wir empfehlen, dieses Plugin als eine neue Installation zu behandeln. Es besteht kein Zusammenhang mit dem alten Modul.

Danach führen Sie die folgenden Schritte aus:

  1. Einloggen ins PrestaShop Back Office. Weiter zu VERBESSERN > Module > Modulkatalog. Klicken Sie auf „Ein Modul hochladen“ und laden Sie die Zip-Datei hoch.
  2. Der Installationsprozess beginnt automatisch. Danach können Sie das Plugin konfigurieren.
  3. Klicken Sie auf die Schaltfläche „Konfigurieren“, um mit der Konfiguration zu beginnen. Diese Konfigurationsseite erlaubt Ihnen die Konfiguration der generischen Parameter des Store, insbesondere in einem „Multistore“-Kontext.

PrestaShop-1.png
The image above shows where to upload the module.

Wenn Sie das Modul stattdessen via FTP installieren möchten, dann führen Sie die folgenden Schritte aus:

  1. Dekomprimieren Sie die Zip-Datei für das PrestaShop Modul.
  2. Laden Sie die gesamte Datei „worldlineop“ via FTP-Datei in das Dateiverzeichnis <yourdomain>/modules hoch.
  3. Einloggen ins PrestaShop Back Office. Weiter zu VERBESSERN > Module > Modulkatalog. Suchen Sie in der Suchleiste nach „worldline online payment“.
  4. Das Modul erscheint als Suchergebnis. Klicken Sie auf die Schaltfläche „Installieren“, um die Standardinstallation fortzusetzen.
The image above shows where to upload the module

Danach führen Sie die folgenden Schritte aus:

  1. Einloggen ins PrestaShop Back Office. Weiter zu VERBESSERN > Module > Modulkatalog. Klicken Sie auf „Ein Modul hochladen“ und laden Sie die Zip-Datei hoch.
  2. Der Installationsprozess beginnt automatisch. Danach können Sie das Plugin konfigurieren.
  3. Klicken Sie auf die Schaltfläche „Konfigurieren“, um mit der Konfiguration zu beginnen. Diese Konfigurationsseite erlaubt Ihnen die Konfiguration der generischen Parameter des Store, insbesondere in einem „Multistore“-Kontext.

PrestaShop-1.png
The image above shows where to upload the module.

Wenn Sie das Modul stattdessen via FTP installieren möchten, dann führen Sie die folgenden Schritte aus:

  1. Dekomprimieren Sie die Zip-Datei für das PrestaShop Modul.
  2. Laden Sie die gesamte Datei „worldlineop“ via FTP-Datei in das Dateiverzeichnis <yourdomain>/modules hoch.
  3. Einloggen ins PrestaShop Back Office. Weiter zu VERBESSERN > Module > Modulkatalog. Suchen Sie in der Suchleiste nach „worldline online payment“.
  4. Das Modul erscheint als Suchergebnis. Klicken Sie auf die Schaltfläche „Installieren“, um die Standardinstallation fortzusetzen.

4. Plugin konfigurieren

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

Grundeinstellungen konfigurieren

  1. Einloggen ins PrestaShop Back Office. Weiter zu IMPROVE > Modules > Module Manager > Payment. Klicken Sie neben „Worldline Online Payments“ auf „Konfigurieren“.
  2. Gehen Sie zum Tab „MEIN KONTO“ und konfigurieren Sie die folgenden Einstellungen:
    Merkmal Beschreibung/Aktionen
    Umgebung

    Wählen Sie zwischen „Test“ und „Produktion“, um Ihren Shop mit der jeweiligen Umgebung zu verbinden. Je nach Ihrer Wahl sendet das Shop-Modul die Transaktionsanfrage an die Test- oder Produktionsumgebung.

    Achten Sie darauf,

    • nicht die Anmeldedaten von Test mit Live zu verwechseln und umgekehrt, wenn Sie die Felder PSPID/API und die Webhooks-Anmeldedaten konfigurieren
    • zu „Produktion“ zu wechseln, nachdem Sie Ihre Tests beendet haben
    Test / Prod PSPID Geben Sie die PSPID auf unserer Plattform ein, die Sie für die Verarbeitung der Transaktionen verwenden möchten.
    Test / Prod API-Schlüssel Geben Sie den API-Schlüssel Ihrer Test- oder Live-PSPID ein. Erfahren Sie in unserer Anleitung, wie Sie einen generieren.
    Test / Prod API-Geheimnis Geben Sie das API-Geheimnis Ihrer Test- oder Live-PSPID ein. Erfahren Sie in unserer Anleitung, wie Sie eines generieren.
    Test / Prod Webhooks-Schlüssel Geben Sie den Webhooks-Schlüssel Ihres Test- oder Produktionskontos so wie in unserer Anleitung beschrieben ein.
    Geben Sie das Webhooks-Geheimnis Ihres Test- oder Produktionskontos so wie in unserer Anleitung beschrieben ein.
    Webhooks URL Kopieren Sie diese URL in die Felder für die Endpoint URLs in Ihrem Konto, so wie in unserer Anleitung beschrieben.
Dieses Bild zeigt, wo die in der Tabelle erwähnten Merkmale konfiguriert werden sollen.
  1. Klicken Sie auf „Speichern“, wenn Sie nur Ihre Anmeldedaten speichern möchten. Klicken Sie auf „Anmeldedaten speichern und überprüfen“. Achten Sie darauf, dass die Nachricht „Konto-Anmeldedaten sind gültig. Kontoeinstellungen erfolgreich gespeichert.“ erscheint.
  2. Gehen Sie zu IMPROVE > Payment > Preferences. Verbinden Sie Worldline Online Payments mit Gruppen, Transportunternehmen, Ländern und Währungen, so wie es Ihren Geschäftsbedürfnissen entspricht.
  3. Gehen Sie zu CONFIGURE > Advanced parameters > Email. Wenn Sie zur Bestätigung von Bestellungen E-Mails versenden möchten, dann stellen Sie sicher, dass sie von PrestaShop richtig versandt werden. Nutzen Sie dazu „Testen Sie Ihre E-Mail-Konfiguration“.

  • Wenn Sie sich für den Versand von E-Mails entscheiden und dieser nicht richtig funktioniert, beendet das Modul die Erstellung der Bestellung.
  • Wenn Probleme mit dem Versand von E-Mails auftreten, dann sollten Sie diese Funktion über „Nie E-Mails senden“ deaktivieren, bis das Problem behoben ist.

Ihr Plugin ist nun bereit, Zahlungen über unsere Plattform abzuwickeln.

Wenn Sie einige optionale Anpassungen vornehmen möchten, um den Zahlungsvorgang für Ihre Kunden zu optimieren, dann schauen Sie sich den entsprechenden Abschnitt an. Möchten Sie Probleme beheben, die während der Installation/Konfiguration aufgetreten sind? Schauen Sie im Abschnitt über die Behebung von Fehlern nach.

Erweiterte Einstellungen konfigurieren

Wir haben das Plugin für PrestaShop so konfiguriert, dass Transaktionen schnell und leicht abgewickelt werden können. Die folgenden Einstellungen sind optional, aber vielleicht sind sie für Sie von Interesse, um den Zahlungsvorgang für Ihre Kunden zu optimieren und Anpassungen an Ihre geschäftlichen Anforderungen vorzunehmen.

Dazu führen Sie die folgenden Schritte aus:

  1. Einloggen ins PrestaShop Back Office. Weiter zu IMPROVE > Modules > Module Manager > Payment. Klicken Sie neben „Worldline Online Payments“ auf „Konfigurieren“.
  2. „Erweiterte Einstellungen anzeigen“ sollte auf JA eingestellt sein. Gehen Sie zum Tab „ERWEITERTE EINSTELLUNGEN“ und konfigurieren Sie die folgenden Einstellungen:

    Merkmal Beschreibung/Aktionen
    Transaktionsart

    Legen Sie fest, ob die Transaktionen im Autorisierungsmodus oder als Direktverkauf bearbeitet werden sollen. Wählen Sie eine der folgenden Optionen:

    Wenn Sie „Autorisiert“ wählen, konfigurieren Sie auch Folgendes:

    • Verzögerung vor der Erfassung der Zahlung: In dem entsprechenden Feld können Sie die Verzögerung für die Erfassung auf X Tage festlegen. Am Ende dieser Zeitspanne wird die Transaktion automatisch durch einen Cron-Job erfasst. Wenn die Transaktion in der Zwischenzeit bereits teilweise erfasst wurde, werden alle noch verbleibenden verfügbaren Finanzmittel erfasst.
    • Cron-Job erfassen: Kopieren Sie den Cron-Befehl aus dem Plugin und setzen Sie ihn in Ihren PrestaShop-Kern ein, damit er sich selbst ausführen kann.

    Wenn die Transaktionsart auf „Autorisiert“ eingestellt ist, dann beachten Sie Folgendes:

    • 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.
    • Selbst wenn die Verzögerung für die Erfassung auf X Tage eingestellt ist, können Sie Geldbeträge vollkommen / teilweise erfassen, indem Sie eine einzelne Bestellung nach der Lieferung der Güter / Dienstleistungen öffnen.
    Erweitertes Logging aktivieren Wenn Sie im Debug-Modus sind und zusätzliche Logs für die Fehlerbehebung benötigen, dann aktivieren Sie diese Einstellung. Laden Sie hier alle verfügbaren Logs herunter.
    Abänderung des Zahlungsflusses

    Wir empfehlen dringend, die Einstellungen so zu belassen wie sie sind, um eine sichere Verarbeitung der Transaktion zu gewährleisten.

    • Statusanzeige „Zahlung akzeptiert“: Bilden Sie den Status von erfolgreichen Transaktionen gemäß Ihrer Geschäftsabläufe ab.
    • Statusanzeige „Ausstehende Zahlung“: Bilden Sie den Status von ausstehenden Transaktionen gemäß Ihrer Geschäftsabläufe ab.
    • Statusanzeige „Zahlungsfehler“: Bilden Sie den Status von fehlgeschlagenen Transaktionen gemäß Ihrer Geschäftsabläufe ab.
    • Ausstehende Zahlungsaufträge aus dem Bestand entfernen nach: Wählen Sie für alle Aufträge mit einem unbekannten Status die Zeitspanne, nach deren Ablauf die Bestellung auf PrestaShop und auf unserer Plattform durch einen Cron-Job automatisch gelöscht wird.
    • Ausstehender Auftrag Cron-Job: Kopieren Sie den Cron-Befehl aus dem Plugin und setzen Sie ihn in Ihren PrestaShop-Kern ein, damit er sich selbst ausführen kann.
    • Force 3DsV2: (De-) aktivieren Sie die 3-D Secure-Überprüfung. Wir empfehlen dringend, sie auf JA einzustellen, um zu verhindern, dass zahlreiche Transaktionen abgelehnt werden.

    Diese Anzeigen beziehen sich nur auf PrestaShop-Status. The Direct-Status bleiben von dieser Einstellung unberührt.

  3. Klicken Sie auf „Speichern“, um Ihre Einstellungen zu bestätigen.
  4. Gehen Sie zum Tab „ZAHLUNGSARTEN“ und konfigurieren Sie die folgenden Einstellungen:

  • Da das Plugin sowohl Hosted Checkout Page (Umleitungsmodus) als auch Hosted Tokenization Page (Eine-Seite-Check-out) unterstützt, können Sie die geeignete Zahlungsart für Ihre Kunden auswählen oder sogar beide nutzen.
  • Kartenzahlungen sind für beide Arten verfügbar, aber alternative Zahlungsarten sind nur verfügbar für Hosted Checkout Page

UMLEITUNGSMODUS (ALLE ZAHLUNGSARTEN) Beschreibung/Aktionen
Wahl der Zahlungsart nach Umleitung

Passen Sie das Auswahlverfahren für die Zahlungserfahrung/Zahlungsart auf der Check-out-Seite von PrestaShop für den Umleitungsmodus an.

  • JA: Beim Klicken von „BESTELLUNG AUFGEBEN“ auf der Check-out-Seite von PrestaShop leitet das Plugin Ihre Kunden um zu unserer Hosted Checkout Page. Dort ist jede verfügbare Zahlungsart einzeln aufgeführt.
  • NEIN: Das Plugin führt jede verfügbare Zahlungsart auf der Check-out-Seite von PrestaShop auf. Beim Klicken von „BESTELLUNG AUFGEBEN“ leitet das Plugin Ihre Kunden um zu unserer Hosted Checkout Page, die gemäß der Marke der gewählten Zahlungsmethode gestaltet ist.

Das funktioniert nur, wenn „Wahl der Zahlungsart vor Umleitung“ auf JA gesetzt ist.

Bezeichnung des Bezahlbutton

Entwerfen Sie einen Text für die Optionsschaltfläche auf der Check-out-Seite von PrestaShop.

Wahl der Zahlungsart vor Umleitung

Passen Sie das Auswahlverfahren für die Zahlungserfahrung/Zahlungsart auf der Check-out-Seite von PrestaShop an.

  • JA: Das Plugin führt jede verfügbare Zahlungsart auf der Check-out-Seite des PrestaShop auf, die Sie auf „JA“ eingestellt haben. So können Sie bestimmte Zahlungsarten unzugänglich für Ihre Kunden machen, selbst wenn sie für Ihr Konto aktiv sind.

    Klicken Sie auf „Liste der verfügbaren Zahlungsarten erneuern“, um alle aktiven Zahlungsarten Ihres Kontos abzurufen, besonders, wenn Sie Neue aktiviert haben.
  • NEIN: Beim Klicken von „BESTELLUNG AUFGEBEN“ auf der Check-out-Seite des PrestaShop leitet das Plugin Ihre Kunden um zu unserer Hosted Checkout Page. Dort ist jede verfügbare Zahlungsart einzeln aufgeführt.

Das funktioniert nur, wenn „Wahl der Zahlungsart nach Umleitung“ auf JA eingestellt ist.

Dateiname für Vorlage für Zahlungsumleitung

Geben Sie den Dateinamen Ihrer Vorlage ein, um unsere Zahlungsseite an das Design Ihres Shops anzupassen. Hier erfahren Sie, wie Sie Vorlagen erstellen.

EINE-SEITE-CHECK-OUT-MODUS (NUR KARTEN) Beschreibung/Aktionen

Passen Sie das Auswahlverfahren für die Zahlungserfahrung/Zahlungsart auf der Check-out-Seite von PrestaShop an.

  • Nutzen Sie den Eine-Seite-Check-out-Modus für alle Zahlungsarten mit Kreditkarten, die in Ihrem Konto aktiv sind. Alle Kartenmarken sind als eine Wahlmöglichkeit für die Zahlung zusammengefasst. Ihre Kunden geben die Anmeldedaten für ihre Karten direkt auf der Check-out-Seite von PrestaShop in einen iframe ein.
  • NEIN: Nutzen Sie den Umleitungsmodus für alle Zahlungsarten mit Kreditkarten, die in Ihrem Konto aktiv sind.

Das funktioniert nur, wenn entweder „Wahl der Zahlungsart nach Umleitung“ / oder „Wahl der Zahlungsart vor Umleitung“ auf JA eingestellt ist.

Bezeichnung des Bezahlbutton

Entwerfen Sie einen Text für den Bezahlbutton in iframe auf der Check-out-Seite von PrestaShop.

Logo für Ihre Zahlungsseite

Logo auf der Check-out-Seite von PrestaShop anzeigen

Verfügbare Zahlungsarten

Klicken Sie auf die Schaltfläche, um alle aktiven Zahlungsarten Ihres Kontos abzurufen, die der hosted iframe auf der Check-out-Seite von PrestaShop akzeptiert. Diese Schaltfläche dient nur Informationszwecken, da unsere Plattform immer alle aktiven Zahlungsarten für Kreditkarten in Ihrem Konto akzeptiert.

Dateiname der Vorlage

Geben Sie den Dateinamen Ihrer Vorlage ein, um das iframe an das Design Ihres Shops anzupassen. Hier erfahren Sie, wie Sie Vorlagen in unserer Dokumentation erstellen/verwalten.

Sie können dieses Muster herunterladen und es als Standardvorlage verwenden.

  1. Klicken Sie auf „Speichern“, um Ihre Einstellungen zu bestätigen.
Prestashop-5.png
Dieses Bild zeigt den benutzerdefinierten Text für die Optionsschaltfläche auf der Check-out-Seite von PrestaShop. Dieses Bild zeigt das Layout der Check-out-Seite von PrestaShop, wenn „Wahl der Zahlungsart vor Umleitung“ auf JA eingestellt ist. Dieses Bild zeigt das Layout, wenn „Kartenzahlung auf iframe akzeptieren“ auf JA eingestellt ist. Prestashop-7.png
Dieses Bild zeigt ein hochgeladenes Logo und wie es auf der Check-out-Seite von PrestaShop aussieht.
  • Wählen Sie nicht gleichzeitig „NEIN“ für:

    „Wahl der Zahlungsart nach Umleitung“
    „Wahl der Zahlungsart vor Umleitung“
    „Kartenzahlungen auf iframe akzeptieren“.

    So verhindern Sie, dass gar keine Zahlungsmethoden auf Ihrer Check-out-Seite vorhanden sind.

  • Achten Sie darauf, dass alle erforderlichen Zahlungsarten in Ihrem Konto aktiviert sind.

Fehler beheben

Wenn Probleme bei der Installation/Konfiguration oder der Nutzung des Plugin auftreten, dann finden Sie hier eine Liste mit möglichen Lösungen:

  • Nutzen Sie die Standardlogfunktion von PrestaShop (CONFIGURE > Advanced Parameters > Logs), um Probleme mit Nutzerzugriffsrechten und Zeitüberschreitungen zu lösen.
  • Aktivieren Sie den Debug-Modus via CONFIGURE > Advanced Parameters > Performance > Debug mode, um mehr Informationen über mögliche Fehler zu erhalten.
  • Holen Sie sich zusätzliche Logs via IMPROVE > Modules > Module Manager > Payment > ADVANCED SETTINGS > Payment Settings > Enable advanced logging.
  • Überprüfen Sie, ob das Modul richtig verankert ist, um fehlende/nicht korrekt funktionierende Blocks im PrestaShop Back Office oder Front Office zu vermeiden. Gehen Sie zu IMPROVE > Design > Positions. Wählen Sie „Worldline Online Payments“ im „Zeigen“-Dropdown-Menü, um zu bestätigen, dass
    • „Nicht positionierbare Hooks anzeigen“ aktiviert ist.
    • Es findet sich eine Liste mit den folgenden Hooks:

      actionAdminControllerSetMedia
      actionFrontControllerSetMedia
      actionOrderStatusPostUpdate
      customerAccount
      displayAdminOrderLeft
      displayAdminOrderMainBottom
      displayBackOfficeFooter
      displayHeader
      displayPaymentByBinaries
      displayPaymentTop
      displayPDFInvoice
      orderConfirmation
      paymentOptions

      Wenn ein Hook fehlt, gehen Sie zu IMPROVE > Design > Positions. Wählen Sie „Worldline Online Payments“ aus dem Dropdown-Menü „Modul“ und fügen Sie den fehlenden Hook im Feld „Transplantieren“ hinzu.

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 PrestaShop Back Office ausgeführt werden:

  • Einloggen ins PrestaShop Back Office. Gehen Sie zu Verkauf > Einstellungen Bestellungen > Einstellungen Bestellungen. Klicken Sie auf den Auftrag in der Tabelle.
  • Im Überblick der Bestellung gehen Sie auf „Worldline Online Payments“. Je nach dem aktuellen Status der Transaktion können Sie erfassen/stornieren/gutschreiben, indem Sie auf die entsprechende Schaltfläche klicken.
  • Achten Sie darauf, immer den Worldline Online Payments-Block für Wartungstransaktionen zu nutzen.
  • Die Schaltfläche „Teilweise Gutschrift“ oben auf der Bestellseite dient nur administrativen Zwecken, man kann NICHT eine Gutschrifttransaktion damit erstellen.

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.

Sorgen Sie dafür, auf die LIVE-Umgebung zu wechseln, sobald Sie Ihre Tests abgeschlossen haben.

Was this page helpful?

Do you have any comments?

Thank you for your response.