Fatchip GmbH Wiki

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

• Visa, MasterCard, American Express

Online-Überweisung

• iDeal (direkt oder via PPRO)
• Klarna SOFORT (direkt oder via PPRO)
• Computop SOFORT
• Giropay
• Postfinance (via PPRO)
• Przelewy24 (via PPRO)

Lastschrift (SEPA)

• SEPA-Lastschrift
• Klarna Lastschrift

Wallet

• Amazon Pay
• PayPal Standard
• PayPal Express

Rechnungskauf

• Klarna Rechnungskauf
• AfterPay Rechnung

Ratenkauf

• Klarna Ratenkauf
• easyCredit

Im Bereich Betrugsprävention

• CRIF
  

Für die Verwendung des Shopware Computop Payment Plugins sind folgende Systemvorrausetzungen notwendig:

• Installierter und lauffähiger Shopware Shop ab Version 5.6 bis 5.7
• Computop Händlerkonto und je nach verwendeten Zahlarten, Konten bei den Zahlungsanbietern wie Paypal, Amazonpay, Sofort etc.
• PHP Version ab 7.4 bis 8.1
• SSL verwenden muss unter Einstellungen > Grundeinstellungen > Shopeinstellungen > Shops für jeden Shop aktiviert werden.
  

• Für automatische Zahlungsstatus-Updates muss der Shop extern erreichbar sein

Ö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.

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

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.

Ü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:

• Easycredit ist nur aktiv wenn der Warenkorb > 200 Euro ist
• iDEAL ist nur aktiv wenn das Rechnungsland = Niederlande
• Przelewy24 ist nur aktiv wenn das Rechnungsland = Polen und die Währung Zloty

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.

1. Öffnen Sie Riskmanagement unter Einstellungen > Riskmanagement
2. Wählen Sie die Zahlart Computop Lastschrift aus
3. Wählen Sie unter Sperre Zahlungsart WENN, Computop Risikoampel IST aus und im 2. Dropdown rot
4. Klicken Sie auf Speichern
   

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.