Installationsanleitung für das Shopware Heidelpay Corporate Design-Edition (CD-Edition) (Frontend Modul) Installationsanleitung

Transkript

1 Installationsanleitung für das Shopware Heidelpay Corporate Design-Edition (CD-Edition) (Frontend Modul) Installationsanleitung Date: Version: 3.2

2 Heidelpay Paym ent Platfo rm History of Change Version Date Author Comment Richter Creating Nemet PostFinance Nemet Fehlermeldungen bei der Bezahlung Nemet Heidelpay Backend User Nemet Testdaten angepasst Nemet Backend Modul Nemet Update Nemet Update Document history Copyright 2015 Heidelberger Payment GmbH All rights reserved. No part of this document may be reproduced in whole or in part, stored in a retrieval system or transmitted in any form or by any means, electronic, mechanical, photocopied, and recorded or otherwise, without the written permission of Heidelberger Payment GmbH.

3 Index of Content Installation des Heidelpay CD-Edition Plugin... 4 Konfiguration des Plugin... 4 Zugangsdaten für unser Testsystem... 6 Testdaten für unser Testsystem... 6 Livedaten eintragen... 7 Zahlungsarten für den Shop freischalten... 7 Wiedererkennung des Kunden... 9 MangirKart PostFinance BillSAFE Sofortüberweisung Abo Commerce Optische Anpassungen Fehlermeldungen bei der Bezahlung Integrierte Fehlermeldungen / Fehlercodes Heidelpay Backend Benutzer Transaktionen aus dem Shop Backend (Backend Modul) Zahlungsstatus für Backend Transaktionen anpassen Nice to know... 24

4 Installation des Heidelpay CD-Edition Plugin Das Heidelpay Corporate Design-Edition Plugin (kurz CD-Edition) können Sie wie von Shopware gewohnt aus dem Community Store einfach installieren. Loggen Sie sich hierfür in Ihr Backend ein, Klicken Sie auf Einstellungen -> Plugin Manager und wechseln Sie dann auf den Reiter Community Store. Geben Sie nun in die Suche den Begriff Heidelpay ein. Danach erhalten Sie als Ergebnis das Plugin Heidelpay Corporate Design-Edition. Klicken Sie hier auf Details und dann auf Plugin installieren. Das Plugin wird nun heruntergeladen und kann von Ihnen aktiviert werden. Wechseln Sie hierfür auf den Reiter Einkäufe/Erweiterungen und dort auf Alle Erweiterungen. Unter den Inaktiven Plugins finden Sie nun das Plugin Heidelpay CD- Edition. Klicken Sie nun auf das grüne Plus Zeichen. Das Plugin ist nun aktiv und die Details öffnen sich. Nun werden Sie automatisch zur Aktivierung des Plugin geleitet. Setzen Sie hier Aktiv auf Ja und speichern Sie die Einstellung. Konfiguration des Plugin Die Einstellungen des Plugins können Sie entweder im Plugin Manager unter den Details vornehmen oder wechseln Sie auf Einstellungen -> Grundeinstellungen. Abbildung 1: Konfiguration des Plugin

5 Öffnen Sie den Punkt Zahlungsarten und das Untermenü Heidelpay CD-Edition. Abbildung 2: Zugangsdaten für unser Testsystem Hinweis: - Wenn Sie mehrere Sprachen oder Subshops verwenden, vergessen Sie nicht auf den entsprechenden Reiter die Einstellungen vorzunehmen. - wenn Sie einen vorgelagerten Proxy verwenden, sorgen Sie bitte dafür das diese URLs nicht gecached werden: SHOPURL/PaymentHgw/gateway SHOPURL/account/payment SHOPURL/account/payment/sTarget/checkout

6 Zugangsdaten für unser Testsystem Sender-ID: Login: Password: Sandbox Mode: Kreditkarte mit 3D: Kreditkarte ohne 3D: Debit Karte mit 3D Debit Karte ohne 3D: Lastschrift: Vorkasse: Rechnung: PayPal: Kauf auf Rechnung mit BillSafe: Sofortüberweisung PostFinance 31HA07BC8142C5A171745D00AD63D182 31ha07bc8142c5a171744e5aef11ffd DE7 yes 31HA07BC8142C5A171749A60D979B6E4 31HA07BC8142C5A171744F3D6D HA07BC8142C5A171749A60D979B6E4 31HA07BC8142C5A171744F3D6D HA07BC8142C5A171749A60D979B6E4 31HA07BC8142C5A171749A60D979B6E4 31HA07BC8142C5A171749A60D979B6E4 31HA07BC8142C5A171749A60D979B6E4 31HA07BC8142EE6D02715F4CA97DDD8B 31HA07BC8142C5A171749CDAA43365D2 31HA07BC811E8AEF9AB2733D80C21DA8 Testdaten für unser Testsystem Kreditkarten: Mastercard: Ablaufdatum: 12/2024 CVV: 123 3D PWD: secret3 VISA: Ablaufdatum: 12/2024 CVV: 123 3D PWD: secret3 Sofortüberweisung: BLZ = " " Kontonummer = "123456" USER_PIN = "12345" USER_TAN = "123456" Lastschrift DE: Kto.-Nr. " " BLZ: " " IBAN: "DE " BIC: "COBADEFFXXX"

7 Livedaten eintragen Um das Zahlungssystem Live zu nehmen ändern Sie bitte die Daten entsprechend. Ersetzen Sie die hinterlegten Daten durch die von unserem Support zugesendeten Daten für das Live-System. Sollten Sie hierfür Hilfe benötigen, wenden Sie sich an: oder unter / Stellen Sie nun den Sandbox Mode auf no um und übernehmen Sie alle Einstellungen durch betätigen des Speicher-Buttons. Zahlungsarten für den Shop freischalten Wechseln Sie nach Einstellungen -> Zahlungsarten. Abbildung 3: Zahlungsarten Wählen Sie nun die gewünschte Bezahlart aus (z.b. Heidelpay CD-Edition Kreditkarte).

8 Abbildung 4: Zahlungsarten Menü Sie können die Bezeichnung und die zusätzliche Beschreibung nach Ihren wünschen anpassen. (z.b. Bezeichnung: Visa / Mastercard ) Klicken Sie nun noch unter Aktiv das Feld an um die Zahlart zu aktivieren und speichern Sie Ihre Einstellungen ab. Um den Vorgang abzuschließen müssen Sie nun noch unter Versandkosten die Zahlarten hinzufügen. Gehen Sie hierfür auf "Einstellungen"->"Versandkosten" und wählen Sie eine Versandart aus. Abbildung 5: Versandkosten

9 Klicken Sie nun auf "Versandart editieren". Abbildung 6: Versandkosten Menü Wechseln Sie nun auf den Reiter "Zahlungsarten Auswahl" und fügen Sie die Zahlungsarten zu den "Ausgewählten" hinzu. Abbildung 7: Zahlungsarten Auswahl Damit sind alle Einstellungen vorgenommen und Sie könnten das Plugin der Heidelberger Payment GmbH nutzen. Anmerkung: Sobald Sie Änderungen an den Einstellungen vornehmen, sollten Sie immer den Shopcache leeren. Wiedererkennung des Kunden Die Zahlarten Kredit Karte, Lastschrift, Debit Karte und PayPal bieten Ihnen die Möglichkeit einer Wiedererkennung des Kunden einzustellen. Dies beschleunigt den Bezahlprozess für Stammkunden. Stellen Sie hierfür bei der Zahlart den Booking Mode auf registration ein. Abbildung 8: Wiedererkennung des Kunden Hierdurch gibt der Kunde einmal seine Bezahldaten ein und kann diese danach ohne erneute Eingabe nutzen. Sobald der Kunde jedoch seine Lieferadresse ändert, muss er die Daten erneut eingeben.

10 Wenn Ihre Kunden trotz Änderung der Lieferanschrift die Bezahldaten weiterverwenden dürfen, können Sie dies einfach im Modul einstellen. Stellen Sie hierfür einfach diese Einstellung auf Yes und Speichern Sie diese Änderung. Abbildung 9: Wiedererkennung des Kunden MangirKart MangirKart ist ein türkisches Zahlverfahren und steht deshalb auch nur in der Währung Türkische Lire zur Verfügung. Um zu gewährleisten, dass Ihre Kunden diese Zahlart auch nur nutzen können, wenn Sie diese Währung ausgewählt haben, legen Sie hierfür ein Eintrag im Riskmanagement an. Klicken Sie hierfür auf Einstellungen -> Riskmanagement und wählen Sie die Zahlart Heidelpay MangirKart aus. Sollte diese hier nicht erscheinen, prüfen Sie bitte ob diese Zahlart aktiviert ist. Stellen Sie im Drop-Down Währungs-Iso-Kürzel IST NICHT ein und tragen Sie in das Feld dahinter TRY ein. Bestätigen Sie Ihre Einstellung durch klicken auf den Speicher Button. Abbildung 10: Riskmanagement MangirKart PostFinance PostFinance ist ein schweizer Zahlverfahren und steht deshalb auch nur in der Währung Schweizer Franken zur Verfügung. Um zu gewährleisten, dass Ihre Kunden diese Zahlart auch nur nutzen können, wenn Sie diese Währung ausgewählt haben, legen Sie hierfür ein Eintrag im Riskmanagement an. Klicken Sie hierfür auf Einstellungen -> Riskmanagement und wählen Sie die Zahlart Heidelpay PostFinance aus. Sollte diese hier nicht erscheinen, prüfen Sie bitte ob diese Zahlart aktiviert ist. Stellen Sie im Drop-Down Währungs-Iso-Kürzel IST NICHT ein und tragen Sie in das Feld dahinter CHF ein. Bestätigen Sie Ihre Einstellung durch klicken auf den Speicher Button. (Siehe Screenshot MangirKart)

11 Des Weiteren ist es wichtig, dass das Rechnungsland Schweiz ist. Hierfür erstellen Sie einen weiteren Eintrag im Riskmanagement. Im Drop-Down stellen Sie diesmal Land IST NICHT ein und schreiben in das Feld dahinter CH. Auch diese Änderung bestätigen Sie mit einem Klick auf den Speicher Button. BillSAFE Abbildung 11: Riskmanagement PostFinance Um die Zahlart BillSAFE nutzen zu können müssen Sie sicherstellen das die Rechnungsund die Lieferadresse übereinstimmen. Um dies zu gewährleisten, legen Sie hierfür ein Eintrag im Riskmanagement an. Klicken Sie hierfür auf Einstellungen -> Riskmanagement und wählen Sie die Zahlart Kauf auf Rechnung aus. Sollte diese hier nicht erscheinen, prüfen Sie bitte ob diese Zahlart aktiviert ist. Stellen Sie im Drop-Down Lieferadresse!= Rechnungsadresse ein und lassen Sie in das Feld dahinter leer. Bestätigen Sie Ihre Einstellung durch klicken auf den Speicher Button. Abbildung 12: Riskmanagement BillSAFE Weiterhin ist es notwendig, das sogenannte Push-Feature bei unserem Support aktivieren zu lassen. Wenn ein Kunde in Ihrem Shop bezahlt, sehen Sie wie gewohnt eine Bestellung in Ihrem Shop Backend. Klicken Sie hier bitte auf den Bearbeiten Button.

12 Bei den Reitern ist nun ein Reiter Heidelpay hinzugekommen: Klicken Sie auf diesen Reiter und Sie erhalten eine Transaktionsübersicht: Abbildung 13: Transaktionsübersicht Drücken Sie jetzt auf den Finalize Button, erhalten Sie die Möglichkeit den Versand an uns zu melden, sobald die Ware zum Versand fertig ist.

13 Abbildung 14: Meldung Der Versand wurde nun an uns gemeldet. Wechseln Sie auf den Reiter Dokumente um die Rechnung zu erstellen. Wählen Sie unter Dokument-Typ Rechnung aus, setzen Sie das Lieferdatum auf den aktuellen Tag und klicken Sie auf Dokument erstellen.

14 Abbildung 15: Dokument erstellen Nun wird die Rechnung erstellt und die BillSAFE Daten werden automatisch eingetragen. BillSAFE Rechnungsbeispiel: Abbildung 16: BillSAFE Rechnungsbeispiel

15 Sofortüberweisung Sollten Sie Sofortüberweisung in Kombination mit diesem Modul verwenden, wenden Sie sich bitte an unserem technischen Support, damit dieser Ihnen den Channel entsprechend konfigurieren kann ( Sofortüberweisung ohne Eingabe der Daten ). Sie erreichen unseren technischen Support unter: support@heidelpay.de oder unter / Abo Commerce Das neue Heidelpay Plugin unterstütz nun auch die Shopware eigene Abo Lösung (Abo Commerce). Unterstützt werden derzeit alle Heidelpay Zahlarten die Abo fähig sind: - Kredit Karte - Debit Karte - Lastschrift - PayPal (hierfür muss bei PayPal Recurring Transactions beantragt werden) Hierfür muss der Bookingmode der Zahlart auf registration gestellt werden: Abbildung 17: Einstellungen Abo I Zudem muss für Kreditkarte und Debit Karte ein Channel ohne 3D Secure hinterlegt werden: Abbildung 18: Einstellungen Abo II Wenn Sie auf Ihrem Hauptchannel 3D Secure einsetzen, sollten Sie einmal mit Ihrem Vertriebsansprechpartner bei Heidelpay sprechen um die nötigen Schritte in die Wege zu leiten.

16 Optische Anpassungen Das neue Heidelpay Plugin verzichtet komplett auf einen IFrame, alle Formulare sind direkt im Shop und können daher von Ihnen angepasst werden. Die Dateien finden Sie unter: engine/shopware/plugins/community/frontend/heidelgateway/views/frontend/register bzw. für das Responsive-Template von Shopware 5: engine/shopware/plugins/community/frontend/heidelgateway/views/responsive/frontend/register Achten Sie bitte beim Editieren darauf, dass die Formularfelder Ihren Namen behalten und führen Sie anschließend ausreichende Test durch. Sollten Sie Fragen haben steht Ihnen unser Support gerne zur Verfügung. Für Anpassungen an den Plugins die von Ihnen vorgenommen wurden, übernimmt die Heidelberger Payment GmbH keine Haftung. Fehlermeldungen bei der Bezahlung Ab der Modulversion besteht die Möglichkeit die Fehlermeldungen, die dem Endkunden angezeigt werden, anzupassen. Um eine bestehende Fehlermeldung anzupassen, loggen Sie sich im Backend ein und klicken auf Einstellungen -> Textbausteine. Abbildung 19: Textbausteine

17 Hier finden Sie alle angelegten Textbausteine. Die Heidelpay Fehlermeldungen finden Sie unter dem Namespace frontend/payment_heidelpay/error oder wenn Sie über die Suchfunktion HPError suchen. Abbildung 20: Fehlercodes Mit dem Bearbeiten Button können Sie die entsprechende Fehlermeldung anpassen. Um eine neue Fehlermeldung zu hinterlegen, loggen Sie sich im Backend ein und klicken unter Einstellungen -> Textbausteine auf Textbaustein hinzufügen. Abbildung 21: Textbaustein hinzufügen

18 Wählen Sie die entsprechende Lokalisierung und den Shop aus. Der Namespace für eine neue Fehlermeldung lautet: frontend/payment_heidelpay/error Der Name der Fehlermeldungen ist folgendermaßen aufgebaut: HPError HPError- ist eine feststehende Bezeichnung zur Identifizierung der Fehlermeldung beschreibt den Fehlercode, für den die Fehlermeldung angezeigt wird. Wollen Sie also zum Beispiel eine Fehlermeldung für den Fehlercode anlegen, wäre der Name der Fehlermeldung: HPError Die jeweiligen Fehlercodes entnehmen Sie der Fehlercode-Liste von Ihrem Vertriebsmitarbeiter. Wichtig: Denken Sie daran die Fehlermeldungen zu übersetzten, sonst wird der Fehler nicht in jeder Sprache angezeigt. Ist für einen Fehlercode kein Textbaustein angelegt, wird der Fehler HPError-default angezeigt.

19 Integrierte Fehlermeldungen / Fehlercodes Name Fehlercode Fehlertext DE Fehlertext EN HPError-default Es ist ein Fehler aufgetreten bitte versuchen Sie es erneut An error has occur, please try again HPError Bitte überprüfen Sie Ihre Eingaben HPError Die Karte ist abgelaufen card expired HPError Bitte überprüfen Sie Ihre Eingaben Please verify your payment data Please verify your payment data HPError Abbruch durch Benutzer Canceled by user HPError Bitte wählen Sie eine andere Zahlart HPError Bitte wählen Sie eine andere Zahlart HPError Bitte wählen Sie eine andere Zahlart HPError Bitte überprüfen Sie Ihre Eingaben HPError Bitte überprüfen Sie Ihre Eingaben HPError Bitte wählen Sie eine andere Zahlart HPError Bitte wählen Sie eine andere Zahlart HPError Bitte wählen Sie eine andere Zahlart HPError Bitte wählen Sie eine andere Zahlart HPError Bitte wählen Sie eine andere Zahlart Please choose another payment method Please choose another payment method Please choose another payment method Please verify your payment data Please verify your payment data Please choose another payment method Please choose another payment method Please choose another payment method Please choose another payment method Please choose another payment method

20 Heidelpay Backend Benutzer Das Heidelpay Plugin erstellt bei der Installation einen Backendbenutzer mit Adminrechten. Dieser Benutzer wird lediglich erstellt um ein filtern der Logeinträge zu ermöglichen. Mit diesem Benutzer kann sich niemand einloggen oder irgendwelche Daten aus Ihrem Shop einsehen oder entnehmen. Mögliche -Adressen für diesen Benutzer sind, je nach Modulversion: oder Abbildung 22: Backend Benutzer Übersicht Abbildung 23: Logfile

21 Transaktionen aus dem Shop Backend (Backend Modul) Ab der Modulversion besteht die Möglichkeit, mit diesem Modul Transaktionen aus dem Shop Backend auszulösen. Bevor Sie die neue Backendfunktionalität benutzen können, müssen Sie das alte Backend Modul Heidelpay Backend Plugin (HeidelActions) deinstallieren. Um eine Transaktion aus dem Shop Backend auszulösen wählen Sie bitte unter Kunden -> Bestellungen die entsprechende Bestellung aus und klicken auf den kleinen Stift die Details zu dieser Bestellung anzuzeigen. Im oberen Abschnitt des neuen Fensters finden Sie jetzt den Reiter Heidelpay. Über diesen Reiter können Sie die jeweilig möglichen Transaktionen zu dieser Bestellung einsehen und auslösen. Bitte beachten Sie, dass Sie mit diesem Modul nur einen Refund auf den jeweils ersten Capture bzw. Debit auslösen können. Für weitere Funktionalitäten benutzen Sie bitte die Heidelpay Intelligence Platform (hip). Des Weiteren gilt zu beachten, dass die Anzeige im Backend des Shops nur Transactionen anzeigen kann die dem Shop gemeldet wurden (Push). um

22 Begriffserklärung: Capture: Refund: Rebill: Reversal: Finalize: Als Capture wird eine Transaktion bezeichnet, welche einen reservierten Betrag einzieht. Z.B. bei einer Kreditkarten Buchung. Als Refund wird eine Transaktion bezeichnet, welche einen eingezogenen Betrag zurück erstattet. Als Rebill wird eine Transaktion bezeichnet, welche eine erneute Belastung der entsprechenden Zahlart einleitet. Als Reversal wird eine Transaktion bezeichnet, welche eine Reservierung rückgängig macht. Wird ein Reversal nur über einen Teilbetrag durchgeführt, kann nur noch der Restbetrag mit einem Capture eingezogen werden. Als Finalize wird eine Transaktion bezeichnet, welche den Versand der bestellten Ware meldet.

23 Zahlungsstatus für Backend Transaktionen anpassen Der Zahlungsstatus der einzelnen Bestellungen wird durch Transaktionen aus dem Backend Modul nicht beeinflusst. Sollten Sie eine Anpassung des Zahlungsstatus wünschen, können Sie dies wie folgt bewerkstelligen: Sie schreiben Sich ein eigenes Modul und registrieren Sie sich in der install()-methode des Moduls auf den Hook calldorequest. $this->subscribeevent('shopware_controllers_backend_backendhgw::calldorequest::after','meth'); Anschließen schreiben Sie die entsprechende Logik in Ihre Methode, z.b.: public function meth(enlight_hook_hookargs $args){ $params = $args->getreturn(); $paycode = explode('.', $params['payment_code']); $pay['paymeth'] = strtolower($paycode[0]); $pay['paytype'] = strtolower($paycode[1]); $transactionid = $params['identification_transactionid']; $sessionid = $params['criterion_sess']; $order = $this->getorder($transactionid); } if($params['processing_result'] == 'ACK'){ } if($pay['paytype'] == 'rf'){ Shopware()->Modules()->Order()->setPaymentStatus($order['id'], 20, false); } Mittels $args->getreturn() bekommen Sie den Return-Wert der gehookten Methode. Anschließend können Sie die Daten beliebig weiter verarbeiten. getorder ist eine eigene Methode welche die entsprechende Bestellung aus der Datenbank lädt. Dies ist nötig um die Order-Id für die Methode setpaymentstatus zu erhalten. In diesem Beispiel setzen wir mittels Shopware()->Modules()->Order()- >setpaymentstatus($order['id'], 20, false), dem Zahlungsstatus der Bestellung bei einem Refund (RF) auf den Wert 20. Dies entspricht dem Status Wiedergutschrift. Die verfügbaren Zahlungsstati können Sie der Datenbanktabelle s_core_states entnehmen.

24 Nice to know Push-Benachrichtigung Die Push-Benachrichtigung ist ein Prozess, um unabhängig vom Zahlprozess Statusupdate an den Shop zu senden. Z.B.: Zahlungseingang bei Vorkasse oder ein Chargeback. Bitte setzten Sie sich mit unserem technischen Support in Verbindung, damit die Push- Benachrichtigungen für Ihre Domain freigeschaltet werden. Responsive Template von Tab10 Wenn Sie ein Responsive Template von Tab10 benutzen kann es auf der Seite er Zahlungsartenauswahl zu einem Shopware Fehler kommen, weil dem Shop keine Zahlungs- ID übergeben wird. Sollte dies der Fall sein, ersetzten sie bitte in folgender Datei: Frontend/TabtenTemplateGrest/Views/frontend/register/payment_fieldset.tpl diese Zeile: <div class="row form_row {if $smarty.foreach.register_payment_mean.last}method_last{else}method{/if}"> Durch diese Zeile: <div class="grid_15 row form_row {if $smarty.foreach.register_payment_mean.last}method_last{else}method{/if}">