Nutzungsbedingungen

Die angebotenen Erweiterungen werden seitens des Gesellschaft Global Payments Europe, s.r.o. („GPE“) kostenlos geleistet und bilden ausdrücklich nicht den Bestandteil des Sortiments von Produkten und Diensten der Gesellschaft GPE.

Sie wurden für volle Funktionsfähigkeit bei Standardkonfiguration (Zustand bei der Lieferung, „wie sie stehen und liegen“) des entsprechenden Systems der Verkaufsstelle getestet und genehmigt.

Haftungseinschränkung:
DIE GESELLSCHAFT GPE HAFTET UNTER KEINEN UMSTÄNDEN FÜR JEDWEDE ANSPRÜCHE AUS INDIREKTEN, FOLGE-, NEBEN-, SONDER-, EXEMPLAR- ODER SANKTIONSSCHÄDEN ODER ANDEREN ERSTATTUNGEN VOM JEDWEDEN CHARAKTER, UNTER ANDEREM EINSCHLIESSLICH: ENTGANGENE GEWINNE, WERTVERLUST DES GUTEN RUFS, ENTGANGENE NUTZEN, DATENVERLUST, ENTGANGENE KÜNFTIGE GESCHÄFTE ODER ENTGANGENE PRODUKTION, ANSPRÜCHE VON DRITTEN, AUFLÖSUNG DER VON IHNEN ABGESCHLOSSENEN VERTRÄGE ODER ANDEREN IMMATERIELLEN SCHADEN.

Die Gesellschaft GPE kann nicht jedwede Haftung oder Garantie leisten, durch die gesichert wäre, dass Ihr Software, Ihre Systeme oder Ihre Produkte vom Gesichtspunkt möglichen Missbrauchs, unberechtigter Eindringung oder Eingriffs und/oder eventueller Verletzung her nicht angreifbar oder anfällig sind, und leistet sie nicht

Sie, nicht die Gesellschaft GBE, haften ausschließlich für die Absicherung Ihrer Software, Ihrer Systeme und Ihrer Produkte sowie für Entwurf, Herstellung, Angebot, Verkauf und Sicherheit Ihrer Software, Ihrer Systeme und Ihrer Produkte.

Die Gesellschaft GPE leistet keine Garantie und haftet nicht für jedwede Fehler, die in der erweiterten, angepassten Konfiguration des Systems der Verkaufsstelle entstehen.

Der Betrieb in erweiterter, angepasster Konfiguration erfolgt auf Ihr eigenes Risiko und bedarf der Probeetappe seitens des Erweiterungsnutzers.

Die Kunden nutzen die Erweiterung auf Ihr eigenes Risiko. Die Gesellschaft GPE garantiert nicht ihre volle Funktionsfähigkeit und haftet nicht für jedwede mit der Erweiterungsnutzung zusammenhängenden Nachteile. Die Gesellschaft GPE garantiert ferner nicht die volle Funktionsfähigkeit bei den angepassten Systemen der Verkaufsstellen oder bei installierten Erweiterungen von anderen Dienstleistern der Erweiterungen im Rahmen desselben Systems der Verkaufsstelle.

Die Kunden haften für Durchführung von Prüfungen der Erweiterungsfunktionsfähigkeit vor der Aufnahme des Produktionsbetriebs.

Durch Installierung der Erweiterung im System der Verkaufsstelle drückt der Kunde seine Zustimmung diesen Nutzungsbedingungen aus. Verwenden Sie bitte die Erweiterung nicht, falls Sie mit diesen Nutzungsbedingungen nicht einverstanden sind!

Die Deinstallation der Erweiterung kann Datenverlust zu Folge haben.

Rechtshinweis
Es kann Garantie jedweder Art weder bei jedweden Anpassungen und/oder neuen Realisationen noch bei resultierender abweichender Nutzung geleistet werden, die nicht unterstützt oder in dieser Dokumentation nicht beschrieben ist.

Installationsvoraussetzungen

  • Eshop basiert auf PrestaShop version 1.6.x - 8.x
  • Die Vereinbarung mit dem Zahlungsgateway GP webpay
  • Zugriff auf eshop FTP und Zugriff auf die Eshop-Administration
  • Aktiviert nach folgender PHP-Erweiterung auf Ihrem Hosting (standardmäßig auf den meisten Hostings verfügbar):
    • php_openssl
    • php_soap
    • bcmath

Problemlösung und Support

Dieses Handbuch enthält nicht nur die Installationsbeschreibung, sondern auch die Lösung typischer Probleme mit dem Zahlungsgateway. Wenn Sie während der Installation ein Problem haben, lesen Sie zuerst dieses Handbuch sorgfältig durch. Wenn Sie das Problem auch nach dem Lesen des Handbuchs nicht lösen können, schreiben Sie die detaillierte Beschreibung eines Problems und die Beschreibung Ihrer Schritte zur Lösung des Problems. Wir können um ein Protokoll bitten. Normalerweise benötigen wir keine Zugangsdaten zu Ihrem E-Shop.

Sie können den Installations- und Einrichtungsservice für Module auch bei unserem externen Lieferanten bestellen:
Bestellen Sie den Modulinstallations- und Setup-Service

Wichtige Änderung beim Update

Beim Aktualisieren des Moduls von der Originalversion, die älter als PRV 101 ist, wurde der Speicherort der Protokolldatei UniModul in das Verzeichnis UniModul/logs

Installation

Einstellung des digitalen Schlüssels und des Zahlungsgateways

Das GP WebPay-Gateway bietet Test- und Produktionsmodi. Diese Modi sind völlig unabhängig und haben einen eigenen Schlüssel.

Für GP WebPay (Test- oder Produktionsmodus) müssen Sie den digitalen Schlüssel in der Testwebverwaltung unter https://test.portal.gpwebpay.com oder in der Produktionswebverwaltung unter https://portal.gpwebpay.com im Abschnitt Schlüsselverwaltung. Die generierte .key-Datei muss dem jeweiligen Konto auf derselben Site zugewiesen werden. Sie verwenden den generierten Schlüssel auch im installierten Modul-Setup (siehe unten).

Stellen Sie im GP WebPay-Portal in den eshop-Einstellungen sicher, dass die Option "HTTP-Methode für die Antwort" auf "GET" gesetzt ist.

Installation in der Administration des Eshops

Wählen Sie in der PrestaShop-Administration das Menü Optimierung -> Module -> Module Manager. Klicken Sie auf die Schaltfläche Modul hochladen und ziehen Sie die Datei GPWebPayGpeBinder.zip per Drag & Drop. Klicken Sie nach Abschluss der Installation auf Konfigurieren.
Wählen Sie in den älteren PrestaShop-Versionen das Menü Module -> Module und klicken Sie auf die Schaltfläche Neues Modul hinzufügen, und laden Sie die beiden Installationsdateien hoch und konfigurieren Sie letztere.

Vor der Konfiguration ist es notwendig, zusätzliche Dateien mit ftp zu kopieren.
Kopieren Sie die .key-Datei Ihres generierten privaten Schlüssels in das Verzeichnis UniModul/certs.

Füllen Sie in den Moduleinstellungen folgende Felder aus:
  • Aktivierungsschlüssel - Geben Sie den Aktivierungsschlüssel ein, der im Abschnitt Aktivierungsschlüssel erstellen unten erstellt wurde.
  • Testgateway - Ja - Testumgebung, Nein - Produktionsumgebung. Verwenden Der Testumgebung zuerst.
  • Händlernummer - Ihre Händlernummer bei GPE.
  • Händler private Schlüsseldatei - schreiben Sie in die private Schlüsseldatei schreiben Sie den Namen der .key Datei Ihrer privaten Schlüsseldatei in das Verzeichnis kopiert UniModul/certs
  • Händler Private Key Passwort - das kay Passwort eingegeben während der Generierung Ihres Schlüssels.
  • Geldüberweisung - bestimmen Sie, ob das Geld sofort von der Karte überwiesen werden soll oder es nur die Vorautorisierung ist, empfehlen wir, die sofortige Überweisung einzustellen.
  • Anbieter-ID - Ihr Anbieter-Code, angezeigt in der GPWebPay-Administration auf der E-Shop-Detailseite.
  • Cron password - enter any password, see section Cron script setting
  • Unterstützte Währungen - 3-Buchstaben-ISO-Währungscodes, die das Gateway unterstützt, werden durch das Leerzeichen getrennt, z. "CZK" nebo "CZK EUR" usw.
  • Zulässige Währungen für Banküberweisungen - 3-Buchstaben-ISO-Währungscodes, die das Gateway unterstützt, werden durch das Leerzeichen getrennt, z. "CZK" nebo "CZK EUR" usw.
  • Methodenwechsel auf dem Gateway nicht zulassen - Beispielsweise lässt es keine Änderung einer Zahlungsüberweisung zu, wenn die ausgewählte Zahlung per Karte erfolgt usw.
  • Erste Zahlungsnummer des Zahlungs-Gateways - Der Offset der Bestellnummer im Zahlungsgateway, den wir während der Installation auf 1000 setzen und dann nicht ändern möchten. Bei einer Neuinstallation in die leere Datenbank des Eshops muss der Wert dieser Nummer höher als die letzte vorhandene Bestellnummer des Zahlungsgateways festgelegt werden
  • Zulässige Zahlungsmethoden - Aktivieren Sie die Zahlungsmethoden des Gateways, das angezeigt werden soll. Das erste Kontrollkästchen zeigt die allgemeine Methode an und der Kunde wählt die konkrete Methode an der Seite des Gateways. Es wird empfohlen, nicht zum allgemeinen Gateway zu gehen und die konkreten Methoden anzukreuzen. Die Verwendung der Methoden hängt von ihrer Autorisierung durch das Gateway ab. Siehe den Abschnitt Individuelle Zahlungsuntermethoden als unabhängige Zahlungsmodule.
  • Bestellstatus nach erfolgreicher Zahlung
  • Bestellstatus beim Warten auf die Zahlung
  • Bestellstatus nach fehlgeschlagener Zahlung
  • Bestellung vor Zahlungseingang anlegen - Die Bestellnummer ist vor der Zahlung bekannt und wird zur einfacheren Kopplung an das Zahlungsgateway übertragen. Dann wird auch jeder erfolglose Zahlungsversuch als Bestellung mit einer nicht erfolgreichen Zahlung registriert. (Dies ist eine experimentelle Funktion, die das Verhalten des Bestellvorgangs nicht ändert.) PrestaShop erstellt die Bestellung normalerweise nur bei erfolgreicher oder wartender Zahlung, sodass die Bestellnummer nicht an das Gateway übertragen werden kann.
  • Bestätigungsseite anzeigen - Legt fest, ob nach dem Klicken auf die Schaltfläche der Zahlungsmethode die Seite mit der Zusammenfassung und der Auftragsbestätigung im Bestellvorgang angezeigt wird, bevor die Überweisung selbst an das Zahlungsgateway erfolgt. Diese Seite kann einige zusätzliche Informationen anzeigen, z. Währungsumrechnung. Die Auswahl "Nur während der Info" zeigt die Bestätigungsseite nur bei zusätzlichem Informationsgehalt an.
Speichern Sie die Einstellung mit der Schaltfläche Einstellungen aktualisieren.

Klicken Sie dann erneut auf Zahlung und wählen Sie in der Tabelle Währungsbeschränkungen alle Währungen aus, für die Sie die Zahlung mit diesem Modul aktivieren möchten. Speichern Sie die Einstellung mit der Schaltfläche Einschränkung speichern.

Überprüfen Sie nun die Modulfunktionalität, indem Sie als Kunde eine Zahlung ausführen. Im Testmodus von GPWebPay muss die Testkarte verwendet werden, die mit der Dokumentation vom Gateway erhalten wurde.

Aktivierungsschlüssel erstellen

Cron-Skript-Einstellung

Um den Status offener Transaktionen auf dem Zahlungsgateway zu überprüfen, ist es notwendig, das Cron-Skript auf Ihrem Hosting so einzustellen, dass in regelmäßigen Abständen mindestens einmal täglich die folgende URL aufgerufen wird: 
http[s]://www.example.com/module/GPWebPayGpeBinder/Callback?_callbackName=checkOrderStatuses&cronSecret=CronPassword
Geben Sie anstelle von http[s]://www.example.com das Protokoll (http nebo https) und die Domain Ihres E-Shops ein und geben Sie anstelle von 'CronPassword' das Cron-Passwort ein, das Sie in der Modulkonfiguration festgelegt haben . Dieses Skript dient nur in Ausnahmefällen, wenn der Kunde nicht vom Gateway zum E-Shop zurückkehrt und der E-Shop daher das Zahlungsergebnis nicht erhält. Z.B. bei Netzwerkproblemen.

In den Produktionsmodus wechseln

Nach erfolgreichem Testen der Zahlung im Testmodus können Sie in den Produktionsmodus wechseln, in dem Sie mit echten Kreditkarten bezahlen können.

Schreiben Sie eine Anfrage an gpwebpay@gpe.cz und bitten Sie sie, den Produktionsmodus zu aktivieren, der anfänglich blockiert ist. Generieren Sie den Schlüssel auf die gleiche Weise wie im Test oder fügen Sie den Schlüssel aus dem Test in die Produktion ein. Wenn der Produktionsmodus gestartet wird, müssen Sie die Einstellungen des Moduls in der Eshop-Administration anpassen. Sie müssen gemäß den Anweisungen hier oben zum Produktions-Gateway wechseln.

Besondere Zahlungsmethoden

Das oben beschriebene Zahlungsmodul ermöglicht die Zahlung mit allen vom System bereitgestellten Methoden GPWebPay. Der Kunde wählt die Zahlungsmethode, wenn er GPWebPay bezahlt. Er wird zum Zahlungsgateway weitergeleitet, wo er eine aus vielen angebotenen Methoden auswählt, z. Bezahlen mit Kreditkarte oder Überweisung und so weiter.

Es ist auch möglich, diese speziellen Zahlungsmethoden als separate Zahlungsoptionen zu aktivieren.

Das Angebot der jeweiligen Methoden besteht darin, die Konfiguration des Moduls über Kontrollkästchen festzulegen.

Problemlösung

Finden Sie die Ursache für eine nicht erfolgreiche Zahlung in der Protokolldatei heraus

Technische Informationen zur Kommunikation mit dem Zahlungsgateway werden in der Datei UniModul/logs/UniModul.log protokolliert. Bei Problemen mit der Zahlung finden Sie die Fehlerursache in diesem Protokoll.

Einstellungen für Dateiberechtigungen

Das Modul erfordert Berechtigungen zum Lesen und Schreiben in die verschiedenen Dateien. Wenn die Standardeinstellung der Dateiberechtigungen es nicht erlaubt, in diese Dateien zu schreiben und sie im Falle eines Protokolls nicht einmal zu erstellen, muss die Protokolldatei UniModul/logs/UniModul.log manuell erstellt werden um und legen Sie die Berechtigungen zum Schreiben vom Webserver fest. Wenn Sie Total Commander verwenden, schreiben Sie mit dieser Aktion in die Befehlszeile: chmod 666 UniModul.log Machen Sie Ihre Datei maximal zugänglich. Die Dateien sollten jedoch für die anderen Websites des jeweiligen Webhostings nicht sichtbar sein. Aus diesem Grund müssen Sie Informationen über die Berechtigungseinstellungen Ihres Webhostings haben, bevor Sie den Produktionsvorgang starten.
Es ist auch erforderlich, die Schreibberechtigungen für die Datei UniModul/sync.lock festzulegen.

Technische Probleme bei der Zahlung

Aufgrund eines Problems mit dem privaten Schlüssel von GPWebPay kann es zu technischen Problemen bei der Zahlung kommen, wenn der Zahlungsversuch ohne Weiterleitung an das Gateway sofort fehlschlägt. Dies wird mit einer Meldung im UniModul.log aufgezeichnet
  • GPWebPay erstellt Zahlungsausnahme. Datei mit privatem Schlüssel kann nicht geöffnet werden .... für den Fall, dass das Modul den erforderlichen privaten Schlüssel nicht finden kann. Im E-Shop wird dies durch die Warnung „Technischer Fehler [Private Schlüsseldatei kann nicht geöffnet werden]“ angezeigt. (Die Anzeige dieser Nachricht im E-Shop kann durch die verwendete Vorlage blockiert sein, Sie finden sie aber immer im log.)
  • GPWebPay erstellt Zahlungsausnahme. Falsches Passwort oder privater Schlüssel in der Datei .... für den Fall, dass das Modul den erforderlichen privaten Schlüssel nicht finden kann. Im E-Shop wird dies durch die Warnung „Technischer Fehler [Ungültiges Passwort für den privaten Schlüssel]“ angezeigt.

Das GPWebPay-Gateway kann die Zahlung sowohl aus normalen geschäftlichen Gründen, z. B. weil die Karte des Kunden nicht überprüft wurde, als auch aus technischen Gründen aufgrund eines Problems in der Konfiguration des Gateways oder Moduls verweigern. Der Fehler wird entweder direkt auf der Website des GPWebPay-Gateways angezeigt oder in der Protokolldatei UniModul.log aufgezeichnet, wo Sie ihn in einer Zeile vom Typ REPLY payment: FAILED, Signature: VALID ...&PRCODE=..&SRCODE= ..&RESULTTEXT=....
Der Code für die Fehler des Zahlungsgateways wird als PRCODE, SRCODE und Textinterpretation RESULTTEXT angegeben. Typische technische Fehler, die mit den Moduleinstellungen verbunden sind, sind:
  • PRCODE=31 - Falsche Unterschrift. Sie haben nicht den richtigen öffentlichen Schlüssel .cer für Ihren privaten Schlüssel .pem registriert. Wenden Sie sich an den GPWebPay-Support.
  • PRCODE=2, SRCODE=34 - Der private Händlerschlüssel ist falsch eingestellt oder es gibt ein falsches Passwort in der Modulverwaltung.
  • PRCODE=3, SRCODE=7 - Nicht unterstützte Währung. Wenden Sie sich an Ihre Bank oder den GPWebPay-Support.
  • PRCODE=14 - Die Bestellnummer ist doppelt vorhanden. Lösung: In der Einstellung des Moduls müssen Sie die Nummer erster Ordnung höher einstellen als die letzte Nummer des oder GPWebPay, die sich in der Administrations-GUI befindet.
Überprüfen Sie bei anderen Fehlercodes zunächst das GPWebPay-Verwaltungsportal. Überprüfen Sie dort den Status der Zahlungen. Wenn diese dort als unbezahlt registriert sind, liegt das Problem nicht im Modul. Bei Fragen zur Zahlungsablehnung wenden Sie sich bitte an GPWebPay.

Detaillierte Fehleraufzeichnung in der Protokolldatei

Wenn das Modul nicht ordnungsgemäß funktioniert und Standardprotokollereignisse in UniModul / logs / UniModul.log nicht dazu beitragen, die Ursache zu finden, können Sie das Protokoll der Fehler in der oben genannten Protokolldatei erweitern aktivieren. Dort können Sie die Ursache des Problems finden oder uns dieses Protokoll zur weiteren Analyse des Problems senden.

Die Fehleraufzeichnung in der Protokolldatei kann durch Hinzufügen der Zeile aktiviert werden
$GLOBALS['UniErrorControl'] = 1;
in der Datei UniModul/UniModulConfig.php. Diese Datei wird nicht standardmäßig erstellt und muss aus der Datei UniModulConfig.php.example kopiert werden. Anschließend können Sie sie anpassen. Für den regulären Gebrauch empfehlen wir, die Fehleraufzeichnung (Protokoll) auszuschalten. Der Kommunikationsdatensatz (Protokoll) mit dem zahlenden Gateway ist immer eingeschaltet und kann nicht ausgeschaltet werden.

Das Modul wird bei der Auswahl der Zahlungen nicht angezeigt

Das Modul wird in der Administration festgelegt, aber während der Bestellung wird das Modul nicht angezeigt.

Mögliche Ursachen:
  • Ungültiger Aktivierungsschlüssel.
    Informationen zu diesem Problem werden in UniModul.log aufgezeichnet.
    Stellen Sie sicher, dass Ihre verwendete Domain zum Generieren des Aktivierungsschlüssels ist derselbe wie in UniModul.log. Wenn diese Lizenz korrekt ist, dann schalten Sie die detaillierte Fehleraufzeichnung (log) in UniModul.log ein, es ist oben beschrieben.
  • Die Nutzung von Dritterweiterungen, die die Zahlungsmöglichkeiten in Abhängigkeit vom gewählten Transportmittel einschränkt, z.B. ship2pay.
    Um dies zu erkennen, empfehlen wir Ihnen, ein anderes Standard-Zahlungsmodul auszuprobieren und zu überprüfen, ob es angezeigt wird.
  • Das Modul wird nicht angezeigt, da die in der Verwaltung des Moduls festgelegte Währung und die Währung des Warenkorbs nicht übereinstimmen oder der Betrag außerhalb der zulässigen Grenzen für die Zahlungsmethode liegt.
  • Anderer Fehler in der Modulverarbeitung.
    Aktivieren Sie das detaillierte Fehlerprotokoll im UniModul.log. Es ist oben beschrieben.
  • Nicht-PrestaShop-Originalmodule deaktiviert. Deaktivieren Sie in der PrestaShop-Administration im Abschnitt Erweiterte Parameter - Leistung - Debug-Modus beide Optionen Nicht-PrestaShop-Module deaktivieren und Alle Überschreibungen deaktivieren

Die Verwaltung des Moduls in PrestaShop 1.6.0.12-13 funktioniert nicht

PrestaShop versions 1.6.0.12-13 version refuses all titles with capital letters. This error is solved in the version 1.6.0.14. Update to the newer PrestaShop version.

Der Betrag wird im Zahlungsgateway nicht abgerundet

In einigen E-Shops wird die Währungsrundung so eingestellt, dass der Rundungsbetrag nur angezeigt wird. Im internen E-Shop wird jedoch ein nicht gerundeter Betrag aufgezeichnet. Das Zahlungsmodul arbeitet mit einem im E-Shop gespeicherten Betrag und im Gateway zahlt der Kunde den ungerundeten Betrag.

Sie können die Rundung des Betrags erzwingen, der an das Gateway gesendet wird, indem Sie die Datei UniModul/UniModulConfig.php einrichten, in die Sie Folgendes einfügen: 
	<?php
	$GLOBALS['UniPrestaShop_RoundPrice'] = true;
Beachten Sie, dass die in PrestaShop gespeicherte Menge noch nicht gerundet ist.

Verwenden der Bestellnummer anstelle der Referenz

Wenn in der Verwaltung des Moduls die Option "Bestellung vor Zahlung erstellen" ausgewählt ist, sendet das Modul die Bestellreferenz an das Zahlungsgateway. Leider kann die Referenz Briefe enthalten, die nicht an das Zahlungsgateway weitergeleitet werden können. Wir empfehlen, ein Modul eines Drittanbieters zu verwenden, um das Bestellreferenzformat anzupassen, vgl. PrestaShop Custom Number Pro – Order and Invoice Number.

In unserem Modul können Sie jedoch die ID der numerischen Reihenfolge anstelle der Referenz verwenden. Sie kann konfiguriert werden, indem Sie die Datei /UniModul/UniModulConfig.php erstellen, indem Sie Folgendes einfügen: 
	<?php
	$GLOBALS['UniPrestaShop_UseOrderId'] = true;

Die Datenbanktabelle unimodul_transactions fehlt

Der folgende Fehler wird im Protokoll angezeigt, wenn die Fehlerprotokollierung aktiviert ist: Query Failed! SQL: insert into unimodul_transactions, Error: Table '.unimodul_transactions' doesn't exist
In diesem Fall konnte das Modul diese Tabelle während der Installation nicht automatisch erstellen und muss manuell erstellt werden:

Melden Sie sich bei der Eshop-Datenbankverwaltung auf Ihrem Webhosting an und erstellen Sie Datenbanktabellen, indem Sie das Skript modules/GPWebPayGpeBinder/lib/UniModul/UniModul.sql ausführen. (Es reicht aus, den Inhalt der Datei in das Feld der SQL-Einstellungsreihenfolge in PHPMyAdminu zu kopieren.)

Oft gestellte Frage

Module Update

Installieren Sie das Modul-Update in der Eshop-Administration. Überprüfen Sie in der Administration die Moduleinstellungen und fügen Sie alle neuen Elemente hinzu.

Speichern Sie die Einstellungen, auch wenn Sie nichts geändert haben.