BillSAFE Modul für Magento CE 1.4.x, PE 1.9.x und EE 1.9.x

Größe: px
Ab Seite anzeigen:

Download "BillSAFE Modul für Magento CE 1.4.x, PE 1.9.x und EE 1.9.x"

Transkript

1 BillSAFE Modul für Magento CE 1.4.x, PE 1.9.x und EE 1.9.x Herzlich willkommen, Sie haben sich für BillSAFE, den beliebtesten Rechnungskauf-Anbieter bei Deutschlands Online-Shoppern entschieden. (TNS Emnid Studie 01/2011) Stand: 13. Dezember 2011 Alle verwendeten Markenzeichen sind urheberrechtlich geschützt. Die Abbildungen dienen der beispielhaften Darstellung und können von den bei Ihnen angezeigten abweichen BillSAFE GmbH. 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... 5 Kapitel IV - Arbeiten mit BillSAFE... 6 a) Versand melden (Komplett- + Teilversand)... 6 b) Stornierung... 7 c) Retouren... 7 Kapitel V - Testkauf BillSAFE Modul

3 Kapitel I - BillSAFE Rechnungskauf auf einen Blick Anhand der dargestellten Grafik sehen Sie, wie einfach der Rechnungskauf 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! Voraussetzung: Magento (CE 1.4.x und höher, PE 1.9.x und höher oder EE 1.9.x und höher), Eingerichtete Steuersätze im Magento Backend PHP Version 5.x, MySQL 5.x Über das Modul Dieses Modul stellt ein Interface zwischen Magento und dem Bezahldienst BillSAFE bereit. Dadurch wird dem Kunden eine Zahlung auf Rechnung ermöglicht. Die Absicherung der Zahlung erfolgt durch BillSAFE. Dazu wird die Ausfallwahrscheinlichkeit mittels Bonitätsprüfung durch BillSAFE überprüft und die Zahlung auf Rechnung nur im Positivfall ermöglicht. Im negativen Fall wird der Kunde zurück zum Shop geleitet und zur Auswahl einer anderen Zahlart aufgefordert. Wichtiger Hinweis zur Implementierung Das BillSAFE-Modul wird zunächst im Sandbox-Betrieb ausgeführt. (Einer Demo-Umgebung für Tests) Die nötige MerchandID (MID) und den Lizensschlüssel (License-Key) finden Sie im BillSAFE Händlerportal. Damit das Modul Freigeschaltet und im Live-Betrieb verwendet werden kann, müssen zunächst die Tests der Abnahme Checkliste für Shophändler ausgeführt werden. 4

5 Kapitel III - Konfiguration des BillSAFE Moduls Alle relevanten Einstellungen können direkt im Magento Backend unter System->Konfiguration->Verkäufe->Zahlungsarten->BillSAFE vorgenommen werden. Aktiv Option Testmodus Titel Status einer neuen Bestellung Verkäufer ID Lizenzschlüssel Zahlartenlogo URL Händlerlogo-URL Min./Max. Bestellwert Payment Fee SKU Zahlungsartenaufschlag Fehler Protokollierung aktivieren Beschreibung Nur wenn dieser auf Ja gesetzt ist, BillSAFE für den Endkunden im Frontend als mögliche Zahlart verfügbar. Im Testmodus werden alle API-Aufrufe an BillSAFE über eine Sandbox behandelt. Diese Möglichkeit sollte vor allem für Tests und während der Entwicklung aktiviert werden. Achtung: Im Live-Betrieb sollte der Testmodus stets deaktiviert sein. Der für den Endkunden sichtbare Name der Zahlart im Checkout. Der Status, den neue mit BillSAFE getätigte Bestellungen erhalten sollen. Ihre BillSAFE "Merchant ID" Der eindeutige von BillSAFE an Sie übergebene Lizenschlüssel. Die URL des im Frontend angezeigten Zahlungslogos. Standardmäßig wird hierbei ein Bild vom BillSAFE Server geladen. Die URL des auf der BillSAFE-Bezahlseite angezeigten Logos. Diese Option bietet die Möglichkeit nach der Weiterleitung auf BillSAFE weiterhin den Shop-Kontext zu wahren. Der Maximalbestellwert darf den mit BillSAFE vereinbarten Maximalbetrag für eine Bestellung nicht überschreiten Falls Sie einen Aufschlag auf BillSAFE-Zahlungen vom Kunden verlangen möchten, geben Sie hier die SKU des Produktes an, welches für den Zahlungsartenaufschlag verwendet werden soll. Im Folgenden wird dies genauer beschrieben. Wenn dieser Wert auf "Ja" gesetzt ist, werden alle API-Aufrufe an BillSAFE in eine separate billsafe.log-datei geschrieben. Die entsprechende Datei findet sich im Normalfall im /var/log- Verzeichnis der Magento-Installation. 5

6 Zahlungsartenaufschlag Um den Zahlungsartenaufschlag möglichst transparent zu gestalten, wird ein virtuelles Produkt verwendet. Sobald der Kunde eine Zahlungsart wählt, für die der Aufschlag vorgesehen ist, wird dieses virtuelle Produkt automatisch in den Warenkorb gelegt. Dieses Produkt ist jedoch im Warenkorb nicht sichtbar. Das Produkt für den Zahlungsartenaufschlag muss manuell angelegt werden: Erzeugen Sie dafür ein virtuelles Produkt, ordnen Sie ihm einen Namen, einen Preis, einen Bestand, die Steuerklasse und natürlich die in der BillSAFE-Konfiguration angegebene SKU zu. Dieses Produkt muss aktiv sein, aber nicht individuell sichtbar. Kapitel IV - Arbeiten mit BillSAFE Eine Bestellung per BillSAFE können Sie grundsätzlich wie jede andere Magento-Bestellung bearbeiten. Eine erfolgreiche Bestellung bekommt den im Backend gesetzten initialen Status (Standard 'processing' bzw. 'Verarbeitung'). a) Versand melden (Komplett- + Teilversand) Sind alle Bestellpositionen versandbereit, können Sie die Sendung über den Button 'Sendung' anlegen. Hinterlegen Sie, sofern vorhanden, eine Trackingnummer. Sie können an dieser Stelle auch nur einen Teil der Ware versenden, indem Sie die Anzahl der Artikel entsprechend ändern. Dadurch wird der Versand bei BillSAFE registriert und das Zahlungsziel festgelegt. Haben Sie alle Artikel versandt, die Sie bedienen wollen, können Sie eine Rechnung über diese Artikel erstellen. Bitte beachten Sie dabei, dass BillSAFE nur die Erstellung einer Rechnung unterstützt und diese immer alle versandten Artikel enthalten muss. Artikel die nicht versandt wurden, können nicht in Rechnung gestellt werden und werden beim Erstellen der Rechnung automatisch storniert. Anschließend können Sie die neu erstellte Rechnung in Magento öffnen und diese über den 'Drucken'-Button ausdrucken, um Sie der Sendung beizulegen. 6

7 b) Stornierung Das Storno der kompletten Bestellung kann wie gewöhnlich in Magento durchgeführt werden. Die bei BillSAFE registrierte Forderung an den Kunden wird dadurch ebenso komplett storniert. c) Retouren Retouren, auch Teilretouren, können wie gewohnt an der Rechnung mittels einer Gutschrift durchgeführt werden. Hinweis! Gegenwärtig unterstützt BillSAFE keine Berechtigungszuschläge. Sie können diese jedoch über eine Berechtigungserstattung realisieren: Eine Artikelposition im Wert von 10,00 soll gutgeschrieben werden. Zusätzlich wird jedoch eine Gebühr von 3,00 erhoben. Normalerweise wird die Artikelposition retourniert und ein Berechtigungszuschlag von 3,00 erhoben. Bei BillSAFE-Bestellungen markieren Sie das Produkt nicht als retourniert und geben stattdessen eine Berechtigungserstattung in Höhe der Differenz des Warenwerts und der Berechtigungserstattung ein. Im Beispielfall also 7,00. Achtung! Bei der Verwendung von Magento CE Version Hier besteht ein Fehler bei der Steuerberechnung von Versandkosten. Dieser führt dazu, dass es nach einer Berechtigungserstattung nicht mehr möglich ist, eine Komplettgutschrift durchzuführen. Dies ist ein Fehler von Magento und kann nur durch ein Update der Magento-Version gelöst werden. 7

8 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! 8