BillSAFE Modul für Modified ecommerce

Transkript

1 BillSAFE Modul für Modified ecommerce Herzlich willkommen, Sie haben sich für BillSAFE, den beliebtesten Rechnungskauf-Anbieter bei Deutschlands Online-Shoppern entschieden. (TNS Emnid Studie 01/2011) Stand: 7. Mai 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 auf einen Blick... 3 Kapitel II - Installation des BillSAFE Moduls... 4 Update eines bestehenden Rechnungskauf Moduls... 8 Kapitel III - Konfiguration des BillSAFE Moduls...10 Zu den Einstellungen des Rechnungskauf Moduls:...11 Zu den Einstellungen des Ratenkauf Moduls:... Fehler! Textmarke nicht definiert. Zu den Zusatzmodulen...13 Kapitel IV - Arbeiten mit BillSAFE...15 a) BillSAFE Bestelldetails...15 b) Komplettlieferung...17 c) Stornierung...17 d) Retoure...17 e) Anbietergutschrift...18 f) Erstellung der Rechnung...19 Kapitel V - Testkauf BillSAFE Modul

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

4 Kapitel II - Installation des BillSAFE Moduls Hinweis! In der aktuellen Version der modified ecommerce Shopsoftware ist der BillSAFE Rechnungskauf vorinstalliert. Sie können den ersten Teil also überspringen. Gehen Sie direkt zu Kapitel 3. Für ältere Shopversionen verwenden Sie bitte das xt:commerce Modul aus dem BillSAFE Integration Center. Bevor Sie mit der Installation beginnen, erstellen Sie bitte von Ihrer Datenbank sowie den zu ändernden Dateien ein Backup! Bitte deinstallieren Sie eventuell schon vorhandene, ältere Versionen dieses Moduls im Backend Ihres Shops! Die Dateien können einfach überschrieben werden. Voraussetzung: 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 in die entsprechenden Unterverzeichnisse des Shops. Bitte stellen Sie sicher, dass hierbei die komplette Ordnerstruktur inklusive aller Unterordner kopiert wird und die Transfermethode binär, bzw. binary ausgewählt wurde. 3. Suchen Sie in der Orders.php (Shopverzeichnis/admin/orders.php) nach: $contents[] = array ('align' => 'center', 'text' => '<a class="button" href="'.xtc_href_link(filename_orders, xtc_get_all_get_params(array ('oid', 'action')).'oid='.$oinfo- >orders_id.'&action=edit').'">'.button_edit.'</a> <a class="button" href="'.xtc_href_link(filename_orders, xtc_get_all_get_params(array ('oid', 'action')).'oid='.$oinfo- >orders_id.'&action=delete').'">'.button_delete.'</a>'); und fügen bitte darunter folgende Zeilen ein: //BillSAFE Payment Module START if ($oinfo->payment_method === 'billsafe_2') { 4

5 $contents[] = array ('align' => 'center', 'text' => '<a class="button" href="billsafe_orders_2.php?oid='.$oinfo->orders_id.'">billsafe Details</a>'); } elseif ($oinfo->payment_method === 'billsafe_2hp') { $contents[] = array ('align' => 'center', 'text' => '<a class="button" href="billsafe_orders_2hp.php?oid='.$oinfo->orders_id.'">billsafe Details</a>'); } //BillSAFE Payment Module END Abbildung 1 Beispiel Snippet Anpassung Orders.php 4. Der Inhalt der Datei includes/header.snippet muss an das Ende der includes/header.php eingefügt werden: // BillSAFE-Layer Start if (preg_match('/checkout_payment/',$_server['php_self']) && MODULE_PAYMENT_BILLSAFE_2_LAYER == 'True') { if (isset($_get['payment_error'])) { $bs_error = stripslashes(html_entity_decode('payment_error='.$_get['payment_error'].'&error_message='.$_get['error_message']) ); } else { $bs_error = ''; } echo '<script type="text/javascript"><!-- 5

6 if (top.lpg) top.lpg.close("'.str_replace('&', '&', xtc_href_link(filename_checkout_payment, $bs_error, 'SSL')).'"); --></script>'; } if (preg_match('/checkout_success/',$_server['php_self']) && MODULE_PAYMENT_BILLSAFE_2_LAYER == 'True') { echo '<script type="text/javascript"><!-- if (top.lpg) top.lpg.close("'.xtc_href_link(filename_checkout_success, '', 'SSL').'"); --></script>'; } // BillSAFE-Layer End 5. In der /checkout_payment.php über "$smarty->assign('language', $_SESSION['language']);" nun bitte folgende Zeilen einfügen: if ($_GET['billsafe_close'] == 'true' $_GET['payment_error'] == 'billsafe_2' $_GET['payment_error'] == 'billsafe_2hp') echo '<script type="text/javascript"> if (top.lpg) top.lpg.close("'.xtc_href_link(filename_checkout_payment, 'error_message='.stripslashes(urlencode(html_entity_decode($_get['error_message']))), 'SSL').'"); </script>'; 6. Abschließend bitte in der /checkout_success.php über "$smarty->assign('language', $_SESSION['language']);" folgende Zeilen einfügen: echo '<script type="text/javascript"> if (top.lpg) top.lpg.close("'.xtc_href_link(filename_checkout_success, '', 'SSL').'"); </script>'; 7. Loggen Sie sich in Ihre Shop-Administration ein. Unter Module / Zusammenfassung. Wählen Sie BillSAFE-Zuschlag aus und drücken auf Installieren. Hinweis! Bitte beachten Sie die Hinweise zur richtigen Anzeigenreihenfolge der Module im Kapitel Zu den Zusatzmodulen. 6

7 8. Gehen Sie bitte zu dem Menüpunkt Module / Zahlungsoptionen. Wählen Sie das gewünschte Zahlungsmodul aus. Zur Installation des Rechnungskauf Moduls wählen Sie Kauf auf Rechnung mit BillSAFE aus und klicken auf Installieren Abbildung 2 Installation des BillSAFE Rechnungskauf Moduls 7

8 Update eines bestehenden Rechnungskauf Moduls Wenn Sie den BillSAFE Rechnungskauf bereits verwenden, kann das bestehende Modul problemlos aktualisiert werden. 1. Im Admin Bereich klicken Sie im Rechnungskauf Modul bitte auf deinstallieren. Bestehende Bestellungen bleiben erhalten. Abbildung 4 Deinstallation des BillSAFE Rechnungskauf Moduls 2. Kopieren Sie dann die Moduldateien per FTP in die entsprechenden Unterordner. Bitte stellen Sie sicher, dass hierbei die komplette Ordnerstruktur inklusive aller Unterordner kopiert wird. Bestehende Dateien werden überschrieben. 3. In der /admin/orders.php muss das vorhandene Snippet gegen folgendes ersetzt werden: //BillSAFE Payment Module START if ($oinfo->payment_method === 'billsafe_2') { $contents[] = array ('align' => 'center', 'text' => '<a class="button" href="billsafe_orders_2.php?oid='.$oinfo->orders_id.'">billsafe Details</a>'); 8

9 } elseif ($oinfo->payment_method === 'billsafe_2hp') { $contents[] = array ('align' => 'center', 'text' => '<a class="button" href="billsafe_orders_2hp.php?oid='.$oinfo->orders_id.'">billsafe Details</a>'); } //BillSAFE Payment Module END 4. Aktualisieren Sie die Liste der Zahlungsmodule im Admin Bereich. Abbildung 5 BillSAFE Module in den Zahlungsweisen Installieren Sie das gewünschte Modul und tragen wie gewohnt Ihre BillSAFE API Signatur ein. Die Konfiguration ist im folgenden Kapitel noch einmal im Detail erläutert. 9

10 Kapitel III - Konfiguration des BillSAFE Moduls Nach der erfolgreichen Installation, wählen Sie das gewünschte BillSAFE Modul aus und klicken auf Bearbeiten. Tragen Sie hier bitte Ihre BillSAFE Daten ein und drücken Sie auf Aktualisieren. Das funktioniert bei beiden Zahlarten im Prinzip analog. Einstellungen Abbildung 6 Übersicht BillSAFE 10

11 Zu den Einstellungen des Rechnungskauf Moduls: Die Option BillSAFE Modul aktivieren muss auf true stehen. Der Payment Layer sollte aktiviert sein. Das Log dient lediglich zur Fehleranalyse, kann im Normalfall also deaktiviert bleiben. Der Höchstbestellwert sollte den mit BillSAFE vereinbarten, maximalen Warenkorb nicht überschreiten. Der BillSAFE Server muss auf Live stehen. Sollte Sie zunächst testen wollen, wählen Sie bitte Sandbox. Zu den Sandbox Tests beachten Sie bitte die Hinweise im Kapitel V. Hinweis! Auch für den Sandbox-Modus muss das BillSAFE Modul aktiviert sein! Im Feld BillSAFE Logo-URL kann ein Link zum BillSAFE Logo aus dem Händlerportal hinterlegt werden. Alternativ können Sie auch ein eigenes Logo mit dem Hinweis auf Rechnung hinterlegen oder das Feld leer lassen. Das Logo wird in der Zahlartenübersicht im Shop neben dem Rechnungskauf 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! Bitte beachten Sie, dass das Logo nicht breiter als 130 Pixel und nicht höher als 60 Pixel sein darf Erlaubte Zonen: Hier muss DE stehen. Hinweis! Wir empfehlen, die Zahlart Rechnung auch als solche zu benennen. Der Hinweis auf BillSAFE kann also entfernt werden. Sie können die Bezeichnung hier ändern: \lang\german\modules\payment\billsafe_2.php Zeile 20: define('module_payment_billsafe_2_text_title', 'Rechnung'); Zeile 21: define('module_payment_billsafe_2_checkout_text_info', 'Kaufen Sie jetzt auf Rechnung und begutachten Sie Ihre Einkäufe in Ruhe bevor Sie bezahlen.'); 11

12 Einrichtung eines Zahlartenaufschlages Den Aufschlag für die Zahlung mit BillSAFE können Sie unter Module / Zahlungsoptionen / Kauf auf Rechnung mit BillSAFE hinterlegen. Damit er funktioniert, muss das BillSAFE Zuschlag Modul unter Module > Zusammenfassung installiert sein. Hinweis! Der Zahlartenaufschlag muss vorher mit BillSAFE vereinbart werden, da es ansonsten zu einer Fehlermeldung kommt. 12

13 Zu den Zusatzmodulen Hinweis: Bitte beachten Sie die korrekte Reihenfolge der Module. Folgende Reihenfolge ist empfohlen. Zwischensumme ot_subtotal 10 Rabatt ot_discount 20 Versandkosten ot_shipping 30 Eigenhändig ot_ps_fee 35 (muss direkt nach den Versandkosten kommen) Nachnahmegebühr ot_cod_fee 40 Rabatt Kupons ot_coupon 45 Mindermengenzuschlag ot_loworderfee 49 (muss vor Summe, Netto stehen) Summe, netto ot_subtotal_no_tax 50 BillSAFE-Zuschlag ot_billsafe 55 Vorkasse/Rabatt ot_payment 55 MwSt. ot_tax 60 Gutscheine ot_gv 70 Summe ot_total 99 Abbildung 7 Empfohlene Anordnung der Module Zusammenfassung 13

14 Bitte beachten Sie, Im Gutschein (ot_gv ) sollten folgende Einstellungen gesetzt sein: Abbildung 8 Einstellungen Gutschein 14

15 Kapitel IV - Arbeiten mit BillSAFE Im Backend werden Rechnungs- und Ratenkauf Bestellungen ähnlich behandelt. Der markanteste Unterschied ist, dass beim Ratenkauf keine extra Rechnung erstellt werden muss. Sie können die trotzdem erstellen, anstelle der BillSAFE Bankverbindung erscheint dann allerdings ein Hinweis auf den Ratenzahlungsplan, den der Kunde von BillSAFE erhält. a) BillSAFE Bestelldetails Über den Menüpunkt Kunden/Bestellungen gelangen Sie zur Bestellübersicht. Wurde bei einer Bestellung BillSAFE (Rechnungs- oder Ratenkauf) als Zahlart gewählt, so erscheint neben der Übersicht ein Button BillSAFE Details. Abbildung 9 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. 15

16 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. Abbildung 10 BillSAFE Bestellung Detailansicht 16

17 b) Komplettlieferung Wählen Sie Komplettlieferung, 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 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. Möchten Sie hingegen nur einzelne Positionen der Bestellung stornieren, wählen Sie bitte dazu die entsprechenden Checkboxen aus und klicken auf Teilstornierung. Abbildung 11 BillSAFE Funktionen 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 Bei einzelnen Artikeln wählen Sie die Artikel aus und wählen Teil-Retoure. 17

18 Abbildung 12 Bestellhistorie e) Anbietergutschrift Wenn Sie Ihren Kunden nachträglich eine Gutschrift gewähren möchten, können Sie dies über die Funktion Anbietergutschrift tun. Wählen Sie hierzu den gutzuschreibenden Betrag und den Steuersatz aus und betätigen den Button Anbietergutschrift. Die Gutschrift wird danach in den Bestelldetails als auch in der Historie aufgeführt. Abbildung 13 BillSAFE Funktion Anbietergutschrift 18

19 f) 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. Daraufhin öffnet sich ein Fenster mit der Druckansicht der Rechnung. Abbildung 14 Button zur Rechnungserstellung Bei einer Ratenzahlung erscheint statt der BillSAFE- Bankverbindung ein Hinweis auf den Ratenplan. Abbildung 15 Beispielrechnung mit BillSAFE Details 19

20 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 [email protected] 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 [email protected] 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! 20