Händler-Login

xt:Commerce 4

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 xt:Commerce 4 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. Manuelle Projektanlage

Sobald Sie sich bei SOFORT Überweisung angemeldet haben, können Sie ein neues Projekt (SOFORT Überweisung Classic) manuell anlegen.

Wichtiger Hinweis: Bitte achten Sie darauf ein "SOFORT-Classic-Projekt" für SOFORT Überweisung anzulegen.

Die wichtigsten Konfigurationsmöglichkeiten werden nachfolgend erklärt.

3.2.1. Allgemeine Einstellungen

In den allgemeinen Einstellungen geben Sie einige Eigenschaften Ihres Shops/Projekts an:

Projektname: interner Name für Sie zur Zuordnung der Projekte

Shop-System: Bitte wählen Sie hier Ihr Shopsystem

Testmodus: Erklärung im Kapitel "Testen"

Adresse: Die hier eingetragene Adresse wird Ihrem Kunden im Zahlungsprozess angezeigt, damit er weiß, an wen er eine Zahlung richtet. Diese Adresse kann alternativ auch durch ein Firmenlogo ersetzt werden.

3.2.2. Spezielle Einstellungen für SOFORT Überweisung

Hier können Sie Ihr Anbieterprofil und Standardwährung für Ihr Projekt definieren. Beim Anbieterprofil können Sie zwischen Content- und Warenanbieter wählen. Der Wert bei der Standardwährung kann durch die Übergabe des Parameters 'currency_id' überschrieben werden.

Bankverbindung:

Hier müssen Sie eine Bankverbindung festlegen, die für Geldeingänge aus dem jeweiligen Absenderland genutzt werden (z.B.: EUR-Konten in Deutschland, Österreich, Belgien und der Niederlande).

Insbesondere für Länder, in denen Auslandsüberweisungen (SEPA) nicht von jeder Bank aus möglich sind und/oder zusätzliche Gebühren für Kunden verursacht werden empfehlen wir zusätzlich lokale Konten zu hinterlegen. Hierzu zählen die Schweiz (in CHF), Polen (in PLN), Italien sowie alle Betaländer. In Großbritannien ist ein lokales Konto unerlässlich.

Wichtiger Hinweis:

Bei Änderung der Bankverbindung oder Email-Adresse in Ihrem Kundenmenü wird ein Änderungscode an Ihre Email-Adresse gesendet. Erst nach Eingabe dieses Codes werden die Änderungen wirksam.

Sobald Sie ein Konto bei der Deutsche Handelsbank als Standard-Bankverbindung hinterlegt haben, können keine weiteren Bankkonten mehr angegeben werden.

Käuferschutz

Der Käuferschutz kann für dieses Projekt nur aktiviert werden, wenn folgende Bedingungen erfüllt sind:

  • Sie verfügen über ein Konto bei der Deutsche Handelsbank.
  • Für das Projekt sind keine dynamischen Empfängerkonten eingestellt.
  • Es existiert nur ein Konto für das Projekt.

Wenn Sie den Käuferschutz anbieten möchten oder Fragen dazu haben, kontaktieren Sie bitte unseren Support unter support@sofort.com oder +49 (0)89 24 88 37 691.

Schnittstelle

Erfolgslink

Unter Erfolgslink ist die Seite zu verstehen, zu der wir Ihren Kunden nach erfolgreicher Transaktion weiterleiten. Für Ihr Shopsystem müssten Sie hier folgendes eintragen:

http(s)://URL_ZUM_SHOP/index.php?page=checkout&page_action=payment_process&-KUNDEN_VAR_2-=-KUNDEN_VAR_1-&sovar3=-KUNDEN_VAR_3-&sovar4=-KUNDEN_VAR_3_MD5_PASS-&betrag=-BETRAG

Bitte aktivieren Sie die "Automatische Weiterleitung".

Abbruchlink

Auf jeder Seite des Zahlungsprozesses wird dem Kunden ein Button "Vorgang abbrechen" angezeigt. Hier können Sie festlegen, wohin Ihr Kunde geführt werden soll, wenn er abbricht. Für Ihr Shopsystem müssten Sie hier folgendes eintragen:

http(s)://URL_ZUM_SHOP/index.php?page=checkout&page_action=payment&-KUNDEN_VAR_2-=-KUNDEN_VAR_1-

Benachrichtigungen

Über die Benachrichtigung informieren wir Sie über den erfolgreichen Abschluss einer Transaktion mittels SOFORT Überweisung. Bitte beachten Sie, dass Sie nur über erfolgreiche Transaktionen benachrichtigt werden.

Um eine Benachrichtigung anzulegen, klicken Sie bitte auf "Neue Benachrichtigung anlegen".

Folgende Benachrichtigungs-Typen sind relevant:

E-Mail

Tragen Sie hier eine E-Mail Adresse ein unter der Sie über eine erfolgreiche Transaktion per E-Mail benachrichtigt werden wollen.

HTTP

Bitte hinterlegen Sie hier folgende URL:

http(s)://URL_ZUM_SHOP/index.php?page=callback&page_action=xt_sofortueberweisung

Wichtiger Hinweis

Falls Sie ein Deutsche Handelsbank-Konto im Projekt hinterlegt haben, können Sie auch eine E-MAIL/HTTP-Benachrichtigung mit Zahlungsstatus anlegen. In diesem Fall werden Sie auch über den tatsächlichen Geldeingang auf Ihrem Konto benachrichtigt.

Der Projektanlageprozess ist jetzt beendet. Klicken Sie auf "Speichern". Aktivieren Sie nun die Inputprüfung und setzen die notwendigen Passwörter.

3.2.3. Passwörter und Hash-Algorithmus

Als letzten Schritt müssen Sie die Inputprüfung aktivieren und Ihr Projekt- und Benachrichtigungspasswort setzen. Die Inputprüfung sowie die Passwörter finden Sie im Bereich "Passwörter und Hashalgorithmus". Hierzu klicken Sie im Anbietermenü auf "Meine Projekte" → wählen Sie Ihr Projekt aus → oben auf den zweiten Reiter "Erweiterte Einstellungen" → Punkt 5 "Passwörter und Hashalgorithmus".

Projekt-Passwort

Setzen Sie hier ein Projekt-Passwort und tragen Sie dieses in Ihrem Shop-Admin ein.

Benachrichtigungs-Passwort

ACHTUNG: Bitte setzen Sie nur ein Benachrichtigungspasswort sofern das entsprechende Feld in Ihrer Shopadministration verfügbar ist!

Setzen Sie hier ein Benachrichtigungs-Passwort und tragen Sie dieses in Ihrem Shop-Admin ein.

Hash-Algorithmus

Bitte wählen Sie hier:

MD5

4. Installieren der Schnittstelle

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

4.1. Herunterladen der Schnittstelle

Um SOFORT Überweisung in Ihrem Shopsystem nutzen zu können, müssen Sie sich zunächst das SOFORT Modul für xt:Commerce 4 herunterladen:

http://addons.xt-commerce.com/de/Module-und-Plugins/Zahlungweisen/sofortueberweisung.de-fuer-xt:Commerce-4.html

Entpacken Sie anschließend die Datei auf ihrer Festplatte (z. B. mittels WinZip oder WinRAR).

4.2. Upload des SOFORT Moduls in xt:Commerce 4

Kopieren Sie bitte den Ordner „xt_sofortueberweisung“ und seinen Inhalt mit Hilfe eines FTP-Programms (z. B. FileZilla) auf Ihren Webserver.

Navigieren Sie auf ihrem Webserver in den Startordner Ihres xt:Commerce 4 -Shops. Dort wird Ihnen der Ordner „plugins“ angezeigt. Verschieben Sie nun den Ordner „xt_sofortueberweisung“ und seinen Inhalt in diesen Ordner.

5. Modulkonfiguration

Nachdem im vorherigen Teil alle möglichen Einstellungen bei xt:Commerce 4 erklärt wurden, wird nun ein Blick auf Ihr Shop-System geworfen. Nachdem Sie das SOFORT Überweisung -Modul neu auf Ihren Webserver übertragen haben, finden Sie in Ihrem Admin-Bereich im Shop die Zahlungsart unter „Inhalte→Plugin→deinstallierte Plugins“ in der Modulklasse payment. Nachdem Sie das Zahlungsplugin installiert haben, können Sie die Zahlungsweise unter "Einstellungen→Zahlungsweisen" bearbeiten, evtl. ist ein Klick auf 'Neu laden' notwendig.

Gehen Sie bitte in Ihrem Admin-Bereich zu Ihrem SOFORT Überweisung -Modul unter "Einstellungen→Zahlungsweise" und geben Sie dort die benötigten Daten (Kundennummer, Projektnummer, Projekt-Passwort) ein.

Tragen Sie nun bitte bei „Zahlungsart Bezeichnung“ die deutsche Bezeichnung „ SOFORT Überweisung “ ein. Sofern Sie das SOFORT Überweisung -Banner in Ihrer Zahlartenauswahl anzeigen möchten, besuchen Sie die folgende Adresse:

https://www.sofort.com/integrationCenter-ger-DE/werbemittel/

In Ihrem Shop unter "Handbuch→Zahlungsweisen→Zahlungsarten→ SOFORT Überweisung " finden Sie weitere Hilfe zu den Einstellungen.

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.