Installations-und Konfigurationsanleitung Für Shopware ab Version 5.6.
COMPUTOP PAYGATE GMBH - Schwarzenbergstrasse 4 - 96050 Bamberg
Das Computop Payment Plugin für Shopware ermöglicht die Anbindung von Shopware an die Computop Plattform.
Das Plugin unterstützt die Abwicklung nachfolgender Zahlungsarten:
Kredit- und Debitkarten inkl. 3D Secure
Online-Überweisung
Lastschrift (SEPA)
Wallet
Rechnungskauf
Ratenkauf
Im Bereich Betrugsprävention
Für die Verwendung des Shopware Computop Payment Plugins sind folgende Systemvorrausetzungen notwendig:
Öffnen Sie den Plugin Manager unter Einstellungen > Plugin Manager im Backend Ihres Shopware Shops.
Suchen Sie das Computop Payment Plugin im Plugin Manager und installieren Sie das Plugin über den Installieren Button.
Nach der Installation aus dem Plugin Manager, wird das Computop Payment Plugin unter Einstellungen > Plugin Manager > Verwaltung > Deinstalliert aufgelistet.
Die Computop Payment Plugin Installation kann über das grüne + Icon (Installieren / Deinstallieren) fortgeführt werden.
Bestätigen Sie die Neu-Initialisierung des Shopware Backend Cache über den Ja Button.
Aktivieren Sie das Computop Payment Plugin über den Aktivieren Button.
Bestätigen Sie die Neu-Initialisierung der Caches (Backend und Frontend) über den Ja Button.
Bestätigen Sie die Theme Kompilierung über den Theme kompilieren Button.
Laden Sie jetzt das Shopware Backend mit der Tastenkombination Strg.-F5 im Browser neu.
Nach der Installation wird das Computop Payment Plugin unter Einstellungen > Plugin Manager > Verwaltung > Installiert aufgelistet und kann im nächsten Schritt konfiguriert werden.
Die Computop Payment Plugin Grundeinstellungen können Sie unter Einstellungen > Pluginmanager > Installiert > Computop Payment > Öffnen vornehmen.
Sichern Sie Ihre Konfiguration über den Speichern Button.
Die jeweilige Zahlart muss unter Einstellungen > Zahlungsarten aktiviert werden, weiteren Konfigurationseinstellungen gibt es an dieser Stelle jedoch nicht.
Die Daten für MerchantID, MAC und Blowfish Passwort bekommen Sie vom Computop Sales-Team nach Vertragsabschluss.
Konfiguration | Beschreibung |
---|---|
MerchantID | Ihre Computop Merchant ID |
MAC | Ihr HMAC-Key |
Blowfish Passwort | Ihr Blowfish Passwort |
Bestellnummer Präfix | Wird zu Anfang der in Shopware erzeugten Bestellnummer eingefügt. |
Bestellnummer Suffix | Wird an die in Shopware erzeugte Bestellnummer angehangen. |
Debug Protokoll | keine Protokollierung: Es werden keinen Debugausgaben protokoliert Protokollierung: Es wird eine Log-Datei mit Debug Ausgaben im Shopware Log Verzeichnis erstellt. erweiterte Protokollierung: Dieses Log protokolliert sehr viele Daten und kann Last erzeugen. Diese Option sollte nur nach Rücksprache mit Computop oder Fatchip aktiviert werden! |
Konfiguration | Beschreibung |
---|---|
Kreditkarte – Modus | Hier legen Sie fest in welchen Schritten der Kunde seine Kreditkarten Informationen eingibt. Frame: Kreditkartendaten werden nach Klick auf Zahlungspflichtig bestellen in ein iFrame eingegeben. Silent Mode: Kreditkartendaten werden auf der Seite Prüfen und Bestellen eingegeben. Hinweis: Für die Kreditkartenanbindung ist es notwendig eine PCI-Selbstauskunft für Ihren Kreditkarten Acquirer auszufüllen. Weitere Informationen erhalten Sie von Ihrem Computop Ansprechpartner. Bitte klären Sie vorab mit ihm, ob Sie die iFrame- oder die Silent Mode Variante nutzen wollen. |
Kreditkarte – Test-Modus | Das Plugin erlaubt den Betrieb der Kreditkartenzahlung in einem sogenannten „Test-Modus“, in welchem alle ausgeführten Test-Transaktionen nicht zu realen Buchungen führen. Die De/Aktivierung des Testmodus erfolgt über diesen Menüpunkt. |
Kreditkarte – Visa (Silent Mode) | Hier legen Sie fest, ob Visa im Silent Mode zur Verfügung steht. |
Kreditkarte – Mastercard(Silent Mode) | Hier legen Sie fest, ob Mastercard im Silent Mode zur Verfügung steht. |
Kreditkarte – American Express (Silent Mode) | Hier legen Sie fest, ob American Express im Silent Mode zur Verfügung steht. |
Kreditkarte – Capture Modus | Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTOMATISCH: Reservierte Beträge werden sofort automatisch eingezogen. MANUELL: Geldeinzüge werden von Ihnen manuell oder durch ein anderes System im Shopware Backend durchgeführt. |
Kreditkarte – Acquirer | Legen Sie in Absprache mit Ihrem Computop Ansprechpartner fest, welchen Acquirer Sie verwenden. Diese Einstellung muss mit der Angabe auf Seiten von Computop übereinstimmen. |
Kreditkarte – Kontoverifizierung anfordern | Bei einer angeforderten Kontoverifizierung ist der übermittelte Betrag optional und wird für die tatsächliche Zahlungstransaktion ignoriert (z.B. Autorisierung). |
Kreditkarte – Template | Name der XSLT-Datei mit Ihrem individuellen Layout für das Bezahlformular. Wenn Sie kein individuelles Formular nutzen, verwenden Sie hier bitte den Templatenamen ct_responsive. Hinweis: Das Template ct_responsive_ch soll nicht mehr verwendet werden, da es vollumfänglich durch das Template ct_responsive abgelöst wurde. |
Konfiguration | Beschreibung |
---|---|
iDEAL – Dienst | iDEAL kann direkt oder über PPRO angebunden werden. Legen Sie in Absprache mit Ihrem Computop Ansprechpartner fest, welchen Dienst Sie verwenden. |
Nach der Installation und Aktivierung des Plugins muss in den Plugineinstellungen einmal auf den Button iDEAL Banken aktualisieren geklickt werden.
Nach Erfolg erscheint die Meldung: iDEAL Banken Aktualisieren. Success: True. Count: 10
Konfiguration | Beschreibung |
---|---|
Klarna – Aktionscode | Der Wert des Aktionscodes ist von den Laufzeiten und Monatsraten abhängig, die Sie mit Klarna vereinbart haben. Sie finden diesen Wert in Ihrem Klarna Konto. Dieser Wert kann per Land/Subshop unterschiedlich sein. |
Klarna – Konto | Sie können mehrere Konten bei Klarna haben und hier können Sie das zu benutzende Konto eintragen. Das Konto muss vorher bei Klarna erstellt werden. Wenn *Klarna PayNow* aktiviert ist, dann können *Klarna Lastschrift* und *Klarna Sofort* nicht aktiviert werden.\ Wenn *Klarna Lastschrift* und/oder *Klarna Sofort* aktiv ist, dann kann *Klarna PayNow* nicht aktiviert werden |
Konfiguration | Beschreibung |
---|---|
Lastschrift – Dienst | Lastschrift Zahlungen können direkt, über EVO oder über INTERCARD abgewickelt werden. Legen Sie in Absprache mit Ihrem Computop Ansprechpartner fest, welchen Dienst Sie verwenden. Diese Einstellung muss mit der Angabe auf Seiten von Computop übereinstimmen. |
Lastschrift – Capture Modus | Hier legen Sie fest, zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTO: Reservierte Beträge werden sofort automatisch eingezogen. MANUELL: Geldeinzüge werden von Ihnen manuell oder durch ein anderes System im Shopware Backend durchgeführt. |
Iban anonymisieren | Stellt im Checkout und im Mein Konto Bereich die Iban anonymisiert dar. |
Konfiguration | Beschreibung |
---|---|
Paypal – Capture Modus | Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTO: Reservierte Beträge werden sofort automatisch eingezogen. MANUELL: Geldeinzüge werden von Ihnen manuell oder durch ein anderes System im Shopware Backend durchgeführt. Wichtig: Bitte kontaktieren Sie den Computop Support für Manuell, um die unterschiedlichen Einsatzmöglichkeiten abzuklären. |
Paypal – Bestellstatus bei Capture | Wenn diese Option An ist, dann wird der Bestellstatus bei Paypal Bestellungen, bei denen der Capture fehlschlägt, auf Klärung notwendig gesetzt |
Konfiguration | Beschreibung |
---|---|
AmazonPay – SellerId | Ihre AmazonPay SellerId |
AmazonPay – ClientId | Ihre AmazonPay ClientId |
AmazonPay – Modus | Legt fest, ob AmazonPay den Live- oder Testmodus nutzt |
AmazonPay – Capture Modus | Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTO: Reservierte Beträge werden sofort automatisch eingezogen. MANUELL: Geldeinzüge werden von Ihnen manuell oder durch ein anderes System im Shopware Backend durchgeführt. |
AmazonPay – Button Typ | Typ des Amazon Buttons. Mögliche Werte: AmazonPay (Default), Pay, A, LwA, Login Ein Beispiel für die verschiedenen Button Typen finden Sie in der Amazon Pay Dokumentation unter Amazon Dokumentation. |
AmazonPay – Button Farbe | Farbe des Amazon Buttons. Mögliche Werte: Gold, LightGrey, DarkGrey Ein Beispiel für die verschiedenen Button Farben finden Sie in der Amazon Pay Dokumentation unter Amazon Dokumentation. |
AmazonPay – Button Größe | Größe des Amazon Buttons. Mögliche Werte: Small, Medium Ein Beispiel für die verschiedenen Button Größen finden Sie in der Amazon Pay Dokumentation unter Amazon Dokumentation. |
Computop Paycontrol, eine automatisierte Bonitäts-Prüfung mit allen gängigen Auskunfteien, kombiniert Flexibilität und Zahlungssicherheit für den Online-Handel. Mit Paycontrol können Sie zum Beispiel automatisch Auskünfte von CRIF einholen.
Konfiguration | Beschreibung |
---|---|
CRIF Bonitätsprüfung | Hier können Sie die CRIF-Bonitätsprüfung aktivieren und festlegen welche Art von Prüfung verwendet werden soll. Mögliche Werte: QuickCheck, CreditCheck |
Bonitätsprüfung - Zurückgelieferte Adressdaten verwenden | Wählen Sie hier Ja um die Rechnungsadresse mit der u.U. korrigierten Adressen aus der Bonitätsprüfung zu ersetzen. |
Bonitätsprüfung - Gültigkeit der Bonitätsprüfung in Tagen | Stellen Sie hier ein, wie lange eine bereits durchgeführte Bonitätsprüfung gültig bleiben soll (in Tagen). Da eine Bonitätsprüfung kostenpflichtig ist, wird das Ergebnis für eine Adresse gespeichert. Erst nach der hier eingestellten Anzahl von Tagen, wird die Adresse erneut geprüft. |
Über das Shopware Backend können Bestellungen verwaltet werden und für Computop Zahlarten Geldeinzüge (capture) und Gutschriften (credit) ausgeführt werden. Wichtig: Wenn Sie Geldeinzüge oder Gutschriften aus dem Computop Analytics Backend ausführen, werden von Computop KEINE Benachrichtigungen (Notifications) an das Shopsystem gesendet. Der Zahlungsstatus im Shop wird in diesem Fall NICHT automatisch aktualisiert.
Die Bestellungen können Sie im Shopware Backend unter Kunden > Bestellungen einsehen.
Bei allen Computop Bestellungen wird die Computop Zahlungsart angezeigt und kann über den Zeige Details Button bearbeitet werden.
Für Bestellungen die über Computop bezahlt wurden, wird der Reiter Positionen unter Bestellungsdetails erweitert. Es kommen zwei neue Spalten Eingezogen und Gutgeschrieben hinzu. Außerdem gibt es die Buttons Positionen einziehen und Positionen gutschreiben.
In den Spalten Eingezogen und Gutgeschrieben sehen Sie welcher Betrag für diese Position eingezogen bzw. gutgeschrieben wurde.
Ob die Versandkosten eingezogen bzw. gutgeschrieben wurden finden Sie in dem Reiter Übersicht unter Freitextfelder.
Nach einer erfolgreichen Bestellung mit einer Computop Zahlungsart bekommt diese Bestellung grundsätzlich zuerst den Zahlungsstatus reserviert. Nach einem erfolgreichen Geldeinzug (capture) sendet Computop eine Notification an dem Shop. Dieser Vorgang kann einige Minuten in Anspruch nehmen. Wenn die Notification im Shop angekommen ist, wird der Zahlungsstatus auf Komplett Bezahlt gesetzt. Sollten Sie für eine Zahlart den Capture Modus auf Manuell gestellt haben, wird das Geld NIE automatisch eingezogen. Die Bestellung behält den Status reserviert, bis Sie den Geldeinzug manuell ausführen.
Sie können den Geldeinzug (capture) manuell anstoßen unter Bestellungs-Details > Positionen.
Wählen Sie die Positionen die Sie einziehen möchten und klicken anschließend auf Positionen einziehen. Es erscheint eine Popup-Meldung wo zusammengefasst wird, wieviel Sie einziehen möchten und ob auch die Versandkosten mit eingezogen werden sollen (Standard: Ja).
Nach Klick auf (Teil-)Geldeinzug kommt bei Erfolg die folgende Meldung Der Geldeinzug wurde erfolgreich durchgeführt oder bei Fehler eine Fehlermeldung. Bei Erfolg wird der Zahlungsstatus automatisch auf Komplett bezahlt oder Teilweise bezahlt angepasst, abhängig davon ob Sie die Bestellung komplett oder nur teilweise eingezogen haben.
Sie können Gutschriften (credit) unter Bestellungs-Details > Positionen anstoßen.
Wählen Sie die Positionen die Sie gutschreiben möchten und klicken Sie anschließend auf Positionen gutschreiben. Es kommt eine Popup-Meldung, in der noch einmal zusammengefasst wird wie viel Sie gutschreiben möchten und ob auch die Versandkosten gutgeschrieben werden sollen (Standard: Nein).
Nach Klick auf Ja kommt bei Erfolg die folgende Meldung Die Gutschrift wurde erfolgreich durchgeführt oder bei Fehler eine Fehlermeldung. Bei Erfolg wird der Zahlungsstatus automatisch auf Wiedergutschrift angepasst.
Für Kreditkartenzahlungen werden die Pseudo Kartennummer, das Ablaufdatum und der Kartenanbieter im System gespeichert. Sollten Sie diese Daten z.B. in Ihrer Warenwirtschaft benötigen, können Sie diese Daten exportieren.
Das Shopware Import/Export Plugin bietet Ihnen die Möglichkeit Bestelldaten zu exportieren. Im folgenden Abschnitt wird beschrieben wie Sie diese Felder an den Bestellexport hinzufügen können. Voraussetzung ist, dass das Shopware Import/Export Plugin installiert und aktiviert ist.
Hinweis: Diese Beschreibung gilt für Shopware Version 5.5. In höheren Shopware Versionen können die Schritte geringfügig abweichen.
Öffnen Sie den Import/Export über Inhalte > Import/Export.
Es muss ein neues Profil angelegt werden. Sie können entweder ein komplett neues Profil erzeugen, oder ein existierendes Profil erweitern. Als Beispiel wird eine Kopie von dem Standardprofil default_orders (Bestellungen) erstellt und erweitert.
Dazu öffnen Sie den Reiter Profile, suchen das Profil default_orders und klicken rechts auf die Aktion Kopieren.
Das kopierte Profil default_orders (Kopie) können Sie über das Bearbeiten Icon anpassen.
Um die extra Felder in dem Profil hinzuzufügen, wählen Sie unter Orders das Element Order aus und klicken dann auf Neues Feld.
Jetzt geben Sie einen Feldnamen ein (z.B. Pseudokartennummer), wählen ein Attribut aus (z.B. attributeFatchipctKreditkartepseudonummer) und klicken auf Speichern.
Wiederholen Sie diesen Vorgang für alle weiteren Felder die Sie exportieren möchten.
Um den Export auszuführen, wählen Sie den Reiter Import/Export Manager > Export aus. Wählen Sie ein Export-Format (csv oder xml) und das erstellte Profil aus und klicken auf Export starten.
Über das Riskmanagement unter Einstellungen > Riskmanagement können Sie Regeln festlegen um bestimmte Zahlarten auszublenden. Weitere Informationen finden Sie in der Shopware Dokumentation.
Bei der Installation des Computop Payment Plugins werden für einige Zahlarten automatisch Riskregeln angelegt. Einige Zahlungsarten werden nur angeboten, wenn bestimmte Bedingungen erfüllt sind:
Wenn Sie die CRIF-Bonitätsprüfung aktivieren, können Sie eigene Riskregeln anlegen um bestimmte Zahlarten, abhängig vom Ergebnis für einen Kunden, zu deaktivieren. Der CRIF-Dienst gibt als Ergebnis eine Ampel-Empfehlung zurück (Rot, Gelb, Grün). Das Modul stellt zwei neue Risikobedingungen bereit: Computop Risikoampel IST und Computop Risikoampel IST NICHT. Wenn Sie zum Beispiel eine Regel anlegen wollen um Lastschrift zu sperren wenn die CRIF-Prüfung Rot zurück gibt gehen sie folgendermaßen vor.
Um die Kommunikation zwischen Shopware und Computop nachvollziehen zu können, werden alle API-Aufrufe protokolliert.
Das API Protokoll können Sie aufrufen unter Einstellungen > Computop > API Protokoll.
Weil immer einige API Aufrufe stattfinden bevor eine Bestellnummer vorliegt, ist es nicht möglich im API Protokoll nach Shopware Bestellnummer zu suchen. Sie können jedoch nach TransID, PayID und XID suchen.
Wenn Sie alle API Aufrufe für eine Bestellung einsehen möchten, können Sie die TransID für die Bestellung aus der Liste der Bestellungen unter Kunden > Bestellungen kopieren.
Diese TransaktionID können Sie in die API Protokoll Suche eingeben und finden anschließend alle API Aufrufe zu dieser Bestellung.
Klicken Sie auf eine Zeile in der Liste und alle Details zum Request und zur Response werden in einem Popupfenster angezeigt.