Modul Anleitung

PhPepperShop Klarna Modul
Datum: 27. Juli 2016
Version: 2.2
PhPepperShop Klarna Modul
Anleitung
Glarotech GmbH
Inhaltsverzeichnis
1. Einleitung.....................................................................................................................................................3
2. Installation...................................................................................................................................................4
2.1 Systemanforderungen / Umgebung..............................................................................................4
2.2 Dateien kopieren und hochladen..................................................................................................4
2.3 Dateizugriffsrechte anpassen.........................................................................................................4
2.4 Modulinstallation............................................................................................................................4
2.5 Log-Viewer Installation...................................................................................................................5
2.6 Optional: PDF Druck Modul............................................................................................................5
3. Einbindung ins Shopsystem.......................................................................................................................5
4. Konfiguration des Moduls und des Shops.................................................................................................5
4.1 Klarna-Modul Konfiguration...........................................................................................................5
4.2 Konfigurationseinstellungen..........................................................................................................6
4.3 Bezahlungsarten Konfiguration.....................................................................................................8
4.4 Allgemeine Geschäftsbedingungen / rechtliche Anforderungen.................................................8
5. Verarbeitungsprozess und Transaktionsidentifikation.............................................................................8
6. Storno.........................................................................................................................................................10
7. Eine neue Klarna Bezahlungsart einführen.............................................................................................11
8. Advanced: Name der angezeigten Bezahlungsart in der Kasse ändern................................................11
9. Infos zu abweichenden Lieferadressen....................................................................................................11
10. Online Hilfe..............................................................................................................................................11
11. Bedienung................................................................................................................................................11
11.1 Kundenseitig...............................................................................................................................11
11.2 Shop-Administration...................................................................................................................12
Bestellungsverarbeitung..........................................................................................................12
Auswertung der Klarna Kommunikation via Logs..................................................................13
12. Designelemente und Kommunikation...................................................................................................13
12.1 Ratenkauf Infoanzeige................................................................................................................13
12.2 Klarna Logoanzeige.....................................................................................................................13
12.3 Anzeige in der Webshop Kasse / Bezahlungsart Reihenfolge..................................................14
13. Fehlercodes und Ressourcen..................................................................................................................15
14. Offene Fragen?.........................................................................................................................................15
15. Anhang.....................................................................................................................................................15
15.1 Fehlermeldungen der Klarna-Modul Konfigurationsmaske erklärt........................................15
15.2 Betriebseinschränkungen..........................................................................................................16
15.3 Klarna Zahlungsgarantie Hinweis..............................................................................................17
15.4 Troubleshooting und oft gestellte Fragen (FAQ).......................................................................17
15.5 Einschränkung der Klarna Bezahlungsart Anzeige durch setzen eines Maximalbetrags.......18
15.6 Bezahlungsart Rechnung ohne Klarna Verarbeitung anbieten...............................................19
16. PhPepperShop Klarna Icon Paket für alle Sprachen.............................................................................19
17. Aktivierungs CSV-File...............................................................................................................................20
18. Ablauf bei abgelehnter Pending Reservation........................................................................................20
19. Technische Versionsanforderungen.......................................................................................................20
20. Aufschaltungsvorgang bei Klarna...........................................................................................................20
21. Beispiel Screenshots der Kundenseitigen Anzeige...............................................................................20
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 2 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
1. Einleitung
Der Rechnungskauf ist bei Onlineshoppern die beliebteste Bezahlungsart und mit Ratenzahlungen bieten
Sie Ihren Kunden die gewünschte Flexibilität beim Zahlen. In jeder Sekunde kauft jemand etwas mit Klarna™.
Steigern Sie Ihren Umsatz – ohne Risiko
Klarna bietet die sichersten und einfachsten Zahlungsarten im Onlinehandel: Verkaufen auch Sie auf
Rechnung oder per Ratenkauf. Mit Klarna verringern Sie Kaufabbrüche und erhöhen die Konversionsrate
in Ihrem Shop. Das führt zu einer Steigerung der Umsätze. Klarna trägt ausserdem sämtliche Risiken, das
heisst, Sie werden immer bezahlt.
Die sichersten und einfachsten Lösungen
Mit Klarna erhalten Ihre Kunden ihre Ware immer vor der Bezahlung, und Sie erhalten immer Ihr Geld, unabhängig ob der Kunde sich für den Rechnungs- oder Ratenkauf entschieden hat. Sie entscheiden selbst,
ob Sie einen oder mehrere unserer Services anbieten, um den Bedürfnissen Ihrer Kunden zu entsprechen
und Ihre Umsätze optimal zu steigern.
Einfacher Einstieg
Tausende von Onlineshops haben bereits mit Klarna ihre Umsätze gesteigert. Der Einstieg war noch nie
leichter – für Ihren PhPepperShop gibt es die optimale Integration in Form dieses Moduls. Mit dem neuen
Klarna Backoffice minimieren Sie zudem Ihren Verwaltungsaufwand.
Rechnung
Der Klassiker für einfaches und sicheres Bezahlen. Wenn Ihre Kunden
auf Rechnung einkaufen, wird ihnen die Ware immer geliefert, bevor
Sie sie bezahlen. So muss niemand für falsche oder ausgebliebene
Lieferungen bezahlen, was Sicherheit bietet und die Konversionsrate
verbessert. Ausserdem zahlen Ihre Kunden den ganzen Betrag in einem, damit die Zahlung aus der Welt ist.
Ratenkauf
Bei Klarna Ratenkauf werden alle während eines Monats getätigten Einkäufe
eines Kunden auf einer Rechnung gesammelt, die ihm oder ihr am Ende des
darauf folgenden Monats zugesandt wird. Eine monatliche Sammelrechnung ist übersichtlich und bequem, so dass Ihr Kunde alles zusammen zahlen kann. Und ausserdem muss man nur einmal eine Ratenkaufgebühr von €
1,95 zahlen. Wenn Ihr Kunde möchte, lässt sich jederzeit der ganze Rechnungsbetrag auf einmal einzahlen.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 3 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
2. Installation
2.1 Systemanforderungen / Umgebung
Um das Klarna Modul einsetzen zu können, ist ein PhPepperShop v.5.0 Professional oder Enterprise ab
dem Build 39 erforderlich1. Dieses Modul ist optional und ist nicht Bestandteil des Standard Lieferumfangs. Bitte beachten Sie, dass Klarna momentan ausschliesslich in folgenden Ländern verfügbar ist:
Deutschland, Österreich, Holland, Dänemark, Norwegen, Finnland und Schweden.
2.2 Dateien kopieren und hochladen
Das Klarna Modul besteht im Wesentlichen aus vier Dateien, die man in seinen installierten PhPepperShop kopieren muss. Dazu entpackt man zuerst das mitgelieferte ZIP-Archiv. Es sind folgende Dateien
enthalten, hier mit den Zielverzeichnissen dargestellt:
{shopdir}/shop/klarna_payment.def.php
{shopdir}/shop/module/klarna_payment
{shopdir}/shop/Admin/module/klarna_payment
| Datei
| Verzeichnis
| Verzeichnis
Die Dateien lassen sich einfach via (S)FTP oder SCP zum Webserver hochladen. Der Platzhalter {shopdir} steht dabei für das Shopverzeichnis auf dem Webserver, wo die Datei index.php zusammen mit
der Datei README.txt zu finden ist.
2.3 Dateizugriffsrechte anpassen
Das Klarna Modul arbeitet mit temporären Daten (Pclass Storage). Damit der Shop damit arbeiten kann,
müssen unter Umständen noch Verzeichniszugriffsrechte angepasst werden. Wenn auf Ihrem Webserver
PHP als Webservermodul läuft und der Server ein UNIX/Linux System ist (und nur dann), müssen folgende
Zugriffsrechte angepasst werden (z.B. via FTP oder SSH):
{shopdir}/shop/Admin/module/klarna_payment/temp
| Verzeichnis
= 777
2.4 Modulinstallation
Abbildung 1: Anzeige der vorhandenen Module im PhPepperShop (Anzeige kann in Ihrem Shop unterschiedlich sein)
1 Zusätzlich zu den PhPepperShop Systemanfordernugen wird PHP mit cURL-Support benötigt.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 4 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
Nach dem Kopieren der Dateien kann man in die Shop-Administration gehen und dort ins Menü 'Module'
 'Modulverwaltung' wechseln. Dort sieht man die Anzeige der Abbildung 1 mit den Modulen und deren
Installationsstatus.
Hier markieren wir im linken Fenster 'Klarna' und bestätigten mit dem Button 'Installieren'. Wir bestätigen
den Verlauf der Installation mit Klick auf den Button 'Zurück' zur Modulverwaltung. Das Modul wird jetzt
auf der rechten Seite 'Bereits installierte Module' gelistet.
2.5 Log-Viewer Installation
Bevor wir jetzt die Klarna Funktionalität benutzen, müssen wir noch das immer mitgelieferte PhPepperShop Modul 'Log-Viewer' installieren (falls das nicht schon gemacht worden ist), da dies vom Klarna-Modul benutzt wird. Wir klicken nun wieder auf den Button, der mit 'PhPepperShop Modulverwaltung' betitelt ist und führen die Installation analog zum Klarna Modul durch.
Nach der Installation des Log-Viewers erscheint dieser nun ebenfalls im rechten Fenster.
 Info: Das Klarna-Modul verwendet rotierende Logdateien. Die Logdateien enthalten im Dateinamen zuerst das Datum des aktuellen Tages. Damit alte Logdateien entfernt werden, sollte der Aufräumprozess
“Shop Optimierung“ als Cron Job / geplanter Task eingerichtet sein. Falls das noch nicht mit der Shop-Installation eingerichtet worden ist. Wie man das macht, sehen Sie in der Shop-Administration, im Menü
'Shop-Einstellungen'  'Shop-Konfiguration'  'Operationen' ganz unten bei den Links 'Shop Optimierung' (Bei UNIX/Linux Systemen z.B. ein wöchentlicher Cron Job in der Nacht mit wget auf den unter 'Direktlink' angegebenen Wert eingerichtet werden).
2.6 Optional: PDF Druck Modul
Das Klarna Modul arbeitet auch mit dem optional zum PhPepperShop erhältlichen Modul zum PDF-Rechnungs- und Lieferscheindruck zusammen. Falls dieses Modul bereits installiert ist, muss vorderhand
nichts daran geändert werden. Falls Sie es gleichzeitig mit dem Klarna Modul erworben haben, können
Sie es jetzt gleich wie das Klarna Modul und das Log-Viewer Modul installieren. Damit das PDF Druck Modul eingesetzt werden kann, müssen gegebenenfalls noch einige Konfigurationsschritte getätigt werden.
Bitte prüfen Sie in der Modulanleitung für das PDF Druck Modul nach, dass alle Schritte korrekt umgesetzt worden sind.
3. Einbindung ins Shopsystem
Das Klarna Modul verwendet das PhPepperShop Payment Interface v.2 um die Bezahlungsarten Klarna
Rechnung, Klarna Ratenkauf und alle weiteren, dynamisch je nach Länder und Aktionszeitraum verfügbaren Klarna Bezahlungsarten anzuzeigen. Diese Zahlarten werden dynamisch als elektronische Bezahlungsarten eingelesen und erstellt. Sie verwenden als Handler Kennung 'Klarna'.
4. Konfiguration des Moduls und des Shops
4.1 Klarna-Modul Konfiguration
Bitte an folgenden Ort gehen: 'Shop-Administration'  'Module'
 Klarna:
Abbildung 2: PhPepperShop Module
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
Die zentrale Konfigurationsmaske des Klarna-Moduls sieht wie
folgt aus:
http://www.glarotech.ch
[email protected]
Seite 5 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
Abbildung 3: Klarna-Modul Verwaltungsmaske (kann unterschiedlich aussehen)
 Info: Fehler- und Infomeldungen dieser Maske sind im Kapitel “Anhang“ ausführlich beschrieben.
4.2 Konfigurationseinstellungen
• Aktivierung: Hier aktiviert oder deaktiviert man das Modul. Wenn das Modul deaktiviert ist, kann niemand mehr über die Klarna-Zahlarten im Shop bezahlen. Dies betrifft alle belieferten Länder des
Shops.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 6 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
• Merchant IDs (Continental / Nordic): Identifiziert den Händler (Shopbetreiber), wird von Klarna vergeben, wird auch eStoreID oder eID genannt. Es gibt je für die Länder DE, AT und NL eine Merchant ID und
für die nordischen Länder (DK, NO, SE, FI) eine weitere Merchant ID. Hinweis: Nicht produktive Testsys teme können als Ausnahme auch alle Länder mit nur einer Merchant ID steuern.
• Shared Secrets (Continental / Nordic): Funktioniert wie ein Passwort, wird von Klarna vergeben. Es
gibt je für die Länder DE, AT und NL einen eigenen Wert (Continental) und für die nordischen Länder
(DK, NO, SE, FI) einen zweiten Wert (Nordic).
• Zahlungsfrist: Wann beginnt der Ablauf der Zahlungsfrist nach Aktivierung der Rechnung (mit Klarna
verhandelbar). Hier wählt man entweder KLARNA EXPRESS SHIPMENT oder KLARNA NORMAL SHIPMENT. Je nach gewähltem Wert, wird der bei Klarna hinterlegte Zeitraum angewendet.
• Monatsraten Anzeige: Hier steuert man gesondert für einige Bereiche im Shop, ob die berechnete Monatsrate an diesem Ort angezeigt werden soll. Es wird jeweils die günstigste Variante angezeigt:
• Warenkorb: Soll im Warenkorb, unter dem Total eine Infoanzeige eingeblendet werden, wie diese
Bestellung mit einem Ratenkauf finanziert werden könnte?
• Artikel Detailanzeige: Soll in der Detaildarstellung eines Artikels eine Ratenkauf Infoanzeige eingeblendet werden? Wenn ja, wird die Klarna Infomeldung bei allen Standard PhPepperShop Artikeln
mit Preis grösser als 0.00 und bei allen Parent- / Subartikeln mit aktiver Dropdown-Anzeige eingeblendet. Info: Parent- / Subartikel mit Listenanzeige erhalten keine Klarna Infomeldung, da dort zu
jedem Subartikel eine entsprechende Info benötigt wird und dafür meist kein Platz vorhanden ist.
Falls in der Datei {shop_verzeichnis}/config.inc.php die Steuerungskonstante SHOW_VARIATIONSARTIKEL_INFOS_AUF_1_STUFE auf true gesetzt wird, zeigt dieses Modul die Klarna Ratenkaufinfos auch für Artikel mit Varianten an, welche als Variationspreis den gesamten Artikelpreis enthal ten und der Artikel selbst einen Preis von 0.00 hat.
• Artikelliste: Wenn in Ihrem Shop die zweistufige Artikeldarstellung aktiviert ist ( default) und eine
mehrspaltige Artikellistenanzeige verwendet wird ( default): Sollen in der Artikelübersicht einer
Kategorie bereits Klarna Ratenkauf Finanzierungspreise angezeigt werden? Wenn ja, sollte in Layout
Einstellungen  Layout-Management  Artikelbox der Wert für 'Preisanzeige Höhe' entsprechend
angepasst werden, empfohlen sind 45 - 65px als Höhe.
• Betrieb: Hier stellt man ein, ob die Anbindung an Klarna lediglich zum Testen verwendet wird (KEINE
REALEN FINANZTRANSAKTIONEN!), oder ob der Produktivbetrieb aktiviert werden soll.
• Rechnungsversand: Wie soll der Kunde die Rechnung erhalten: Soll Klarna ein E-Mail oder einen Brief 2
mit der Rechnung an den Kunden senden? Oder druckten Sie als Shopbetreiber die Klarna PDF-Rechnung aus und legt diese gleich Ihrer Lieferung an den Kunden bei ( manueller Rechnungsversand).
Info: Wenn Klarna die Rechnung versenden soll, geschieht dies jeweils direkt nach dem erfolgreichen
Aktivierungscall (Bestellstatusänderung auf 'Bestellung versendet' mit Bestellungsstatus = 0020).
• Klarna PClasses: Dies sind die dynamischen Bezahlungsarten, welche im Klarna Backoffice konfiguriert worden sind. Mit dem Button 'Klarna PClasses aktualisieren' wird die neuste Konfiguration live
eingelesen und aktiviert. Achtung: Ihr PhPepperShop liest dabei nur die PClasses derer Länder aus,
welche zuvor in Shop-Einstellungen  Lieferländer und Versandarten als aktive Lieferländer konfiguriert worden sind. Deshalb kann sich die Anzeige der Modulkonfiguration bei den PClasses durchaus
von der aus Abbildung 3 unterscheiden. Diese Klarna Bezahlungsarten lassen sich danach in den Allgemeinen Einstellungen auch noch anpassen (Details dazu, siehe folgendes Kapitel). Beim Aktualisieren
2 Der Rechnungsversand per Brief ist kostenpflichtig.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 7 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
der PClasses werden aber zur Sicherheit jeweils alle relevanten Daten neu ausgelesen und überschrei ben so selbst getätigte Bezahlungsart-Einstellungen.
Info: Nicht im Vertrag aufgeschaltete Länder, retournieren Code 9120: invalid_country, was ok ist.
4.3 Bezahlungsarten Konfiguration
Nachdem das Modul konfiguriert worden ist und die Klarna PClasses ausgelesen worden sind, stehen die
entsprechenden Bezahlungsarten zur Verfügung.
Die Steuerung der Verfügbarkeit (Aktivierung der PClass Klarna Bezahlungsart) erfolgt im Menü Shop-Einstellungen  Allgemeine Einstellungen  Bezahlungsarten. Dort muss ein Häkchen bei 'elektronische Bezahlungsarten / Kreditkarten' gesetzt sein und in der Auflistung neben dran kann man in der Spalte 'aktiv'
die Aktivierung der jeweiligen PClass Klarna Bezahlungsart gesondert steuern. Dort ist auch die Länderund Währungseinschränkung definiert. Bitte stellen Sie sicher, dass die Klarna Bezahlungsarten nicht im
Kreditkarten Dropdown angezeigt werden, dort gehören sie nicht hin.
Info: Wenn man manuell eine Bezahlungsart als deaktiviert markiert, behält der Shop diese Einstellung
auch nach einer neuen PClass Aktualisierung.
Nach der Aktivierung und Konfiguration der elektronischen Bezahlungsarten muss man nun bei ShopEinstellungen  Lieferländer und Versandarten prüfen, dass in allen relevanten Ländergruppen die Bezahlungsart 'Kreditkarte' für die entsprechenden Betragsintervalle aktiviert worden ist (Kreditkarte steht
hier stellvertretend für alle angebotenen elektronischen Bezahlungsarten).
4.4 Allgemeine Geschäftsbedingungen / rechtliche Anforderungen
Bitte erfüllen Sie die auf der folgenden Webseite angegebenen, rechtlichen Anforderungen. Die Einblendung einer Einverständniserklärung wird durch dieses Modul umgesetzt, ebenso die für Holland geforderte Anzeige der Ratenkauf-Infografik und Infoanzeige gemäss Norwegischer Gesetzgebung. Ihre AGB
sollten Sie beim Verkauf aber noch entsprechend ergänzen: Rechnung nach Deutschland, Ratenkauf nach
Deutschland, Rechnungsverkauf in Österreich.
• Einsprachige Shops / Default-Sprache: Shop-Administration Shop-Einstellungen  Allgemeine Einstellungen  Kundeninfos / Widerruf / AGB
• Mehrsprachige Shops / Fremdsprachen: Shop-Administration  Sprachen  AGBs, Kundeninformationen, Bestellungsabschluss und Email bearbeiten
5. Verarbeitungsprozess und Transaktionsidentifikation
Bei einer Bestellung mit Bezahlung via Klarna wird im Kundenmanagement zu jeder Klarna Bestellung
eine Klarna bezogene Informationen angezeigt: Die Transaktions-ID.
• Transaktions-ID: Identifiziert die Reservation (RNO)
• Detaildarstellung: Hier findet man zu jedem an Klarna abgesetzten Aufruf eine detaillierte Anzeige (reserveAmount, activate, cancelReservation, creditInvoice, send[Email]Invoice, checkOrderStatus,..).
• Klarna PClasses: Klarna PClasses beschreiben die definierten Bezahlungsweisen, mit welchen die monatlichen Kosten auf der Produktseite und an der Kasse dargestellt werden.
Wenn jemand in Ihrem Shop eine Bestellung aufgibt und per Klarna Bezahlungsart bezahlt, erzeugt dies
eine Reservation mit einer Reservationsnummer (RNO) bei Klarna. Ihre Bestellung hat nun den Status
0002 – Bestellung eingegangen) oder, in ganz seltenen Fällen, wenn die Bestellung durch Klarna MitarbeiGlarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 8 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
tende noch manuell überprüft werden, max. Für 24h einen noch nicht definierten Zustand (pending).
Während dieser Zeit kann man jeweils nochmals prüfen, ob die Bestellung inzwischen angenommen worden ist ( 0002) oder abgelehnt worden ist (Storno)3. Dieser checkOrderStatus Call wird per Cron-Job
automatisch ausgeführt, oder Sie können dies manuell im Kundenmanagement auslösen, in dem Sie bei
einer Bestellung mit Pending-Meldung den Bestellungsstatus auf 'eingegangen' zu ändern versuchen.
Eine per Klarna zu bezahlende Bestellung, die eingegangen ist kann nun dem Fulfillment übergeben werden und versendet werden. Wenn dies gemacht wurde, ändert man den Bestellstatus auf 0020 (Bestellung versendet). Bei diesem Übergang wird einmalig Klarna kontaktiert und die Reservation wird dort aktiviert. Man erhält nun eine von Klarna vergebene Rechnungsnummer (INVNO) und kann bei installiertem
PDF-Druck Modul auch das Klarna PDF herunterladen und anzeigen / ausdrucken. Beim Versand durch
Klarna (E-Mail oder aufpreispflichtiger, physischer Briefversand) ist dies irrelevant.
Wenn eine ERP-Anbindung verwendet wird und man sich für das Beilegen der PDF-Rechnung entschieden hat, so kann man das vom Shop erstellte Log-File via Log-Viewer verwenden, in welchem der Shop
nach einer Business-Connector / Caller set_liefer_status 'versendet' Verarbeitung angelegt worden ist.
Darin befinden sich im gut verarbeitbaren CSV-Format alle Links zu den PDF-Rechnungen zusammen mit
deren Identifikationsnummern. So kann man im Fulfillment die Klarna Rechnungen ausdrucken und der
jeweiligen Sendung beilegen. Details und File-Struktur, siehe Kapitel 17 im Anhang.
Abbildung 4: Bestellablauf und Bestellstati im PhPepperShop
Bei eingegangenen Bestellungen sieht man die Kommunikation mit Klarna im Kunden-Management,
wenn man sich die Bestellung anzeigen lässt ganz unten. Hier ein Beispiel:
Abbildung 5: Informationen zur Kommunikation mit Klarna (Beispiel einer aktivierten Pending Transaktion)
3 Details, was passiert, wenn eine Pending Reservation abgelehnt wird, siehe Anhang.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 9 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
Wenn man bei den DB-Transaktions Informationen auf den Button 'Details' klickt, sieht man die detaillierte Kommunikation für diesen Klarna Aufruf. Dies ist vor allem dann wertvoll, wenn man bei offenen Fragestellungen Nachforschungen anstellen muss. Auch hier eine Beispielanzeige:
Abbildung 6: Detailanzeige einer Klarna Aktivierung (gesendete Parameter und erhaltenes Resultat)
6. Storno
Wenn eine PhPepperShop Bestellung mit Klarna Reservation im Kunden-Management gelöscht wird, sendet das Klarna Modul einen cancelReservation Call an Klarna ab und gibt den reservierten Betrag auf dem
Konto des Kunden wieder frei. Dies ist sehr wichtig, da sonst nicht mehr benötigte Reservierungen die
noch verfügbare Kreditlimite des Kunden unnötig verringern.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 10 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
Wird eine bereits als versendet markierte Bestellung storniert, sendet das Klarna Modul einen creditInvoice Aufruf an Klarna ab und kommuniziert so die Stornierung der bereits versendeten Rechnung.
7. Eine neue Klarna Bezahlungsart einführen
Wenn Sie im Klarna Backoffice eine neue Bezahlungsart definiert haben (PClass Definition), so wird diese
erst in Ihren Shop übernommen, wenn Sie die PClasses neu einlesen: Shop-Administration  Module 
Klarna  Klick auf Button: 'Klarna PClasses aktualisieren'.
8. Advanced: Name der angezeigten Bezahlungsart in der Kasse ändern
Wenn Klarna benutzt wird, so kann man den Übersetzungstext der Klarna Bezahlungsarten für Rechnung
und Ratenkauf anpassen (zusammen mit anderen Bezahlungsarten Bezeichnungen): Shop-Administration  Shop-Einstellungen  Sprachen  Bezahlungsarten Texte bearbeiten.
Info: Dies ist grundsätzlich nicht nötig und auch nicht empfohlen. Sie sollten eine Änderung zuerst mit Ihrem Klarna Ansprechpartner absprechen.
9. Infos zu abweichenden Lieferadressen
Wenn im Shop abweichende Lieferadressen verwendet werden, zeigt der PhPepperShop wird der Kunde
im Bestellprozess darauf hingewiesen, dass diese Funktionalität aus Betrugspreventionsgründen von
Klarna nicht unterstützt wird.
10. Online Hilfe
Im Klarna-Modul findet man mit Klick auf den Hilfe-Button Zugriff auf die Online-Hilfetexte zu diesem Modul. Die Hilfetexte sind auch über das Hilfearchiv oder über die Hilfethemen vom Shop-Administration
Hauptmenü aus erreichbar. Auch in allen anderen tangierten Administrationsbereichen (Lieferländer und
Versandarten Konfiguration oder Kunden-Management) finden Sie entsprechende Hilfetexte, passend
zum jeweiligen Kontext.
11. Bedienung
11.1 Kundenseitig
1.) Der Kunde betritt den Shop und wählt eine Kategorie oder einen Artikel. Je nach Konfiguration
wird er/sie jetzt schon über die Finanzierungsmöglichkeiten mit Klarna Ratenkauf informiert.
2.) Der Kunde legt sich Artikel in den Warenkorb. Je nach Konfiguration des Moduls wird hier eine Infoanzeige ausgegeben, welche Ratenkauf Finanzierungskonditionen anzeigt.
3.) Er oder sie betritt die Kasse und gibt hier Adressdaten an und wählt eine der verfügbaren Klarna
Bezahlungsarten. Info: Hier läuft schon eine Anzeigeprüfung. Der Kunde muss die korrekte LandSprache-Währung Kombination verwenden, damit die entsprechenden Klarna Bezahlungsarten
angezeigt werden (z.B. Deutschland + Deutsch + Euro oder Schweden + Schwedisch (oder Englisch) + Schwedische Krone, ...).
4.) Optional wird eine Datenvervollständigungsmaske mit Klarna Bestimmungen präsentiert. Z.B.
wird in DE + NL die Hausnummer in einem eigenen Feld erwartet. Hier muss man Daten angeben,
welche für die Reservationsübergabe an Klarna gefordert werden. Diese Daten sind Länder abhängig. Z.B. wird in Deutschland ein Geburtsdatum zwingend angefordert, in den nordischen
Ländern ist dies eher die Sozialversicherungsnummer. Bei Firmenangaben werden wiederum anGlarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 11 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
dere Daten angefragt. Info: Auf dieser Seite werden schon einige Plausibilitätsprüfungen durchgeführt und der Kunde wird auf Fehler hingewiesen (z.B. fünfstellige Postleitzahl in Deutschland),
dies erspart lange Klickwege + Fehlermeldungen.
5.) Nun wird die Bestellübersichtsseite angezeigt und der Kunde kann die Bestellung aufgebgen.
6.) Klarna erhält nun die Reservationsanfrage und führt nun eine Überprüfung des Kunden durch.
7.) a: Ist die Kreditwürdigkeit gewährleistet, wird die Bestellung angenommen und der Kunde sieht
die 'Herzlichen Dank' Meldung - auch in den seltenen Fällen, wo eine Bestellung noch zur manuellen Prüfung unter Vorbehalt übernommen worden ist (Pending).
b: Wenn die Kreditwürdigkeit nicht ok ist oder die Klarna Rahmenbedingungen nicht erfüllt sind
oder es ein Verarbeitungsproblem gibt (kann auch an den übergebenen Daten liegen), wird
dem Kunden eine entsprechende Infomeldung angezeigt und er muss zurück in die Kasse
gehen um eine Korrektur vorzunehmen oder eine andere Bezahlungsart verwenden.
11.2 Shop-Administration
Bestellungsverarbeitung
Wenn eine Bestellung eingegangen ist, welche via Klarna bezahlt werden soll, kann der Händler davon
ausgehen, diesen Betrag zu erhalten. Bei Bestellungen mit dem Status 0002 - 'Bestellung eingegangen'
kann er sofort mit der Weiterverarbeitung der Bestellung beginnen. Wenn die Waren alle vorhanden sind,
kann das Paket gerüstet und frankiert4 werden und die Rechnung der Sendung beigelegt werden. In diesem Fall wird der Bestellungsstatus auf 'versendet' (0020) angepasst.
Man kann den neuen Status im 'Bestellungsstatus' Dropdown wählen, oder auf den 'versenden'-Button
(
) klicken. Immer beim Wechsel auf den Status 'versendet' wird diese Aktion ausgeführt. Enterprise
Shops können hier das Info-CSV mit den PDF-Links auslesen, File-Struktur - siehe Anhang (Kapitel 17).
Abbildung 7: Bestellungsstatus im Kundenmanagement auf 'versendet' anpassen (Dropdown oder Button).
Der Shop sendet dem Kunden nun ein E-Mail mit dem Hinweis, dass seine Bestellung versendet wird. Der
Shop verhindert, dass man in der Administration Bestellungen, welche als Pending markiert sind aktivie ren kann. Dies führt jeweils zu einer checkOrderStatus Prüfung.
 Achtung: Da erst beim Ändern des Bestellungsstatus auf 'versendet' der sogenannte activate Aufruf an
Klarna abgesetzt wird, muss dieser Vorgang auf jeden Fall für jede Klarna Bestellung ausge führt werden. ERP-Systeme liefern dies via set_liefer_status Call an.
4 Info für Händler aus der Schweiz: PhPepperShop bietet eine komplette Webstamp Integration an.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 12 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
 Info: Siehe auch PhPepperShop Anleitung 'Vorgehen nach Erhalt einer Bestellung'.
 Info: Wenn ein Kunde die Bestellung storniert. Löschen Sie bitte unbedingt die Bestellung auch in der
Shop-Administration. Dies informiert Klarna über den Storno der Reservation oder Rechnung und die
Lagerbestände werden wieder frei.
Auswertung der Klarna Kommunikation via Logs
Abbildung 8: Log Viewer Modul auswählen
Der Webshop logged die Aufrufe inkl. erhaltener Resultate an
Klarna. Somit sollten zu jeder Problem- oder Fragestellung
die relevanten Daten vorhanden sein um den Ursprung zu
finden (meist für eine Ablehnung im Bestellprozess). Die Logs
findet man wie folgt: Shop-Administration  Module  Log
Viewer (siehe Bild).
12. Designelemente und Kommunikation
12.1 Ratenkauf Infoanzeige
Die Klarna Excellence Umsetzung dieses Moduls beinhaltet die Ratenkauf Infomeldungen in Artikelliste,
Artikel Detailanzeige und Warenkorb. Diese Anzeige kann Template basiert angepasst werden. Dazu werden HTML und CSS Kenntnisse benötigt:
• HTML-Template: {shop_verzeichnis}/shop/language/html_templates/ratenzahlung.
tpl.html (bitte nicht die Cache-Dateie bin_tpl_ratenzahlung.tpl.html bearbeiten!)
• CSS-Template: {shop_verzeichnis}/shop/Admin/csstemplate.txt (wird nach Speichern
des Layout-Managements übernommen und in der Datei {shop_verzeichnis}/shop/shopsty
les.css gespeichert.
Optional kann man das Klarna Modul für Ihren PhPepperShop auch so umkonfigurieren, dass die Anzeige
im Warenkorb alle verfügbaren Ratenkauf Bezahlungsmöglichkeiten gleichzeiteig (untereinander) anzeigt. Dazu sind PHP-Kenntnisse erforderlich:
Öffnen Sie die Datei {shop_verzeichnis}/shop/klarna_payment.def.php in einem geeigneten
Editor, welcher UNIX-Zeilenumbrüche und UTF-8 encodierte Dateien untersützt und suchen Sie die statische Methode get_ratenzahlung_data. Dies ekann wie folgt angepasst werden:
static public function get_ratenzahlung_data($ort,$param=array()){
// Steuerung, ob im Warenkorb alle verfuegbaren PClass-Bezahlungsarten angezeigt werden sollen?
$beim_warenkorb_alle_pclasses_rendern = true;
12.2 Klarna Logoanzeige
Der PhPepperShop verfügt über einfach anzuzeigende Infoboxen, welche man als Shopbetreiber nach eigenen Anforderungen bestücken und anzeigen kann. Klarna empfiehlt schon auf der Startseite auf die
Möglichkeit der Bezahlung per Rechnung und Ratenkauf via Klarna hinzuweisen. Als Basis für die Grafiken
sollten die von Klarna hierfür zur Verfügung gestellten Bilder verwendet werden:
• Klarna Logos / Bezahlungsarten Infos: https://developers.klarna.com/en/de+php/kco-v2/logos
(inkl. zu verwendender Mustertexte für die Beschreibung der Bezahlungsart)
• Klarna Tooltip (siehe hierzu auch Kapitel 16): https://klarna.com/campaign/tooltip/?lang=german
Es gibt es zwei einfach Wege dies in Ihrem Shop einfach umzusetzen:
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 13 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
a) Startseite: Shop-Administration  Eigene Inhalte  Inhalte bearbeiten  'Startseite' wählen  Cursor unter den Text setzen (1) und oben in der Symbolleiste das Icon für 'Bild einfügen' wählen (2):
Bild einfügen Dialog:
Nach dem Klick auf das Icon zeigt
der Shop Ihnen nebenstehendes Bild.
Im Bild einfügen Dialog bei Link den
von Klarna angegebenen Link angeben und bei der Beschreibung einen
aussagekräftigen Test definieren.
b) Infobox: Im Gegensatz zur Startseite sind Infoboxen auf der Seite angeordnet und immer sichtbar.
Falls man die Klarna Bezahlungsarten Infos dort einfügen möchte, kann man das auch in einer der vier
zur Verfügung gestellten Emotionsboxen tun. Der Einfüge Mechanismus ist derselbe wie bei der Startseite beschrieben. Lediglich die Auswahl der zu Bearbeitenden Seite ist anders: Shop-Administration
 Eigene Inhalte  Inhalte bearbeiten  'Emotionsbox 1 oder 2 oder 3 oder 4' wählen.
Nachdem die Emotionsbox bearbeitet worden ist, muss noch die Anzeigesteuerung für die Box im Layout-Management konfiguriert werden: Shop-Administration  Layout-Einstellungen  Layout-Management  Elemente  Hier bei Ihrer 'Emotionsbox X' wählen, ob die Anzeige links oder rechts erfolgen
soll und mit Klick auf den Button 'Speichern' bestätigen.
12.3 Anzeige in der Webshop Kasse / Bezahlungsart Reihenfolge
Die Anzeige der zur Verfügung stehenden Bezahlungsarten inkl. Logo wird durch das Shopsystem gesteuert und kann nicht verändert werden. Ihr PhPepperShop sorgt für eine homogene Anzeige aller zur Verfü gung stehenden Bezahlungsarten.
Was Sie aber beeinflussen können ist die Reihenfolge der Bezahlungsarten. Es ist zu empfehlen, dass man
die lukrativen Bezahlungsarten von Klarna weit oben platziert: Shop-Administration  Shop-Einstellungen  Allgemeine Einstellungen  Bezahlungsarten  Reihenfolge der Bezahlungsarten: Auf 'Reihenfolge ändern' Button klicken. Bitte beachten Sie, dass für Klarna Bezahlungsarten Einschränkungen pro Lieferland und Währung angewendet werden.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 14 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
13. Fehlercodes und Ressourcen
• Fehlercodes der Klarna API anzeigen (Länderspezifisch): Link5
• Benutzerhandbuch: Benutzerhandbuch ansehen
14. Offene Fragen?
Eventuell ist Ihre Frage schon beantwortet? Prüfen Sie zuerst im Anhang das Kapitel 15.4 Troubleshooting
und oft gestellte Fragen (FAQ).
Bitte stellen Sie sich zuerst die Frage, welcher Partner (PhPepperShop oder Klarna) Ihre Frage am besten
beantworten könnte und wenden Sie sich an ihn. Für PhPepperShop bezogene Fragen steht Ihnen das
Kundenforum mit schnellen und kompetenten Antworten 24h am Tag zur Seite:
http://www.phpeppershop.com/, Klarna Kontaktdaten finden Sie auf http://www.klarna.de.
15. Anhang
15.1 Fehlermeldungen der Klarna-Modul Konfigurationsmaske erklärt
Abbildung 9: Beispiel Infomeldungen der Klarna Modulmaske
Erklärungen zum obigen Screenshot.
1.) Monatsraten Anzeige: Preisanzeige Höhe Infomeldung: Hier meldet das Klarna Modul, dass die
Anzeigehöhe der mehrspaltigen Artikellistenanzeige noch nicht optimal ist. Wenn nicht nach Holland verkauft wird, sollte ein Wert von ca. 45px gut reichen. Sollte man auch nach Holland verkaufen, muss zusätzlicher Platz für die folgende Infografik eingerechnet werden und man sollte
etwas wie 65px verwenden. Diese Einstellungen werden im Layout-Management vorgenommen
(Reiter: Artikelbox).
2.) Wenn das Modul im Testbetrieb konfiguriert ist, werden keine realen Finanztransaktionen getätigt
- also keine realen Bonitätsprüfungen und Reservationen oder Aktivierungen. Das Klarna Modul
stellt diese Infoanzeige deshalb in der Warnfarbe der PhPepperShop-Administration dar.
3.) Verzeichnis nicht beschreibbar Fehlermeldung bei Klarna PClasses: In obigem Screenshot sieht
man die rot markierte Fehlermeldung, dass das Klarna Modul keine PClass Daten von Klarna abspeichern kann. Dies ist so, weil hier z.B. PHP als Webserver Modul auf einem unixoiden Betriebssystem verwendet wird und das Verzeichnis nicht die richtigen Schreibrechte besitzt.
5 Fehler 9120 – invalid_country (ungültiges Land), siehe auch Listenpunkt 'Klarna PClasses' auf Seite 7/8.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 15 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
15.2 Betriebseinschränkungen
• Das Klarna-Modul liest aus der Anrede eines Kunden dessen Geschlecht aus. Anreden wie Firma oder
Familie dürfen nicht verwendet werden. Dies wird im Shop standardmässig auch so gehandhabt.
• Klarna und das PhPepperShop Klarna Modul unterstützt nur ganz spezifische Länder + Sprache + Wäh rung Kombinationen (Stand März 2014):
• Deutschland + Deutsch + EUR
• Österreich + Deutsch + EUR
• Holland + Holländisch oder Englisch + EUR
• Dänemark + Dänisch oder Englisch + DKK
• Norwegen + Norwegisch oder Englisch + NOK
• Finnland + Finnisch oder Englisch + EUR
• Schweden + Schwedisch oder Englisch + SEK
• B2B Bestellungen (Firmenbestellungen) werden von Klarna nur für die nordischen Länder unterstützt
(DK, NO, FI, SE). Der Shop übergibt dann als PNO/SSN die UID der Firma.
• Dieses PhPepperShop Modul zur Anbindung von Klarna unterstützt im Moment noch keine Mobile Be zahlungsarten für Schweden. Auch wird die automatische Adressübernahme in Schweden nicht unterstützt.
• Der PhPepperShop versteht sich vor allem als Point of Sale. Umfangreiche Backoffice Operationen werden bewusst weggelassen und an angebundene ERP-Systeme (Warenwirtschaftssoftware) delegiert.
Für den PhPepperShop existieren Anbindungen an viele Systeme u.a. SAP, Microsoft Dynamics NAV,
Sage 200, Sage 50, SQL-Ledger, kivitendo, … . Aus diesem Grund gibt es in der PhPepperShop Administration nur die Möglichkeit der Vollstornierung einer Bestellung und keine Teilstornierung.
• ERP-Anbindungen: Wenn der Shop mit angebundenen ERP-Systemen arbeitet, welches die im Webshop eingegangenen Bestellungen übernimmt und weiter verarbeitet, muss das ERP-System Backoffice Kommunikationscalls mit Klarna selbst tätigen oder es delegiert diese an den Shop zurück. Es geht
spezifisch um folgende beide Requests:
• activate : Aktivierung der Reservation unmittelbar vor/nach dem Versand der Waren. Dieser
Aufruf kann dem Shop per Business-Connector / Caller Aufruf set_liefer_status delegiert
werden.
• cancelReservation oder creditInvoice: Storno einer Bestellung. Dieser Aufruf kann nicht an den
Shop delegiert werden und muss in der Shop-Administration im Kunden-Management vorgenommen werden.
• Das Mobile PhPepperShop Modul bietet keine Datenvervollständigungsmaske im Bestellprozess und
muss deshalb die entsprechenden Kundenattribute für alle Kunden aktivieren.
• Der Shopbetreiber muss sicherstellen, dass die vom Klarna-Modul angelegten Log-Dateien nicht von
unbefugten Personen eingesehen werden können. Im Wesentlichen hat er sicherzustellen, dass der
Schutz der Shop-Administration gewährleistet ist und dass alte Logs immer entfernt werden. Dies sollte grundsätzlich durch das Rotating Log Prinzip gewährleistet werden, die Verantwortung trägt aber
der Shopbetreiber. Die Log-Dateien enthalten sensitive Daten, welche unter den erweiterten Datenschutz fallen.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 16 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
15.3 Klarna Zahlungsgarantie Hinweis
Bitte beachten Sie, dass die Kundendaten (Name, Adresse, u.s.w.) nach dem Bestelleingang nicht mehr
verändert werden dürfen. Der PhPepperShop erlaubt zwar dem Kunden auch nachträglich seine Kundendaten zu editieren, für die Bestellung werden aber immer die Werte übernommen, welche zum Zeitpunkt
der Reservationsanfrage (Bestelleingang) verwendet worden sind.
 Achtung: Beachten Sie deshalb, dass die Ware an den zum Bestellzeitpunkt vereinbarten Kunden mit
den dort angegebenen Daten versendet und verrechnet werden muss. Nachträgliche Änderungen an den Prozessen von Klarna vorbei resultieren im Verlust der Zahlungsgarantie!
15.4 Troubleshooting und oft gestellte Fragen (FAQ)
Frage:
Wie erkenne ich, ob Klarna in einem spezifischen Bestellprozess aktiv ist?
Antwort:
In der Kasse wird mindestens eine Klarna Bezahlungsart angezeigt und diese kann
ausgewählt werden. In Deutschland und Österreich muss der Kunde im Bestellprozess einer Datenschutzerklärung zustimmen, sieht dort also in jedem Fall immer die
Datenvervollständigungsmaske.
Frage:
Die Klarna Bezahlungsart erscheint gar nicht in der Kasse?
Antwort:
Dieses Verhalten kann sehr viele Gründe haben:
• Die Bezahlungsart 'Kreditkarte' wurde in 'Lieferländer und Versandarten' für
das aktuelle Lieferland gar nicht erst aktiviert oder E-Payment ist nicht aktiv.
• Das Klarna Modul ist nicht auf aktiv geschaltet oder weist auf einen Fehler hin.
• Die Kombination aus Land, Sprache und Währung wird von Klarna nicht unterstützt (siehe mögliche Kombinationen im Kapitel 'Betriebseinschränkungen').
• Es wurden einige Limiten-Prüfungen von Klarna verletzt. Z.B. kann man einen
Maximalbestellwert hinterlegen.
Frage:
Wenn der Status der Bestellung auf “versendet“ gewechselt wird, erhält der Kunde
nicht nur ein Infomail über den Versand seiner Bestellung, sondern zusätzlich ein Infomail, dass die Rechnung an Klarna bezahlt werden muss. Was ist der Grund dafür
und kann man das abschalten?
Antwort:
Erst nachdem der Status der Bestellung auf 'versendet' angepasst worden ist, wird
die Betragsreservation zu einer richtigen Zahlung / Rechnung. Falls man im Klarna
Modul eingestellt hat, dass der Rechnungsversand via 'Klarna versendet ein E-Mail'
konfiguriert hat, wird die Rechnung von Klarna direkt per E-Mail an den Kunden gesendet. Verhindern lässt sich dies, in dem eine der beiden anderen Optionen für den
Rechnungsversand verwendet wird.
Frage:
Manchmal, wenn ein Fehler in der Datenvervollständigungsmaske nach der Kasse
auftritt und ich zurück in die Kasse gehe, ist die vorher gewählte Bezahlungsart nicht
mehr aktiviert.
Antwort:
Der Shop löscht die gewählte Bezahlungsart nach der Kasse wieder und behält sich
den zu speichernden Wert im Formular vor, damit man den Sicherheitsmechanismus in einem zweiten Browserfenster nicht umgehen kann, was dazu führt, dass die
Bezahlungsart in der Kasse neu initialisiert werden muss.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 17 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
15.5 Einschränkung der Klarna Bezahlungsart Anzeige durch setzen eines Maximalbetrags
Im PhPepperShop kann man für jede elektronische Bezahlungsart Anzeigebedingungen definieren. Diese
Kriterien enthalten erlaubte Währungen und Länder, sowie Mindest- und Maximalbestellwerte einer Bestellung, die alle erfüllt werden müssen, damit der Shop die Bezahlungsart kundenseitig in der Kasse angezeigt wird.
Die Anzeigekriterien kann man hier anpassen: Shop-Administration  Shop-Einstellungen  Allgemeine
Einstellungen  Bezahlungsarten
In dieser Maske gibt es für jede elektronische Bezahlungsart ein Icon mit, welchem man die Anzeigesteuerungsmaske aufruft:
Abbildung 10: Anzeigebedingungen setzen
 Achtung: Bitte besprechen Sie eine allfällige Maximallimite zuerst mit Ihrem Ansprechpartner bei Klarna.
Wenn dieser Wert (immer in Basiswährung) falsch gesetzt ist, wird dies unter Umständen starke Auswirkungen auf die Verwendung dieser Bezahlungsart haben, da dann Kunden völlig zu unrecht vom Bezah len mit Klarna ausgeschlossen werden.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 18 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
15.6 Bezahlungsart Rechnung ohne Klarna Verarbeitung anbieten
Im PhPepperShop gibt es verschiedene Möglichkeiten um eine Rechnungslieferung ohne Risk Provider zu
aktivieren. Dies darf global aber zusammen mit Klarna nicht verwendet werden, da sonst keine Zahlungs garantie übernommen werden kann und die Rechnung auch gar nicht zu Klarna übermittelt wird.
Ausgewählten Kunden möchte man das Einkaufen gegebenenfalls ohne Rechnungsübermittlung an Klarna gestatten, z.B. Tochtergesellschaften oder anderen Partnern/Kunden oder weil in gewissen Zielländern keine B2B-Zahlungen von Klarna verarbeitet werden können. Bitte dies aber sehr gut durchdenken,
da die Bonität eines Kunden sehr schnell ändern kann.
Es gibt drei Möglichkeiten, wie man im PhPepperShop Bezahlung per Rechnung aktivieren kann, ohne
diese Bezahlungsart für die Allgemeinheit zur Verfügung zu stellen. Allen im folgenden vorgestellten Methoden ist gemeinsam, dass die Bezahlungsart Rechnung in den Allgemeinen Shop-Einstellungen deaktiviert sein muss.
1. Am einfachsten konfiguriert man die Lieferung auf Rechnung pro Kundenaccount direkt in der
'Kunde bearbeiten'-Maske im Kundenmanagement.
2. Wenn man in der Datei {shop_verzeichnis}/shop/config.inc.php die Konstante
RECHNUNGSLIEFERUNG_KUNDE auf true gesetzt hat und der Kundennummer ein R- voranstellt, so schaltet der Shop für diese Kunden die (sonst gesperrte) Zahlungsart Rechnung frei.
Wenn die Zahlungsart generell freigeschaltet ist, hat das R- natürlich keinen Einfluss.
3. Eine weitere Methode, spezifischen Kunden Rechnungslieferung zu erlauben, besteht darin, via
Import-/Exporttool in der Spalte namens Rechnungslieferung ein gross geschriebenes Y mitzugeben.
 ACHTUNG: Sobald die Bonität von Kunden geprüft wird und eine der ersten drei hier angegebenen Methoden zur Steuerung der Rechnungslieferungen bei einem bestellenden Kunden zutreffen, wird auf je den Fall KEINE BONITÄTSPRÜFUNG und keine Klarna Benachrichtigung durchgeführt! In der Regel vertraut
man einem Kunden ja auch, wenn man ihm die Bestellung auf Rechnung erlaubt, was hilft Kosten zu sparen.
16. PhPepperShop Klarna Icon Paket für alle Sprachen
Um Klarna z.B. auf der Shop-Startseite zu bewerben gibt es ein dynamisch von Klarna einbindbares Stück
JavaScript Code. In der Modulhilfe findet man eine Vorschau. Einfach im Klarna Modul oben rechts auf
das Schwimmring-Symbol klicken (ersetzt das früher hier verlinkte statische Icon-Pack):
Abbildung 11: Klarna Logo Vorschau
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 19 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
17. Aktivierungs CSV-File
Wenn eine Bestellung per set_liefer_status oder per Auswahl im Kunden-Management der ShopAdministration aktiviert worden ist, erzeugt oder erweitert der PhPepperShop eine per Excel / OpenOffice.org bearbeitbare Datei, welche die Rechnungs-PDFs von Klarna in Maschinen lesbarer Form auflistet:
• Dateipfad und Name: {shop_verzeichnis}/shop/Admin/log/klarna_payment_caller_aktivierungen.csv
• Zeilenstruktur: Logeintrag-Infos (Datum+Zeit / IP / Status) ; Rechnungs-Nr vom Shop ; Klarna InvoiceNo. ; URL zum Klarna Rechnungs-PDF ; Call-Resultatinfo (nur im Fehlerfall)
• Beispielzeile:
[24-Mar-2014 09:18:49] [192.168.2.53] activated;RE548388;1000705840438;https://online.klarna.com/invoices/1000705840438.pdf;
• Aufbau: CSV mit Semikolon (;) als Feld-Delimiter
18. Ablauf bei abgelehnter Pending Reservation
Ganz selten muss aufgrund der Datenlage eine Reservation von Klarna für eine manuelle Prüfung ausgewählt werden, z.B. bei Verdacht auf Missbrauch. Diese Bestellungen erhalten den Status Pending und
werden bis max. 24h für eine manuelle Prüfung hinterlegt.
Wenn so eine Reservation von Klarna abgelehnt wird, kann der Shop diese nicht verarbeiten, da keine
Zahlungsfreigabe vorhanden ist. Der Shop wird die Bestellung stornieren und den Kunden per E-Mail darüber orientieren (der Shop-Betreiber erhält ein BCC davon).
Der Inhalt der Bestellung wird als Text im Klarna Log-File abgelegt, so dass man später auch nochmals
nachsehen kann, um welchen Inhalt es sich bei dieser Bestellung gehandelt hat.
Dieser Ablauf geschieht unter Umständen vollautomatisch bei der hinterlegten Cron-Job Prüfung der offenen Pending Bestellungen.
19. Technische Versionsanforderungen
Bitte stellen Sie sicher, dass Sie eine PhPepperShop Professional oder Enterprise in Version 5.0+ verwenden.
Ältere Versionen sind nicht mit diesem Modul kompatibel, da dort dem Core relevante Features fehlen. Stel len Sie zudem sicher, dass Ihre PHP-Version cURL-Support bietet.
20. Aufschaltungsvorgang bei Klarna
Wenn Sie Klarna in Ihrem Shop integrieren möchten, können Sie wie folgt vorgehen:
a) Kaufen Sie das Klarna Modul im PhPepperShop Verkaufssystem oder bestellen Sie es als Glarotech
Hostingkunde. Oder folgen Sie zuerst Schritt 2 um Ihre Konditionen bei Klarna zu erfahren.
b) Gehen Sie zur Klarna Webseite für Ihr Land und fordern Sie eine Kostenanalyse an:
Deutschland: https://klarna.com/de/mit-klarna-verkaufen unten Links: Kontaktieren Sie mich wählen
Österreich: https://klarna.com/at/mit-klarna-verkaufen unten Links: Kontaktieren Sie mich wählen
c) Nach Ihrer Anmeldung bei Klarna erhalten Sie nun die Zugangsdaten und können das Modul aktivieren.
21. Beispiel Screenshots der Kundenseitigen Anzeige
Nun folgend werden Screenshots gezeigt, welche die Excellence Integration des Klarna Moduls zeigen.
Diese lassen sich in der Modulverwaltung steuern und anpassen.
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 20 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
Das Klarna Modul zeigt möglichst frühzeitig im Artikelkatalog Finanzierungsinfos an, so dass dem Kunden
schon zu diesem Zeitpunkt aufgezeigt wird, zu welchen Konditionen er dieses Produkt mit Klarna erwerben könnte.
Abbildung 12: Klarna Finanzierungsinfo in der mehrspaltigen Artikelliste
Neben der frühzeitigen Anzeige auf der Artikelliste ist auch die Anzeige bei der Artikel-Detaildarstellung
sehr wichtig, da diese Anzeige via Deeplinks aus Werbung und Suchmaschine angesteuert wird. Auch hier
geht es darum, dem Kunden jetzt schon anzuzeigen: „yes, you can!“.
Bei Parent- / Subartikeln ändert sich die Finanzierungsanzeige je nach Wahl des Subartikels dynamisch.
Abbildung 13: Klarna Finanzierungsinfo in der Artikel-Detaildarstellung
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 21 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
Wenn der Kunde sich entschliesst den Artikel in den Warenkorb zu legen und diesen anzeigt, rechnet
Klarna in der Finanzierungsanzeige bereits einen Schritt weiter und er sieht die berechnete Information,
mit den Konditionen, die der Kunde auch später haben kann (minimale Zahlung pro Monat).
Abbildung 14: Klarna Finanzierungsinfo im Warenkorb
In der Kasse werden Konditionen nochmals detailliert angezeigt. Im folgenden Screenshot sieht man die
Rechnung. Wenn man die Ratenzahlung anschaut, steht auch dort nochmals der entsprechende Preis pro
Monat.
Abbildung 15: Bezahlungsart Auswahl Beispiel
Wir wünschen Ihnen jetzt schon Viel Erfolg und gute Umsätze mit Klarna!
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 22 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59
Abbildungsverzeichnis
Abbildung 1: Anzeige der vorhandenen Module im PhPepperShop (Anzeige kann in Ihrem Shop
unterschiedlich sein)........................................................................................................................ 4
Abbildung 2: PhPepperShop Module...............................................................................................5
Abbildung 3: Klarna-Modul Verwaltungsmaske (kann unterschiedlich aussehen)............................6
Abbildung 4: Bestellablauf und Bestellstati im PhPepperShop.........................................................9
Abbildung 5: Informationen zur Kommunikation mit Klarna (Beispiel einer aktivierten Pending
Transaktion)..................................................................................................................................... 9
Abbildung 6: Detailanzeige einer Klarna Aktivierung (gesendete Parameter und erhaltenes
Resultat)........................................................................................................................................ 10
Abbildung 7: Bestellungsstatus im Kundenmanagement auf 'versendet' anpassen (Dropdown oder
Button)........................................................................................................................................... 12
Abbildung 8: Log Viewer Modul auswählen....................................................................................13
Abbildung 9: Beispiel Infomeldungen der Klarna Modulmaske.......................................................15
Abbildung 10: Anzeigebedingungen setzen...................................................................................18
Abbildung 11: Klarna Logo Vorschau.............................................................................................19
Abbildung 12: Klarna Finanzierungsinfo in der mehrspaltigen Artikelliste......................................21
Abbildung 13: Klarna Finanzierungsinfo in der Artikel-Detaildarstellung........................................21
Abbildung 14: Klarna Finanzierungsinfo im Warenkorb..................................................................22
Abbildung 15: Bezahlungsart Auswahl Beispiel..............................................................................22
Glarotech GmbH
Toggenburgerstrasse 156 • CH-9500 Wil
UID: CHE-110.486.165
http://www.glarotech.ch
[email protected]
Seite 23 von 23
Tel. +41 (0)71 923 08 58
Fax +41 (0)71 923 08 59