Händler-Login

commerce:SEO

Integrationshandbuch

1. Einführung zu Sofort

Für Sofort 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 gliedert sich aus Sicht Ihrer Kunden in folgende Schritte:

  • Sobald ein Kunde per Sofort 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.
Ablauf SÜ User Experience

2. Integrationsschritte

Um SOFORT Überweisung in commerce:SEO zu integrieren, sind die folgenden Schritte notwendig:

  1. Registrieren Sie sich als Anbieter auf unserer Seite https://www.sofort.com/register
  2. Neues SOFORT Projekt erstellen und konfigurieren
  3. Installieren des SOFORT Moduls im Shop
  4. SOFORT Modul im Administrations-Backend Ihres Shops einrichten

3. Einrichten eines Projektes für SOFORT Überweisung

3.1. Registrierung bei Sofort

Um SOFORT Überweisung in Ihrem Shop anbieten zu können, benötigen Sie einen Kundenaccount bei Sofort.

Falls Sie diesen noch nicht besitzen, können Sie sich unter https://www.sofort.com/register 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 verwenden, müssen Sie noch das gewünschte Produkt aktivieren. Die Produktaktivierung findet sich in der linken Navigation unter "Mein Konto > Produkt-Aktivierung".

3.2. 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 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:

Allgemeine Einstellungen

  • 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.

Adresse

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 Złoty 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 https://www.handelsbank.com/

Zahlarten

Aktivieren Sie hier SOFORT Überweisung indem Sie die Checkbox aktivieren.

  • Testmodus: Mit Aktivierung dieser Option, können Sie SOFORT Überweisung 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.

4. Installieren der Schnittstelle

Vor Veränderungen an Ihrem Shopsystem empfiehlt es sich immer eine Sicherung des Shops und der Datenbank anzulegen.

ACHTUNG:

Bitte führen Sie vor der Installation folgende Schritte aus, um nicht kompatible Zahlarten sicher zu entfernen:
(wenn die Zahlarten "SOFORT Lastschrift" und "Vorkasse by SOFORT" nicht unter " Module > Zahlarten > SOFORT Überweisung (sofort_ueberweisung) " erscheinen, können Sie die nächsten vier Schritte überspringen und bei "Herunterladen der Schnittstelle" fortfahren)

  1. Notieren Sie sich bitte die Einstellungen der verwendeten SOFORT Zahlarten
  2. Deinstallieren Sie bitte alle SOFORT Zahlarten ("SOFORT Überweisung", "Rechnung by SOFORT", "Lastschrift by SOFORT", "SOFORT Lastschrift" und "Vorkasse by SOFORT"). Klicken Sie dazu im Shopbackend auf "Module > Zahlungsoptionen", wählen Sie dort die entsprechende Zahlart aus und klicken Sie anschließend auf "Deinstallieren".
  3. Löschen Sie anschließend (auch falls Sie die Zahlarten nicht installiert hatten) die Dateien "/<path to shoproot>/includes/modules/payment/sofort_sofortlastschrift.php" sowie "/<path to shoproot>/includes/modules/payment/sofort_sofortvorkasse.php"
  4. Installieren Sie die neuen SOFORT Zahlarten wie unten beschrieben

Herunterladen der Schnittstelle

Um SOFORT Überweisung in Ihrem Shopsystem nutzen zu können, müssen Sie sich zunächst das SOFORT Modul für commerce:SEO herunterladen: https://www.sofort.com/integrationCenter-ger-DE/.

Entpacken Sie anschließend die Datei auf ihrer lokalen Festplatte (z.B. mittels 7-Zip oder WinRAR).

4.1. Upload des SOFORT Moduls auf eigenen Webserver
Modul Upload xt:Commerce 3

Kopieren Sie den Inhalt des Ordners " sofort_cseo_5.3.1.zip " mit Hilfe eines FTP-Programms (z.B. FileZilla) auf den Webserver, auf dem Ihr Shop läuft.

Öffnen Sie dazu im FTP-Programm (siehe links in der Abbildung) das Verzeichnis des SOFORT Moduls bis Sie die drei Ordner "callback", "includes" und "lang" angezeigt bekommen. Navigieren Sie auf ihrem Webserver (siehe rechts in der Abbildung) in Ihren commerce:SEO -Shop in das Basisverzeichnis. Dort finden Sie ebenfalls die Verzeichnisse "includes" und "lang". Verschieben Sie nun die Verzeichnisse des SOFORT Moduls in commerce:SEO auf ihrem Webserver, wie in der Abbildung angezeigt (die Abbildung ist nur beispielhaft, die Verzeichnisstruktur kann sich von Ihrem Shop unterscheiden).

4.2. Installation der Zahlarten im Shop
  • Navigieren Sie in Ihrem Shopbackend zu " Module > Zahlarten > SOFORT Überweisung (sofort_ueberweisung) "
  • Wählen Sie die gewünschte Zahlart. Die Zahlart lautet stets sofort_(Produktname)
  • Um eine Zahlart zu installieren, klicken Sie auf die Zahlart und anschließend in dem rechten Fenster auf den Button "Installieren". Um das Modul zu konfigurieren müssen Sie "Bearbeiten" klicken.

5. Modulkonfiguration

Um die Zahlart zu konfigurieren, müssen Sie unter " Module > Zahlarten > SOFORT Überweisung (sofort_ueberweisung) " das Modul " SOFORT Überweisung " auswählen und auf "Bearbeiten" klicken.

Folgende Einstellungen können vorgenommen werden:

  • sofort.de Modul aktivieren: Legt fest, ob die Zahlart in der Zahlartenauswahl angezeigt werden soll (True) oder nicht (False)
  • Konfigurationsschlüssel: Geben Sie hier den Konfigurationsschlüssel aus Ihren Projekteinstellungen im SOFORT Anbietermenü an. Sie müssen den Konfigurationsschlüssel eintragen um das Modul verwenden zu können.
  • Konfigurationsschlüssel/API-Key testen: Durch Klick auf den Knopf "Test" wird eine API Anfrage gestellt und geprüft, ob die Kommunikation zwischen Shopmodul und API funktioniert
  • Empfohlene Zahlungsweise: Aktivieren Sie diese Einstellung (True), um das jeweilige SOFORT-Produkt zur empfohlenen Zahlungsweise zu machen.
  • Banner oder Text bei der Auswahl der Zahlungsoptionen: Die Auswahl legt fest, wie die jeweilige Zahlart in der Zahlartenauswahl angezeigt wird. Entweder als Banner (Infographic) oder als Logo mit beschreibendem Text (Logo & Text)
  • Verwendungszweck 1: Hier legen Sie fest, ob entweder die Kundennummer ({{customer_id}}) oder die Transaktionsnummer (-TRANSACTION-) in den Verwendungszweck der Überweisung eingetragen werden.
  • Verwendungszweck 2: Hier legen Sie fest, ob entweder die angezeigten Platzhalter oder aber ein statischer Verwendungszweck (Max. 27 Zeichen) in den Verwendungszweck der Überweisung eingetragen werden.
  • Erlaubte Zonen: Geben Sie einzeln die Zonen des Shops an, welche für dieses Modul erlaubt sein sollen (z.B. AT, DE (wenn leer, werden alle Zonen erlaubt)).
  • Zahlungszone: Wenn eine Zone ausgewählt ist, gilt die Zahlungsmethode nur für diese Zone. Andernfalls ("--keine--") findet keine Einschränkung auf Zahlungszonen statt.
  • Anzeigereihenfolge: Hier können Sie die Reihenfolge der Zahlart in der Zahlartenauswahl festlegen (bspw. "0" ganz oben).

Unter den folgenden Profieinstellungen können Sie weitere Einstellungen durchführen, die jedoch standardmäßig schon sinnvoll vorbelegt wurden.

Temporärer Bestellstatus: Bestellstatus für nicht abgeschlossene Transaktionen. Die Bestellung wurde erstellt aber die Transaktion von SOFORT noch nicht bestätigt. (Standard: "Bezahlung schwebend")

Bestellstatus bei abgebrochener Zahlung: Bestellstatus bei Bestellungen, die während des Bezahlvorgangs abgebrochen wurden (sei es durch den Kunden selbst oder aber durch SOFORT). (Standard: "Bezahlung abgebrochen")

Bestätigter Bestellstatus: Bestellstatus nach erfolgreich abgeschlossener Transaktion. (Standard: "Bestätigt")

Bestellstatus, wenn kein Geld angekommen ist: Status der Bestellung, falls kein Geld auf Ihrem Konto eingegangen ist. (Voraussetzung: Konto bei der Deutsche Handelsbank). (Standard: "Prüfung notwendig")

Geldeingang: Status für Bestellungen, wenn das Geld auf dem Konto der Deutsche Handelsbank angekommen ist. (Voraussetzung: Konto bei der Deutsche Handelsbank). (Standard: "Unverändert (nur SOFORT)")

Teilerstattung: Status für Bestellungen, bei denen ein Teilbetrag an den Käufer zurückerstattet wurde. (Standard: "Unverändert (nur SOFORT)")

Vollständige Erstattung: Status für Bestellungen, bei denen der vollständige Betrag an den Käufer zurückerstattet wurde. (Standard: "Erstattung")

Käuferschutz aktiviert: Sofern Sie bei Ihrem Vertrag zur SOFORT Überweisung Käuferschutz als Option gebucht haben, können Sie dies hier aktivieren.

6. 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:

  1. Testmoduls im gewünschten Projekt im SOFORT Anbietermenü aktivieren.
  2. Bestellung in Ihrem System / Shop durchführen und Zahlungsart SOFORT Überweisung auswählen.
  3. Für deutsche Absenderkonten auf dem Zahlformular von SOFORT "88888888" (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")
  4. Ü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?

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.

7. Support & Kontakt

Das Team von Sofort steht Ihnen zur Verfügung, sollten Sie Hilfe benötigen.

Sie können uns eine E-Mail an service@sofort.com schreiben.

Auch bei technischen Fragen helfen wir Ihnen gerne weiter:

Technische Beratung:
Telefon: +49 (0)89 24 88 37 691
E-Mail: integration@sofort.com

Geschäftszeiten:
Montag-Donnerstag: 08:30-18:00 Uhr
Freitag: 08:30-17:00 Uhr

8. Impressum

SOFORT GmbH
Theresienhöhe 12
80339 München
Deutschland

Informationen für Käufer und Online-Shopper:
Telefon: +49 (0)89 24 88 37 690

Informationen für Verkäufer und Händler:
Telefon: +49 (0)89 24 88 37 692

info@sofort.com
www.sofort.com

Geschäftsführung

Felix Würtenberger
Wilhelmus Geerling Klaassen

Externer Datenschutzbeauftragter

Hr. Michael Schramm, LL.M. 
Für Fragen zum Datenschutz wenden Sie sich bitte an: datenschutz@sofort.com

Eingetragen beim Amtsgericht München
HRB 218675
USt-ID: DE248376956

© 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.

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.