INTEGRATIONSHANDBUCH SOFORT ÜBERWEISUNG - SHOPWARE

Transkript

1 INTEGRATIONSHANDBUCH SOFORT ÜBERWEISUNG - SHOPWARE VERSION: 1.0

2 Einführung zu SOFORT Überweisung Für SOFORT Überweisung müssen sich Ihre Kunden (Endkunden) nicht registrieren: Sie bezahlen schnell und einfach mit ihren bekannten Online-Banking Daten. Dank Echtzeitbestätigung des Überweisungsauftrags können Sie als Händler die Ware sofort versenden beziehungsweise Dienstleistungen sofort erbringen. Zudem können Sie optional auch noch den Käuferschutz anbieten, welcher Ihren Kunden zusätzliche Sicherheit bietet. Eine Transaktion mit SOFORT Überweisung gliedert sich aus Sicht Ihrer Kunden in folgende Schritte: Sobald ein Kunde per SOFORT Überweisung bezahlen möchte, wird er auf eine Seite von SOFORT geleitet. Unter der dortigen Übersicht der Überweisungsdaten (Zahlungsempfänger, Verwendungszweck, Betrag) wird Ihr Kunde aufgefordert, seine Bankleitzahl einzugeben. Anschließend wird Ihr Kunde aufgefordert, sich mit seinen Online-Banking Zugangsdaten anzumelden. Nach erfolgreicher Anmeldung muss Ihr Kunde die Überweisung mit einer gültigen TAN bestätigen und freigeben. Sofern eine gültige TAN eingegeben wurde, wird die Überweisung beauftragt und Ihr Kunde gelangt zu einer Zusammenfassung der durchgeführten Transaktion. Zuletzt gelangt er über einen Klick wieder zurück zu Ihrem Webshop. Page: 2/

3 Integrationsschritte Um SOFORT Überweisung / SOFORT Banking in Shopware zu integrieren, sind die folgenden Schritte notwendig: Registrieren Sie sich als Anbieter auf unserer Seite Neues SOFORT Projekt erstellen und konfigurieren Installieren des SOFORT Moduls im Shop SOFORT Modul im Administrations-Backend Ihres Shops einrichten Einrichten eines Projektes für SOFORT Überweisung Registrierung bei SOFORT Um SOFORT Überweisung / SOFORT Banking über Shopware verwenden zu können, benötigen Sie einen Kundenaccount bei SOFORT. Falls Sie diesen noch nicht besitzen, können Sie sich unter registrieren. Nach der Registrierung müssen Sie im Anbietermenü eingeloggt sein und können im nächsten Schritt ein Projekt für Ihr System / Ihren Online Shop erstellen. Falls Sie nicht SOFORT Überweisung verwenden, müssen Sie noch das gewünschte Produkt aktivieren. Die Produktaktivierung findet sich in der linken Navigation unter "Mein Konto > Produkt-Aktivierung". Neues SOFORT Projekt erstellen Um ein Projekt anzulegen, klicken Sie bitte Neues Projekt in der linken Spalte und legen ein SOFORT Gateway-Projekt an. Wenn Sie schon eine andere SOFORT-Zahlart in Ihrem Shop nutzen, können Sie SOFORT Überweisung / SOFORT Banking in dem bereits bestehenden Projekt aktivieren. ACHTUNG: Bitte wählen Sie als Projekttyp " SOFORT Gateway" aus. Funktionen wie automatische Rückbuchungen und Käuferschutz stehen nur zur Verfügung wenn Sie ein Konto der Deutsche Handelsbank hinterlegen. Sie haben die Möglichkeit während der Projektanlage ein Deutsche Handelsbank Konto zu beantragen. Vervollständigen Sie nun Ihre Projektdaten. Die wichtigsten Einstellungen im Überblick: Page: 3/

4 Allgemeine Einstellungen Adresse Projektname: Geben Sie hier den Namen Ihres Shops an. Shopsystem: Wählen Sie Ihr Shop-System. Branche: Wählen Sie Ihre Branche. Webseite: Geben Sie die URL zu Ihrem Online-Shop an. Die hier eingetragene Adresse wird Ihrem Kunden auf unserem Zahlformular angezeigt. Bankverbindung Tragen Sie hier Ihre Bankverbindung ein, auf der die Zahlungen eingehen sollen. Beachten Sie, dass Sie für Auslandstransaktionen in anderen Währungen ein entsprechendes Währungskonto benötigen. Sie können nach Projektanlage in den Erweiterten Einstellungen des Projektes weitere Bankverbindung für Fremdwährungen hinterlegen (z.b.: für Transaktionen aus Polen ein Zoty Währungskonto). Einstellungen für alle Zahlmethoden Wählen Sie zuerst Ihr Anbieterprofil: Händler/Shopanbieter: Wählen Sie dieses Profil wenn Sie Waren versenden. Contentanbieter: Wählen Sie dieses Profil, wenn Sie digitale Güter (Downloads, Guthaben etc.) oder Dienstleistungen anbieten. Automatische Weiterleitung: Bitte aktivieren Sie diese Option Die übrigen Einstellungen lassen Sie bitte unverändert, da Sie vom Modul bestimmt werden. Käuferschutz Wenn Sie ein Deutsche Handelsbank Konto haben, können Sie den Käuferschutz aktivieren. Ihr Account muss dafür freigeschaltet sein, wenden Sie sich dazu bitte an die Deutsche Handelsbank. Mehr Informationen zu der Deutsche Handelsbank und Käuferschutz erhalten Sie unter Zahlarten Aktivieren Sie hier SOFORT Überweisung / SOFORT Banking indem Sie die Checkbox aktivieren. Page: 4/

5 Testmodus: Mit Aktivierung dieser Option, können Sie SOFORT Überweisung / SOFORT Banking testen. Mehr Informationen dazu im Kapitel Testen. Echte und Test-Transaktionen sind parallel möglich. Wir empfehlen dennoch den Testmodus im Produktivbetrieb zu deaktivieren. Absender-Land sperren: Lassen Sie diese Option deaktiviert. Konfigurationsschlüssel Nach Projektanlage können Sie in Ihrem Projekt Ihren Konfigurationsschlüssel einsehen. Bitte hinterlegen Sie diesen Schlüssel in Ihrem Modul. Projektlogo Nach Projektanlage können Sie in den erweiterten Einstellungen ein Logo Ihres Shops oder Firma hochladen. Dieses Logo wird anstatt der eingetragenen Adresse auf unserem Zahlformular angezeigt. Installieren der Schnittstelle Sofern Sie nicht das vorinstallierte Modul verwenden, führen Sie bitte folgende Schritte aus. Andernfalls können Sie den Upload überspringen und fahren mit dem Installieren des SOFORT Moduls fort. Hinweise: Vor Veränderungen an Ihrem Shopsystem empfiehlt es sich immer eine Sicherung des Shops und der Datenbank anzulegen. Bitte stellen Sie vor Beginn der Installation sicher, dass keine veraltete Version des Moduls installiert ist. Herunterladen des Schnittstelle Um SOFORT Überweisung / SOFORT Banking in Ihrem Shopsystem nutzen zu können, müssen Sie sich zunächst das SOFORT Modul für Shopware herunterladen: HINWEIS: Wenn Sie Shopware oder höher einsetzen ist eine manuelle Installation wie in diesem Abschnitt aufgeführt nicht empfohlen. Installieren Sie das Modul direkt aus dem Shopware Community Store im Plugin Manager! Page: 5/

6 Upload des SOFORT Moduls in Shopware (nur für Shopware Versionen < 4.3.4!) Um die Schnittstelle für SOFORT-Produkte zu integrieren, gehen Sie folgendermaßen vor: 1. Navigieren Sie in der Administrationsoberfläche Ihres Shopware -Shops zum Menüpunkt "Einstellungen > Plugin Manager" und klicken dort den Button " Plugin manuell hinzufügen" 2. Klicken Sie auf " Plugin auswählen" und wählen Sie die vorher geladene ZIP-Datei aus. 3. Klicken Sie abschließend auf den Button " Plugin hochladen". Page: 6/

7 Installieren der Bezahlmethode Nach dem Upload des SOFORT Moduls folgt die Installation. Warnung: Bei Systemen mit hoher Auslastung oder mehr als 5 Subshops kann es bei der folgenden Installation zu Zeitüberschreitungen kommen. Sollte Ihr System davon betroffen sein, zögern Sie nicht den Support zu kontaktieren. Wir helfen Ihnen gerne weiter. Suchen Sie hierzu in der Liste nach dem Zahlmodul der SOFORT mit dem Namen "Sofort AG Shopware Module". Klicken Sie auf das grüne Pluszeichen rechts neben dem Modul (erscheint rechts vom Pluszeichen ein blauer kreisrunder Pfeil klicken Sie diesen vor der Installation, um das Modul upzudaten). Modulkonfiguration Nach erfolgreichem Upload und Installation folgt nun die Konfiguration des SOFORT Moduls Konfigurieren der Zahlungsmethode Navigieren Sie in Ihrem Admin-Bereich zu " Einstellungen > Grundeinstellungen". Page: 7/

8 2. Klicken Sie auf das Pluszeichen in der linken Spalte im Menüpunkt " Zahlungsarten" und anschließend auf " Sofort AG Shopware Module". Wenn das Modul korrekt eingebunden wurde, finden Sie dort die verfügbaren Zahlungsarten für dieses Modul Tragen Sie unter "Konfigurationsschlüssel" den Konfigurationsschlüssel aus dem SOFORT Anbietermenü ein und klicken Sie auf Speichern. Die folgenden Experteneinstellungen müssen nicht konfiguriert werden, da hierfür schon sinnvolle Standardwerte gesetzt sind. Verwendungszweck 1/Verwendungszweck 2: Hier können Sie den Standardverwendungszweck angeben, der für die SOFORT Überweisungen verwendet wird. Dabei können Sie folgende Ersetzungsparameter verwenden, die im Fall einer Zahlung mit SOFORT Überweisung / SOFORT Banking mit konkreten Werten ersetzt werden: {{order_id}} - Bestellnummer {{order_date}} -Bestelldatum {{customer_id}} - Endkundennummer {{customer_name}} - Name des Endkunden {{customer_company}} - Firmenname des Endkunden Page: 8/

9 {{customer_ }} - -Adresse des Endkunden {{transaction_id}} - Transaktions-ID der SOFORT Überweisung Achtung: Es stehen pro Verwendungszweck maximal 27 Zeichen zur Verfügung. Überschüssige Zeichen werden abgeschnitten. Sonderzeichen (wie Umlaute) werden entfernt. Logging aktivieren: Sofern aktiviert werden Aufrufe an die SOFORT Schnittstelle protokolliert (unter "Einstellungen > Logfile > Sofort AG Log"). Aus Datenschutzgründen sollte dies nur zur Fehlersuche aktiviert werden. Bestellung vor Weiterleitung erstellen: Ja: Sofern gewählt wird, ist die Bestellung sofort mit der Weiterleitung auf unser Zahlformular in der Shopware-Bestellübersicht ("Kunden > Bestellungen") aufgeführt. Der Zahlungsstatus wird aktualisiert, wie in den Statuseinstellungen eingestellt. Nein: Sofern gewählt wird, wird die Bestellung mit der Weiterleitung auf unser Zahlformular in der Shopware Abbruch-Analyse ("Marketing > Auswertungen > Abbruch-Analyse") angelegt. Erst wenn die SOFORT Überweisung erfolgreich abgeschlossen worden ist, ist die Bestellung in der Shopware-Bestellübersicht ("Kunden > Bestellungen") zu sehen. Banner oder Text bei der Auswahl der Zahlarten: Wählen Sie hier wie die Zahlart SOFORT Überweisung / SOFORT Banking im Checkout bei der Zahlartenauswahl angezeigt wird. Käuferschutztext/-banner anzeigen: Sie haben hier die Möglichkeit den Käuferschutz für SOFORT Überweisung zu aktivieren. Beachten Sie hierfür, dass in Ihrem Anbietermenü bei der SOFORT der Käuferschutz ebenfalls aktiviert werden muss. Empfohlene Zahlart: Sofern angehakt wird die Zahlart SOFORT Überweisung / SOFORT Banking als "(empfohlene Zahlart)" im Checkout bei der Zahlartenauswahl angezeigt. Statuseinstellungen: Bei den folgenden Dropdown-Feldern können Sie einstellen, welcher Bestellstatus in Abhängigkeit des Status einer SOFORT Überweisung / SOFORT Banking Transaktion in Shopware gesetzt werden soll. Temporär - Definieren Sie den Status für Bestellungen, die noch nicht bezahlt wurden. Bestätigte Zahlung - Definieren Sie den Status für Bestellungen, die mit SOFORT Überweisungen erfolgreich abgeschlossen wurden. Geldeingang - Definieren Sie den Status für Bestellungen, bei denen das Geld auf dem Konto eingegangen ist. Nur mit Deutsche Handelsbank Konto verfügbar. Abgebrochene Zahlung - Definieren Sie den Status für Bestellungen, die abgebrochen wurden. Bestellung prüfen - Definieren Sie den Status für Bestellungen, die einer Überprüfung der Zahlung bedürfen. Nur mit Deutsche Handelsbank Konto verfügbar. Teilerstattung - Definieren Sie den Status für Bestellungen, die teilweise erstattet werden. Erstattung - Definieren Sie den Status für Bestellungen, die vollständig erstattet werden. Nachdem das Modul installiert und konfiguriert wurde, folgt die Aktivierung der jeweiligen Zahlart, so dass diese auch bei der Zahlartenauswahl für Ihre Kunden erscheint (siehe nächster Abschnitt). Page: 9/

10 Aktivieren einer einzelnen Zahlungsmethode Navigieren Sie im Administrationsbereich Ihres Shops zu " Einstellungen > Zahlungsarten". Sie sehen nun die verfügbaren Zahlungsarten. Klicken Sie auf die gewünschte Zahlungsart (bspw. SOFORT Überweisung / SOFORT Banking ). Sie können nun spezifische Shopeinstellungen bezüglich dieser Zahlungsart vornehmen, wie z.b. Verfügbarkeit für bestimmte Länder, Abschläge, etc Um das Modul zu aktivieren setzen Sie die Checkbox bei " Aktiv". Im Feld Position" können Sie festlegen an welcher Stelle die Zahlungsart in der Zahlungsauswahl gelistet werden soll (je niedriger, desto weiter oben erscheint die Zahlart). Zuordnung der Zahlart zu Versandkosten 1. Navigieren Sie zu " Einstellungen > Versandkosten" 2. Page: 10/

11 2. Führen Sie die folgenden Schritte für alle Versandkosten durch, für die SOFORT Überweisung / SOFORT Banking verwendet werden darf: 1. Klicken Sie zum Bearbeiten das Bleistift Symbol hinter den Versandkosten 2. Wählen Sie auf dem Reiter " Zahlart Auswahl" unten die Zahlart SOFORT Überweisung / SOFORT Banking aus, klicken Sie auf den Pfeil nach rechts und wählen Sie " Speichern". Abschließen der Konfiguration Um die vorgenommenen Einstellungen anzuwenden, muss nun der Shop Cache gelöscht werden. Dazu klicken Sie unter " Einstellungen > Caches/Performance" und wählen Sie im Performance Fenster folgende Einstellungen und klicken Sie anschließend auf " Leeren": Informationen zu Bestellungen, die mit SOFORT Überweisung / SOFORT Banking bezahlt wurden, finden Sie unter " Kunden > Bestellungen". Page: 11/

12 Wenn in den Moduleinstellungen die Option Bestellung vor Weiterleitung erstellen: Nein gewählt worden ist, finden Sie unter "Kunden > Zahlungen > Sofort AG orders" eine Übersicht der Bestellungen bei denen die Zahlung nicht beendet wurde. Sie können an dieser Stelle einzelne oder alle dieser Bestellungen aus Shopware entfernen. HINWEIS: Ab Version des Moduls besteht die Möglichkeit, den Bestellanlageprozess einer mit SOFORT Überweisung bezahlten Bestellung dem aus anderen Zahlarten bekannten Prozess anzugleichen und damit eventuelle Probleme mit anderen Modulen (wie beispielsweise dem Modul "Bonus-System") zu beheben. Hierzu sind folgende Schritte durchzuführen: Bearbeiten Sie auf Ihrem Server im Verzeichnis /engine/shopware/plugins/community/frontend/sofortpayment/components/helpers die Datei "OrderProcessHelper.php". Ändern Sie darin die Zeile "private $createorder = true;" auf "private $createorder = false;" um In den Moduleinstellungen im Shopware-Backend stellen Sie die Option "Bestellung vor Weiterleitung erstellen:" auf "Nein" Bitte beachten Sie: Wenn diese Änderung gemacht worden ist, ist es nicht mehr möglich die Bestellnummer im Verwendungszweck zu verwenden. Testen Um die Funktionalität Ihrer Einbindung(en) der installierten Zahlarten komplett zu testen, führen Sie bitte eine Testüberweisung direkt über Ihr System/Shop aus. Dies sind die einzelnen Schritte: Testmoduls im gewünschten Projekt im SOFORT Anbietermenü aktivieren. Bestellung in Ihrem System / Shop durchführen und Zahlungsart SOFORT Überweisung / SOFORT Banking auswählen. Für deutsche Absenderkonten auf dem Zahlformular von SOFORT " " (8x "8") als BLZ verwenden, für Belgien "Andere" wählen und "999" (3x "9"), sowie für alle anderen Länder "00000" (5x "0") bzw. "Demo Bank" auswählen. Alle folgenden Daten können Sie beliebig wählen. (In Kürze können Sie anstatt der Test-BLZ auch eine länderspezifische Test-BIC übergeben: "SFRT{ISO-Länderkürzel} 20XXX", z.b. für Deutschland "SFRTDE20XXX") Überprüfen der korrekten Rückleitung 1. Wird nach der Transaktion auf die Bestätigungsseite in Ihrem System / Shop geleitet? 2. Kommen alle Benachrichtigungen richtig an? 3. Wird der Bestellstatus richtig gesetzt bzw. wird die Bestellung korrekt angelegt? Page: 12/

13 Hinweis: Deaktivieren Sie nach erfolgreichem Test den Testmodus in Ihren Projekteinstellungen im SOFORT Anbietermenü, damit Käufer nicht mit den Testdaten eine Zahlung simulieren können. Page: 13/

14 Support & Kontakt Das Team von SOFORT steht Ihnen zur Verfügung, sollten Sie Hilfe benötigen. Sie können uns entweder eine an schreiben oder unter unser Support Formular ausfüllen. Auch bei technischen Fragen helfen wir Ihnen gerne weiter: Technische Beratung: Telefon: Geschäftszeiten: Montag-Donnerstag: 08:30-18:00 Uhr Freitag: 08:30-17:00 Uhr Page: 14/

15 Impressum SOFORT GmbH Fußbergstraße Gauting Deutschland Informationen für Käufer und Online-Shopper: Telefon: Informationen für Verkäufer und Händler: Telefon: Fax: info@sofort.com Geschäftsführung Dr. Gerrit Seidel (Vorsitzender der Geschäftsführung/CEO) Dr. Jens Lütcke (CFO) Georg Schardt (Managing Director International Sales) Externer Datenschutzbeauftragter Hr. Tobias Kohl, LL.M. (Rechtsanwalt) Für Fragen zum Datenschutz wenden Sie sich bitte an: datenschutz@sofort.com Eingetragen beim Amtsgericht München HRB USt-ID: DE SOFORT GmbH. Alle Rechte, einschließlich der Übersetzung, vorbehalten. Die Dokumentation einschließlich aller veröffentlichten Inhalte ist urheberrechtlich geschützt. Nachdruck oder Reproduktion jeglicher Art sowie die Verarbeitung, Vervielfältigung und Verbreitung unter Verwendung elektronischer Systeme in irgendeiner Form bedarf der vorherigen schriftlichen Genehmigung der SOFORT GmbH. Page: 15/

16 Die Verwendung dieser Dokumentation und die Umsetzung der darin enthaltenen Angaben erfolgt ausdrücklich auf eigenes Risiko. Die SOFORT GmbH übernimmt keine Gewähr für die Funktion einzelner Programme oder von Teilen derselben. Insbesondere übernimmt die SOFORT GmbH keine Haftung für etwaige, aus dem Gebrauch resultierende Folgeschäden. Page: /