BillSAFE Modul für oscommerce 2.3.1

Transkript

1 BillSAFE Modul für oscommerce Herzlich willkommen, Sie haben sich für BillSAFE, den beliebtesten Rechnungskauf-Anbieter bei Deutschlands Online-Shoppern entschieden. (TNS Emnid Studie 01/2011) Stand: 14. Februar 2013 Alle verwendeten Markenzeichen sind urheberrechtlich geschützt. Die Abbildungen dienen der beispielhaften Darstellung und können von den bei Ihnen angezeigten abweichen BillSAFE / PayPal. Alle Rechte vorbehalten. Alle Angaben ohne Gewähr. 1

2 Inhaltsverzeichnis Inhaltsverzeichnis... 2 Kapitel I - BillSAFE Rechnungskauf auf einen Blick... 3 Kapitel II - Installation des BillSAFE Moduls... 4 Kapitel III - Konfiguration des BillSAFE Moduls... 9 Kapitel IV - Arbeiten mit BillSAFE...10 a) BillSAFE Bestelldetails...10 b) Komplettlieferung...12 c) Stornierung...12 d) Retoure...13 e) Anbietergutschrift...13 f) Direkte Zahlung durch den Kunden melden...14 g) Erstellung der Rechnung...14 Kapitel V - Testkauf BillSAFE Modul

3 Kapitel I - BillSAFE Rechnungskauf auf einen Blick Anhand der dargestellten Grafik sehen Sie, wie einfach der Rechnungs-/ Ratenkauf mit BillSAFE in Ihrem Online-Shop funktioniert 3

4 Kapitel II - Installation des BillSAFE Moduls Hinweis! Bevor Sie mit der Installation beginnen, erstellen Sie bitte von Ihrer Datenbank sowie den zu ändernden Dateien ein Backup! Achten Sie zudem bitte darauf, als Transfermethode binär, bzw. binary auszuwählen. Voraussetzung: oscommerce 2.3.1, PHP Version 5.x, MySQL 5.x 1. Stellen Sie via FTP-Client eine Verbindung zu Ihrem Webserver her. 2. Entpacken Sie das Modul und kopieren Sie alle Dateien aus dem Ordner BillSAFE_osC_1_3 in das Rootverzeichnis des Shops. Bitte stellen Sie sicher, dass hierbei die komplette Ordnerstruktur inklusive aller Unterordner kopiert wird. 3. Suchen Sie in der Orders.php (Shopverzeichnis/admin/orders.php) nach der Zeile (ca. Zeile 391): $contents[] = array('text' => '<br />'. TEXT_INFO_PAYMENT_METHOD. ' '. $oinfo->payment_method); und fügen bitte darunter folgende Zeilen ein: //BillSAFE Payment Module START if (stristr($oinfo->payment_method, 'BillSAFE')) { $contents[] = array ('align' => 'center', 'text' => tep_draw_button('billsafe Details', 'document', 'billsafe_orders_2.php?oid='.$oinfo->orders_id)); } elseif (stristr($oinfo->payment_method, 'Raten')) { $contents[] = array ('align' => 'center', 'text' => tep_draw_button('billsafe Details', 'document', 'billsafe_orders_2hp.php?oid='.$oinfo->orders_id)); } //BillSAFE Payment Module END 4

5 Abbildung 1 Beispiel Snippet Anpassung Orders.php 4. Editieren Sie die root/includes/header.php und fügen Sie unten den Code aus der Moduldatei header.snippet.php ein: // BillSAFE-Layer Start if (preg_match('/checkout_payment/',$_server['php_self']) && (MODULE_PAYMENT_BILLSAFE_2_LAYER == 'True' MODULE_PAYMENT_BILLSAFE_2HP_LAYER == 'True')) { if (isset($_get['error_message'])) { $bs_error = stripslashes('error_message='.urlencode(html_entity_decode($_get['error_message']))); } else { $bs_error = ''; } echo '<script type="text/javascript"><!-- if (top.lpg) top.lpg.close("'.str_replace('&', '&', tep_href_link(filename_checkout_payment, $bs_error, 'SSL')).'"); --></script>'; } if (preg_match('/checkout_success/',$_server['php_self']) && (MODULE_PAYMENT_BILLSAFE_2_LAYER == 'True' MODULE_PAYMENT_BILLSAFE_2HP_LAYER == 'True')) { echo '<script type="text/javascript"><!-- if (top.lpg) top.lpg.close("'.tep_href_link(filename_checkout_success, '', 'SSL').'"); --></script>'; } // BillSAFE-Layer End 5

6 Abbildung 2 Beispiel Snippet Anpassung header.php 5. Loggen Sie sich in Ihre Shop-Administration ein. 6. Sollten Sie schon ein Rechnungskauf Modul verwenden, gehen Sie bitte zu Module > Zahlung. Deaktivieren Sie das Modul und klicken anschließend auf: Module entfernen. Abbildung 3 Altes Rechnungskauf Modul entfernen Bei einer kompletten Neuinstallation können Sie diesen Punkt überspringen. 6

7 7. Unter Modules / Total Bestellungen gehen Sie zu Module Installieren und wählen Sie BillSAFE-Zuschlag aus. Klicken sie auf Installieren. Bitte beachten: Der BillSAFE Aufschlag muss vor der Steuer geladen werden. Vergeben Sie als Reihenfolge also eine niedrigere Ziffer für das BillSAFE Modul als für Steuern. Dieser Schritt kann übersprungen werden, wenn Sie ein bestehendes Rechnungskauf Modul aktualisieren. Abbildung 4 BillSAFE Zuschlag und Mindermengenzuschlag 8. In der Shop-Administration: Gehen Sie bitte zu Module > Zahlung und wählen unter Module Installieren Kauf auf Rechnung mit BillSAFE aus. Drücken Sie dann auf Installieren. 7

8 Abbildung 5 Installation von Zahlungsmodulen Abbildung 6 Auswahl des BillSAFE Moduls 8

9 Kapitel III - Konfiguration des BillSAFE Moduls Nach der erfolgreichen Installation, wählen Sie das gewünschte BillSAFE Modul aus (Rechnungskauf und/oder Kauf auf Raten) aus und klicken auf Bearbeiten. Tragen Sie hier bitte Ihre BillSAFE Daten ein und drücken Sie auf Aktualisieren. Der UTF-8 Modus muss nur aktiviert werden, wenn der Shop in einem abweichenden Zeichensatz aufgesetzt wurde. Sollten Sie einen Zahlartenaufschlag setzen wollen, muss das Zusatzmodul installiert sein (siehe oben). Der Wert muss entweder in % angegeben sein oder absolut. Als Dezimaltrenner bitte einen Punkt. Zahlartenaufschläge müssen vorher mit BillSAFE vereinbart werden. Als Maximum Order Value verwenden Sie bitte das mit BillSAFE vereinbarten Bestelllimit pro Bestellung. Hinweis! Bitte beachten Sie, dass das Logo nicht breiter als 130 Pixel und nicht höher als 60 Pixel sein darf Hinterlegen Sie bitte in dem Feld BillSAFE Logo-URL den Link zu unserem Logo aus dem Händlerportal. Dadurch wird in der Zahlartenübersicht im Shop das BillSAFE Logo angezeigt. In dem Feld Shop Logo URL können Sie ein Logo Ihres Shops hinterlegen. Dieses Logo wird dann im BillSAFE Payment Gateway angezeigt. Hinweis! Auch für den Sandbox-Modus muss das BillSAFE Modul aktiviert sein! Abbildung 7 BillSAFE Rechnungskauf Einstellungen 9

10 Kapitel IV - Arbeiten mit BillSAFE Im Folgenden wird die Arbeit mit BillSAFE am Beispiel des Rechnungskaufs erläutert. a) BillSAFE Bestelldetails Über den Menüpunkt Kunden/Bestellungen gelangen Sie zur Bestellübersicht. Wurde bei einer Bestellung BillSAFE als Zahlart gewählt, so erscheint neben der Übersicht ein Button BillSAFE Details. Abbildung 8 BillSAFE Details Button Unter den BillSAFE Details sehen Sie im oberen Bereich die Rechnungsadresse des Kunden, sowie die Lieferadresse. Des Weiteren sind dort die BillSAFE Zahlungsdetails zu sehen, welche ebenfalls auf der Rechnung erscheinen. In der Mitte sehen Sie alle Artikel der Bestellung samt Checkbox zum Auswählen. Darunter befinden sich die Buttons zum Auswählen der jeweiligen Aktion (Komplettlieferung, Teillieferung, Komplettstornierung, Teilstornierung) Im unteren Bereich sehen Sie die Historie der ausgeführten Aktionen. Hierüber werden auch Retouren bereits versandter Artikel gemeldet. 10

11 11 Abbildung 9 BillSAFE Bestellung Detailansicht

12 b) Komplettlieferung Wählen Sie Komplettlieferung (Report full Shipment), um den Versand ALLER Artikel an BillSAFE zu melden. Wenn Sie nicht alle Artikel einer Bestellung auf einmal versenden, wählen Sie bitte mithilfe der Checkbox die Artikel aus, die versendet werden sollen und klicken auf Teillieferung (Report Partial Shipment) c) Stornierung Analog zur Lieferung verfahren Sie bitte auch bei den Stornierungen. Möchten Sie ALLE Artikel einer Bestellung Stornieren, wählen Sie bitte Komplettstornierung (Full returns). Möchten Sie hingegen nur einzelne Positionen der Bestellung stornieren, wählen Sie bitte dazu die entsprechenden Checkboxen aus und klicken auf Teilstornierung. (Partial returns) Abbildung 10 BillSAFE Funktionen 12

13 d) Retoure Bereits versandte Artikel können Sie über die Historie der Bestellung Retournieren. Wenn Sie ALLE versandten Artikel einer Bestellung retournieren möchten, klicken Sie bitte in der Historie auf den Button Komplett-Retoure (Full returns) Bei einzelnen Artikeln wählen Sie die Artikel aus und wählen Teil-Retoure (Partial returns). Abbildung 11 Retouren und Teilretouren e) Anbietergutschrift Wenn Sie Ihren Kunden nachträglich eine Gutschrift gewähren möchten, können Sie dies über die Funktion Anbietergutschrift (Credit) tun. Wählen Sie gutzuschreibenden Betrag und den Steuersatz aus und betätigen den Button Anbietergutschrift (Credit). Die Gutschrift wird danach in den Bestelldetails als auch in der Historie aufgeführt. Abbildung 12 BillSAFE Funktion Anbietergutschrift 13

14 f) Direkte Zahlung durch den Kunden melden Wenn Sie eine direkte Zahlung an BillSAFE melden wollen, das heißt der Kunde hat den fälligen Betrag statt an BillSAFE an Sie direkt überwiesen, können Sie dies über die Funktion Direkte Zahlung melden (Direct payment by customer) tun. Wählen Sie hierzu den Betrag und tragen das Datum der Zahlung ein. Klicken Sie den Button (Transmit direct payment now). Abbildung 13 BillSAFE Funktion Anbietergutschrift g) Erstellung der Rechnung Da auf der Rechnung, bei der Verwendung von BillSAFE als Zahlart, die BillSAFE Zahlungsdetails eingefügt werden (Kontoverbindung, Hinweistext, Verwendungszweck), müssen Sie die Rechnung über die BillSAFE Details erstellen. Klicken Sie hierzu in der Detailansicht der Bestellung auf den Button Rechnung (Invoice). Daraufhin öffnet sich ein Fenster mit der Druckansicht der Rechnung. Abbildung 12 Button zur Rechnungserstellung 14

15 15 Abbildung 13 Beispielrechnung mit BillSAFE Details

16 Kapitel V - Testkauf BillSAFE Modul Hinweis! Bitte überprüfen Sie ob der Sandbox-Modus eingeschaltet ist (BillSAFE Server = Sandbox)! 1. Legen Sie bitte einen beliebigen Artikel in Ihren Warenkorb und gehen zur Kasse 2. Verwenden Sie bitte folgende Käuferdaten: Paul Positiv Märchenstraße 15a Osnabrück paul@billsafe.de Tel.: Hinweis! In der Sandbox werden alle Anfragen, die nicht den Testkäuferdaten entsprechen, abgelehnt! 3. Wählen Sie bitte BillSAFE als Zahlart aus und schließen die Bestellung ab. 4. Gehen Sie nun bitte in den Administrationsbereich Ihres Shops und rufen die Bestellung über BillSAFE Details auf 5. Generieren Sie bitte eine Rechnung aus Ihrem Shop und überprüfen Sie ob die BillSAFE Details dort zu sehen sind. 6. Wenn alle Details angezeigt werden, schicken Sie bitte die Rechnung an support@billsafe.de mit dem Betreff Freischaltung + Ihre VID. Wir prüfen die Rechnung und, sofern alles ordnungsgemäß angezeigt wird, schalten wir Sie direkt für den Live-Modus frei. 7. Sie können nun die Sandbox ausschalten und Ihren Kunden den Kauf auf Rechnung mit BillSAFE anbieten. Wir wünschen Ihnen einen guten Umsatz! 16