Anleitung - BillSAFE

BillSAFE Modul
für Magento ab CE 1.5.0.0
PE 1.11.0.0 und EE 1.11.0.0
Herzlich willkommen,
Sie haben sich für BillSAFE, den beliebtesten Rechnungskauf-Anbieter bei Deutschlands
Online-Shoppern entschieden. (TNS Emnid Studie 01/2011)
Stand: 5. März 2014
Alle verwendeten Markenzeichen sind urheberrechtlich geschützt.
Die Abbildungen dienen der beispielhaften Darstellung und können von den bei Ihnen angezeigten abweichen.
© 2013 BillSAFE / PayPal. Alle Rechte vorbehalten. Alle Angaben ohne Gewähr.
1
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 - Zahlungsartenaufschlag .................................................................................................................................................................................................. 7
Kapitel V – Bestellprozess ................................................................................................................................................................................................................... 9
Kapitel VI - Arbeiten mit BillSAFE .....................................................................................................................................................................................................11
a)
Versand melden (Komplett- + Teilversand) .........................................................................................................................................................................11
b)
Rechnungsstellung .................................................................................................................................................................................................................12
c)
Stornierung .............................................................................................................................................................................................................................13
d)
Retouren ..................................................................................................................................................................................................................................14
e)
Berichtigungszuschlag ...........................................................................................................................................................................................................15
Kapitel VII - Testkauf BillSAFE Modul ...............................................................................................................................................................................................16
2
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
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.5.0.0 und höher, PE 1.11.0.0 und höher oder EE 1.11.0.0 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 (VID), Lizenzschlüssel
(License-Key) und Public 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
Kapitel III - Konfiguration des BillSAFE Moduls
Alle relevanten Einstellungen können direkt im Magento Backend unter:
System->Konfiguration->Verkäufe->Zahlungsarten->BillSAFE vorgenommen werden.
Option
Aktiv
Testmodus
Titel
Status einer neuen
Bestellung
Verkäufer ID
Lizenzschlüssel
Public Key
Zahlartenlogo URL
Händlerlogo-URL
Onsite Checkout
aktivieren
Mindestbestellwert
Maximalbestellwert
5
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 "Händler- ID"
Der eindeutige von BillSAFE an Sie übergebene Lizenzschlüssel.
Dieser Schlüssel wird für die Verwendung des Onsite Checkouts
benötigt. Zu finden ist der Public Key im Händlerportal.
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.
Wenn „Ja“ ausgewählt ist, entfällt der Redirect zum Gateway. Die
Bonitätsprüfung erfolgt im Hintergrund des Webshops, während des
Checkoutprozesses. (freischaltungspflichtig)
Ab welchem Warenkorbwert soll BillSAFE verfügbar sein.
Bis zu welchem Warenkorbwert soll BillSAFE verfügbar sein. Bitte
beachten: Der maximale Warenkorbwert muss mit BillSAFE
vereinbart werden.
Option
Zahlartenaufschlag
Produkt SKU
Zahlungsart
deaktivieren
Maximal-/
StandardAufschlag
Minimaler
Zahlartenaufschlag
Prozentualer
Zahlartenaufschlag
Reihenfolge
Fehler
Protokollierung
aktivieren
Länder in denen
BillSAFE zur
Auswahl steht
6
Beschreibung
Nur wenn dieser Wert auf "Ja" gesetzt ist, wird der
Zahlartenaufschlag aktiviert. Siehe dazu Kapitel IV. (Dieses Feature
ist freischaltungspflichtig!)
Geben Sie hier die SKU des Produktes an, welches für den
Zahlungsartenaufschlag verwendet werden soll. Siehe dazu Kap. IV.
Wenn diese Option aktiviert ist, steht BillSAFE nicht zur Auswahl,
falls der Warenkorbwert (inkl. Versand, ohne Zahlartenaufschlag),
die festgelegte Obergrenze übersteigt.
Maximal- und zugleich Standardwert für den Zahlartenaufschlag.
Dieser Wert sollte den in der BillSAFE-Konfiguration eingestellten
Wert nicht überschreiten, andernfalls erhält man eine
Fehlermeldung. Wird der Wert in der BillSAFE-Konfiguration
geändert, so muss die Konfiguration der Zahlungsart im Magento neu
gespeichert werden, damit der Abgleich der Werte erfolgt.
Minimaler Wert für den Zahlartenaufschlag. Muss nur eingestellt
werden, wenn ein prozentualer Zahlartenaufschlag angegeben
wurde.
Prozent vom Warenwert zzgl. Versand. Wird dieses Feld leer
gelassen, so gilt der Maximal-/Standard-Aufschlag für jede Zahlung
mit BillSAFE.
Die Stelle in der Liste möglicher Zahlungsmethoden im Checkout auf
dem diese Zahlart auf der Auswahlseite erscheint. Je kleiner die
Zahl, desto weiter oben erscheint diese.
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/logVerzeichnis der Magento-Installation. Diese Einstellung sollte genau
wie der Testmodus nur zu Test- und Debug-Zwecken, sowie während
der Entwicklung, aktiviert werden.
Momentan ist BillSAFE nur in Deutschland und Österreich verfügbar.
Kapitel IV - 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
von 0€, einen Bestand, die Steuerklasse und natürlich die in der BillSAFEKonfiguration angegebene SKU zu. Dieses Produkt muss aktiv sein, aber nicht
individuell sichtbar.
7
Der Preis wird während des Checkouts angepasst, sollte sich jedoch trotzdem
zwischen dem eingestellten Minimal- und Maximalbetrag des
Zahlartenaufschlages bewegen.
Das Produkt muss in allen Websites, die BillSAFE verwenden, aktiv sein.
Der Name des Produktes wird für den Kunden sichtbar sein.
Um sicherzustellen, dass Warenkorbpreisregeln in Magento nicht für das Zahlungsartenaufschlag-Produkt gelten, sollte die SKU des
Zahlungsartenaufschlag-Produktes in den entsprechenden Warenkorbpreisregeln von der Berechnung ausgeschlossen werden.
Dies kann unter dem Reiter "Aktionen" einer Warenkorbpreisregel im Bereich 'Regel nur auf Artikel mit folgenden Bedingungen im Warenkorb
anwenden (Leer lassen für alle Artikel)' eingestellt werden.
Beim Speichern der BillSAFE-Konfiguration im Magento-Backend werden die Eingaben zum maximalen Rechnungsbetrag und zum maximalen
Zahlungsartenaufschlag mittels einer Schnittstellenanfrage bei BillSAFE überprüft. Bei einer Überschreitung des eingegebenen Betrages in Magento
gegenüber den bei BillSAFE hinterlegten Daten erfolgt eine Fehlermeldung. Bei der ersten Eingabe der Daten nach der Installation werden die
maximalen Beträge noch nicht geprüft, da in dem Moment die Schnittstellen-Informationen noch nicht vorliegen.
Wichtig! Löschen Sie abschließend bitte den Magento Cache.
Wichtig! Dieses Feature ist freischaltungspflichtig
8
Kapitel V – Bestellprozess
BillSAFE bietet aktuell den Standard Checkout mit Redirect zum BillSAFE Gateway an (empfohlen bei B2B Shops) und den Onsite Checkout, wo die
Bestellung direkt auf der Checkout Seite abgeschlossen wird.
Wichtig! Der Onsite Checkout muss durch den BillSAFE Supportfreigeschaltet werden. Dazu reicht es, eine kurze E-Mail an [email protected] zu
schicken.
Zur Nutzung von BillSAFE muss der Kunde während des Checkouts die Zahlungsart BillSAFE auswählen:
Ansicht mit aktiviertem Onsite Checkout
9
In der Artikelliste wird vor dem Bestellabschluss gegebenenfalls auch der Zahlungsartenaufschlag aufgeführt.
Artikelliste mit Zahlungsartenaufschlag
Ist der Onsite Checkout nicht aktiv, würde der Kunde nach dem Bestätigen der Bestellung zu BillSAFE weitergeleitet werden, um die
Zahlungsmodalitäten zu bestätigen und ggf. Kundendaten zu ergänzen.
10
Kapitel VI - 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').
Für Bestellungen, die ein Bundle Product enthalten, steht BillSAFE nicht als Zahlungsart zur Verfügung.
a) Versand melden (Komplett- + Teilversand)
Sind alle Bestellpositionen versandbereit, können Sie die Sendung über den Button 'Senden' anlegen. 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.
Alternativ zu dem Button 'Senden' können Sie die Artikel auch bei der Rechnungsstellung mittels der Checkbox "Versand starten" versenden. Weitere
Informationen dazu finden Sie im Kapitel Rechnungsstellung.
11
b) Rechnungsstellung
Bei der Erstellung einer Rechnung erscheint ggf. eine Warnung, dass die versandten Artikel nicht mit den berechneten übereinstimmen, falls die
Rechnung für Artikel erstellt wird, die nicht versandt wurden. Dies ist unter anderem beim Zahlungsartenaufschlag der Fall, der naturgemäß nicht
versendet werden kann.
Warnung bei der Inrechnungstellung nicht versandter Artikel
Um die Menge der in Rechnung zu stellenden Artikel anzupassen ist es wichtig, nach Änderung der Werte in der Spalte "Zu berechnende Menge" den
Button "Mengen aktualisieren" zu betätigen. Andernfalls berücksichtigt Magento Ihre Änderungen nicht.
Der Versand sollte entweder vor oder während (Checkbox "Versand starten") der Rechnungserstellung erfolgen. Damit BillSAFE über die Rechnung
informiert wird, muss "Online erfassen" bei der Erstellung der Rechnung ausgewählt werden:
12
Anschließend können Sie die neu erstellte Rechnung in Magento öffnen und diese über den 'Drucken'-Button ausdrucken, um Sie der Sendung
beizulegen. Diese sollte im Bereich "Zahlungsmethode" die Informationen zur Zahlung an BillSAFE enthalten.
c) Stornierung
Das Storno der kompletten Bestellung kann wie üblich in Magento in der Bestellansicht durch das Betätigen des Buttons "Stornieren"
durchdurchgeführt werden. Die bei BillSAFE registrierte Forderung an den Kunden wird dadurch ebenso komplett storniert.
13
d) Retouren
Retouren, auch Teilretouren, können wie gewohnt an der Rechnung mittels einer Gutschrift durchgeführt werden. Dabei ist es wichtig, zuerst die zur
Bestellung gehörende Rechnung zu öffnen und dann den Button "Gutschrift" zu betätigen. Der Button "Gutschrift" in der Bestellansicht erzeugt eine
Offline-Gutschrift, bei der BillSAFE nicht über die Retoure informiert wird.
Irreführende Nachricht beim Betätigen des "Gutschrift"-Buttons in der Bestellansicht
Klicken Sie korrekterweise auf den "Gutschrift"-Button in der Rechnungsansicht:
Zur Erstellung einer Gutschrift ist der entsprechende Button in der Rechnungsansicht zu betätigen
14
Um die Menge der zu retournierenden Artikel anzupassen ist es analog zur Rechnungsstellung wichtig, nach Änderung der Werte in der Spalte "Menge
zur Erstattung" den Button "Mengen aktualisieren" zu betätigen. Andernfalls berücksichtigt Magento Ihre Änderungen nicht.
Damit BillSAFE über die Gutschrift informiert wird, muss "Erstatten" (nicht "Erstattung (offline)") bei der Erstellung der Gutschrift ausgewählt werden:
Um BillSAFE über die Gutschrift in Kenntnis zu setzen, muss "Erstatten", nicht "Erstattung (offline)" gewählt werden
e) Berichtigungszuschlag
Achtung: Gegenwärtig unterstützt BillSAFE keine Berichtigungszuschläge. Sie können diese jedoch über eine Berichtigungserstattung 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 Berichtigungszuschlag von 3,00 € erhoben. Bei BillSAFE-Bestellungen markieren Sie das Produkt nicht als
retourniert und geben stattdessen eine Berichtigungserstattung in Höhe der Differenz des Warenwerts und der Berichtigungserstattung ein. Im
Beispielfall also 7,00 €.
15
Kapitel VII - 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
49084 Osnabrück
[email protected]
20.12.1987
Tel.: 0123456789
Hinweis: In der Sandbox werden alle Anfragen, die nicht den Testkäuferdaten entsprechen, abgelehnt!
3.
4.
5.
6.
Wählen Sie bitte „BillSAFE“ als Zahlart aus und schließen die Bestellung ab.
Gehen Sie nun bitte in den Administrationsbereich Ihres Shops und rufen die Bestellung über „BillSAFE Details“ auf
Generieren Sie bitte eine Rechnung aus Ihrem Shop und überprüfen Sie ob die BillSAFE Details dort zu sehen sind.
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!
16