BillSAFE. Modul für xt:commerce Veyton. Plugin-Funktionen... Systemvoraussetzung... Mögliches Problem in Veyton CE

Transkript

1 BillSAFE Modul für xt:commerce Veyton Plugin-Funktionen... 2 Systemvoraussetzung... 2 Mögliches Problem in Veyton CE Template- und.htaccess-anpassung... 3 Installation... 6 Konfiguration

2 Plugin-Funktionen Kunden mögen Kauf auf Rechnung. BillSAFE übernimmt das Risiko. Mit unserem kostenfreien Zahlungsmodul können Sie die Funktionen des Dienstleisters BillSAFE in Ihre xt:commerce-shops einbinden. Je nach dem, ob die Kunden JavaScript aktiviert haben oder nicht, bezahlen sie im Shop über ein LayeredPaymentGateway oder werden weitergeleitet zur BillSAFE- Bezahlseite. Außer der Bezahlung über BillSAFE ermöglicht das Plugin die Erstellung von Zahlscheinen und die Meldung des Warenversands, von Stornierungen, Retouren, Fehlüberweisungen sowie die Vergabe von Gutschriften. Systemvoraussetzung Systemvoraussetzung für dieses Plugin ist xt:commerce Veyton ab Version

3 Mögliches Problem in Veyton CE In Version von xt:commerce Veyton CE gibt es in manchen (nicht in allen) Shops ein Problem beim Versenden von s. Es erscheint dann die Fehlermeldung (Debug-Mail): looked for Type:update_order-admin lang:xx group:xx Special:xx Shop:xx Um das Problem zu beheben, ändern Sie unter Inhalte -> Manager -> update_order-admin die Einstellung bei Template Special von 0 auf ALL. Template- und.htaccess-anpassung.htaccess Datei: /plugins/.htaccess Fügen Sie folgenden Code unten an: <Files frame.php> Order Allow,Deny Allow from all </Files> Template Datei: /templates/ihr_template/xtcore/pages/checkout/subpage_success.html Fügen Sie folgenden Code unten an: {literal} <script type="text/javascript"> <!-- if(top.lpg){ top.lpg.close("{/literal}{link page='checkout' paction=success conn=ssl}{literal}"); } --> </script> {/literal} 3

4 Datei: /templates/ihr_template/xtcore/pages/checkout/subpage_payment.html Fügen Sie folgenden Code unten an: {literal} <script type="text/javascript"> <!-- if(top.lpg){ top.lpg.close("{/literal}{link page='checkout' paction='payment' params='error=error_payment' conn=ssl} {literal}"); } --> </script> {/literal} Datei: /templates/ihr_template/xtcore/pages/checkout/subpage_confirmation.html Fügen Sie folgenden Code unten an: {literal} <script type="text/javascript" src=" content.billsafe.de/lpg/js/client.js"></script> <script type="text/javascript"> <!-- var formelement = document.getelementbyid('form_process'); var lpg = new BillSAFE.LPG.client({ form: formelement, conditions: [{element: 'billsafe', value: '1'}], sandbox: {/literal}{$smarty.const.vt_billsafe_sandbox} {literal} }); //--> </script> {/literal} 4

5 Ersetzen Sie folgende Zeile: {form type=form name=process action='checkout' method=post conn=ssl} durch folgende Zeilen: {php} if($_session['selected_payment'] == 'vt_billsafe') { {/php} {form type=form name=process action='checkout' link_params='page_action=process' method=post conn=ssl id="form_process"} {form type=hidden name=billsafe value=true} {php} } else { {/php} {form type=form name=process action='checkout' method=post conn=ssl} {php} } {/php} Optionale Template-Änderungen Die Zahlunsgauswahlseiten-Box für Billsafe lässt sich mit folgender Datei ändern: /vt_billsafe/templates/vt_billsafe_payment.html Das Template des Bestellung bearbeiten im Admin lässt sich mit folgender Datei anpassen: /vt_billsafe/templates/xtcore/pages/vt_billsafe_orderedit.html 5

6 Installation Vorbereitung Vor der Installation eines Plugins sollten Sie Ihre Daten sichern. Besonders wichtig: die Shopdatenbank. Installation Schritt für Schritt 1. Plugin entpacken und per FTP in den Ordner Plugins des Veyton-Shops laden. 2. Die beiliegende Lizenzdatei in den Ordner /lic des Shops laden. 3. Im Adminbereich des Shops das Plugin unter Inhalte -> deinstallierte Plugins installieren. 4. Im Adminbereich das Plugin unter Inhalte -> installierte Plugins aktivieren (auch für den jeweiligen Mandanten) und konfigurieren. Nach der Installation laden sie den kompletten Adminbereich neu (in den meisten Browsern mit F5). 6

7 Konfiguration Aktivierung des Plugins Ort im Admin: Inhalte -> Plugin -> installierte Plugins -> vt_billsafe Plugin-Status: aktiviert das Plugin generell Nach der Aktivierung des Plugins laden Sie den gesamten Adminbereich neu (in vielen Browsern mit F5). Zahlungsweise BillSAFE einrichten Nach der Aktivierung des Plugins und dem Neuladen des Adminbereiches können Sie die Zahlungsart unter Einstellungen -> Zahlungsweise -> vt_billsafe einrichten. 7

8 Beim Einrichten der Zahlungsweise haben Sie u. a. folgende Eingabemöglichkeiten: Status: Damit aktivieren Sie die Zahlungsweise für den jeweiligen Shop. Mandanten-ID: Die ID erhalten Sie von BillSAFE. Lizenzschlüssel: Den Lizenzschlüssel erhalten Sie von BillSAFE. URL zum Shoplogo: Sie können ein Shop-Logo verlinken, das auf der Bezahlseite und auf dem Zahlschein angezeigt werden soll. BillSAFE-Logo-URL: URL zum Logo, das auf der Zahlungsauswahlseite gezeigt werden soll. Eine Übersicht verschiedener Logos finden Sie direkt bei BillSAFE im Kundenkonto. Sandbox-Modus: Steht der Wert auf ja/true ist der Sandbox-Modus aktiv. Dabei werden nur Testzahlungen entgegen genommen, also nicht verbucht. Im Produktivmodus muss der Wert nein/false stehen. 8

9 Bestellstatus Success: Der voreingestellte Wert wird bei der Installation des Plugins automatisch angelegt. Sie können aber auch einen eigenen Wert anlegen. Bestellstatus Failed: Der voreingestellte Wert wird bei der Installation des Plugins automatisch angelegt. Sie können aber auch einen eigenen Wert anlegen. Bestellstatus Mail senden Success: Soll der Käufer per informiert werden, wenn BillSAFE die Zahlung akzeptiert hat? Zahlungsart Bezeichnung: Der Name der Zahlungsart, der auf der Zahlungsauswahlseite angezeigt werden soll Zahlungsart Beschreibung: Die Beschreibung der Zahlungsart, die auf der Zahlungsauswahlseite neben dem Bild angezeigt werden soll. Zahlungsgebühren Beim Bearbeiten der Zahlungsweise können Sie über den Button Zahlungsgebühr eine Zahlungsgebühr festlegen. Die Zahlungsgebühr muss vorher bei BillSAFE beantragt werden. 9

10 Bestellungen bearbeiten Im Fenster Bestellung bearbeiten finden Sie mehrere neue Optionen. 10

11 Button Rechnung erstellen: Damit können Sie einen Zahlschein erstellen. Möglich sind nur Komplettrechnungen, keine Teilrechnungen. Button Versand übermittelt: Damit können Sie den Versand der Waren an BillSAFE übermitteln. Wenn Sie unter Auswahl kein Häkchen gesetzt haben, wird ein Komplettversand gemeldet. Wenn Sie Häkchen gesetzt und keine Anzahl hinterlegt haben, wird ein Teilversand bestimmter Positionen in vollem Bestand gemeldet. Und wenn Sie zusätzlich zu den Häkchen noch Werte bei Anzahl eingetragen haben, wird ein nach Mengen differenzierter Teilversand bei bestimmten Positionen gemeldet. Button Stornierung übermitteln: Bei Stornierungen müssen Sie die einzelnen Artikel vorher auswählen. Eine automatische Komplettstornierung ist nicht möglich. Button Gutschrift stornieren: Zum Stornieren von Gutschriften. Button Retoure: Gelieferte Waren können Sie wieder retourieren lassen und diese auch bei BillSAFE als Retoure kennzeichnen. Dabei müssen Sie die einzelnen Artikel wieder vorher auswählen. Zahlungseingang übermitteln: Wenn der Käufer aus Versehen das Geld auf das Konto des Shopbetreibers überweist, so kann dieser den Zahlungseingang an BillSAFE übermitteln. (Es ist nicht notwendig, dass der Shopbetreiber das Geld an BillSAFE weiterleitet.) Gutschrift geben: Sie können dem Kunden eine Gutschrift geben. Dabei sind Betrag und Steuersatz auszuwählen. Diese Funktion arbeitet von der Logik der Eingaben her wie das Gutscheinmodul von xt:commerce (xt_coupons). 11

12 Weitere Informationen und Angebote finden Sie auf: Individuelle Anfragen richten Sie bitte an: BuI Hinsche GmbH Geschäftsführer: Matthias Hinsche Donaliesstraße 45/ Zeitz Telefon: +49 (0) / Telefax: +49 (0) /