Handbuch zur Integration von sofortüberweisung.de in Zen-Cart

Transkript

1 Handbuch zur Integration von sofortüberweisung.de in Zen-Cart sofortüberweisung.de Modul PAYMENT NETWORK AG. Alle Rechte vorbehalten. Es ist untersagt, Teile dieser Dokumentation ohne schriftliche Genehmigung der Payment Network AG zu reproduzieren oder unter Verwendung elektronischer Systeme zu verarbeiten, vervielfältigen oder zu verbreiten. Die PAYMENT NETWORK AG übernimmt keine Gewähr für die Funktion einzelner Programme oder von Teilen dieser. Insbesondere wird keine Haftung für eventuell aus dem Gebrauch resultierende Folgeschäden übernommen.

2 Handbuch sofortüberweisung.de, Version 3.0 Seite 2 von 15 Inhaltsverzeichnis 0.1 Überblick Funktionsweise Kurzübersicht Integration sofortüberweisung.de Integrieren von sofortüberweisung.de in Zen-Cart Herunterladen der Schnittstelle Automatische Installation (Aktivieren der Schnittstelle) Manuelle Installation von sofortüberweisung.de Benachrichtigungen Erweiterte Einstellungen Passwörter und Hash-Algorithmus Einstellungen in Zen-Cart Beschleunigter Geldeingang Kundeninformationen und Bewerbung sofortüberweisung.de Auswahl von Logo s, Banner und Kundeninformationen Zahlungsauswahlseite: Mindestinformationen Zahlungsauswahlseite: individuelle Informationen Informationen in Newsletter an Ihre Kunden Weitere Aktionen sofortüberweisung.de testen Support Impressum und Kontakt ACHTUNG! Die Anwendung muss in das System des Anbieters dergestalt integriert werden, dass die URL und das SSL-Zertifikat der Payment Network AG für den Kunden des Anbieters erkennbar und überprüfbar ist. Sofern eine Versendung einer Mail mit Zahlungsaufforderung (Zahlung per sofortüberweisung.de) gewünscht ist, stellt die Payment Network AG eine Paycode-Lösung bereit.

3 Handbuch sofortüberweisung.de, Version 3.0 Seite 3 von Überblick Funktionsweise Mit sofortüberweisung.de erfolgt die Bezahlung des Warenkorbs innerhalb von Sekunden automatisiert und direkt vom Online Konto des Käufers auf das Konto des Anbieters. Nach dem Auswählen von sofortüberweisung.de als Zahlungsmethode muss der Käufer nur drei einfache Schritte vollziehen. Alles andere wird vom System in wenigen Sekunden automatisiert ausgeführt: sofortüberweisung.de gehört Dank einem umfassenden Sicherheitskonzept, d.h. SSL-Verbindungen, SSL-Zertifikat, einer sicheren Serverumgebung, sowie einer Versicherung gegen PIN/TAN Missbrauch zu den sichersten Zahlungsmitteln weltweit. Weitere wichtige Informationen zur Funktionsweise, Vorteile, Sicherheit, Unternehmen etc. finden Sie unter.

4 Handbuch sofortüberweisung.de, Version 3.0 Seite 4 von Kurzübersicht Integration sofortüberweisung.de Automatische Installation möglich (Seite 5) 1. Alle erforderlichen Daten eingeben 2. Auswahl ob Neukunde oder bereits registriert, ggfs. Daten ergänzen 3. Link Zurück zum Shop-Admin folgen sofortüberweisung.de ist installiert Manuelle Installation (Seite 6) 1. Registrierung bei sofortüberweisung.de 2. Neues sofortüberweisung.de-projekt erstellen (Seite 6) 2a Schnelleinstellungen o Erfolgs- und Abbruchlink einrichten (Seite 7) 2b Erweiterte Einstellungen o Nicht änderbare Parameter (Seite 8) o Benachrichtigungen (Seite 7) o Passwörter und Hash-Algorithmus (Seite 8) 3. Shop-Admin einrichten (Seite 9) o Kundennummer: Ihre Kundennummer bei sofortüberweisung.de o Projektnummer: Ihre Projektnummer bei sofortüberweisung.de o Projekt-Passwort: unter Erweiterte Einstellungen Passwörter und Hash-Algorithmus o Benachrichtigungspasswort: unter Erweiterte Einstellungen Passwörter und Hash- Algorithmus o Hash-Algorithmus: unter Erweiterte Einstellungen Passwörter und Hash- Algorithmus Diese Einstellungen sind nachfolgend ausführlich erklärt und beanspruchen ca. 15 Minuten.

5 Handbuch sofortüberweisung.de, Version 3.0 Seite 5 von 15 1 Integrieren von sofortüberweisung.de in Zen-Cart 1.1 Herunterladen der Schnittstelle Um den Dienst von sofortüberweisung.de als Online-Shopbetreiber zu nutzen, müssen Sie sich als erstes auf der Seite von sofortüberweisung.de die Schnittstelle für Zen-Cart herunterladen. Entpacken Sie nun die Datei. Den Inhalt des Ordners sofortueberweisung_zencart_3.0 müssen Sie auf Ihren Webserver kopieren. (z.b.: Den Inhalt des Ordners includes in den Ordner includes in Ihrem Zen-Cart-Shop.) 1.2 Automatische Installation (Aktivieren der Schnittstelle) Melden Sie sich als Admin in Ihrem Zen-Cart-Shop an. Unter den Modulen finden Sie die Zahlungsweisen. Hier wählen Sie bitte sofortüberweisung.de aus und klicken auf den Button Autoinstaller (empfohlen). Sie werden automatisch auf die Registrierungsseite von sofortüberweisung.de weitergeleitet. Geben Sie bitte in der Maske alle erforderlichen Daten ein und folgen bitte dem Web- Registrierungsprozess. Sollten Sie sich bereits bei sofortüberweisung.de registriert haben, oder weitere Shops installieren, führen Sie trotzdem den Autoinstaller (empfohlen) erneut aus, und halten Sie Ihre Kundennummer und Passwort bereit, es wird lediglich ein neues Projekt mit den korrekten Parametern angelegt. Zu guter Letzt klicken Sie bitte den Link Zurück zum Shop-Admin & Speichern an, damit Ihre Daten in Ihren Shop übernommen werden können. Mit Ihrer Kundennummer und Passwort können Sie sich zur Verwaltung und weiteren Einstellungen von Parametern bei sofortüberweisung.de einloggen und gelangen in Ihr persönliches Administrationsmenu.

6 Handbuch sofortüberweisung.de, Version 3.0 Seite 6 von Manuelle Installation von sofortüberweisung.de Sollen Sie Probleme bei der Installation mit dem Autoinstaller (empfohlen) haben, so kann sofortüberweisung.de auch manuell über den Button Installieren aktiviert werden. Hierzu müssten Sie sich auf registrieren. Nach erfolgreicher Registrierung melden Sie sich bitte mit Ihrer Kundennummer und Passwort an und legen ein Neues Projekt an. Für die manuelle Installation müssen Sie noch einige Parameter in Ihrem neu erstellten Projekt einstellen. Nachfolgend werden die einzelnen Schritte erklärt. Um die Parameter in Ihrem Projekt zu bearbeiten, navigieren Sie bitte im Menü unter Projekte zu Meine Projekte. In der Projekt-Übersicht können Sie nun den Namen Ihres Projektes anklicken und Sie gelangen zu den Schnelleinstellungen und können dort Ihr Projekt editieren. Scrollen Sie bitte in Ihrem Projekt bis zum Menüpunkt Schnittstelle. Dort müssen Sie nun die Parameter für den Erfolgslink und den Abbruch-Link setzen: Bei Erfolgslink tragen Sie bitte folgendes ein: http(s)://-user_variable_2- WICHTIG: Die Variable muss in Minusstrichen (-) stehen Sollten Sie kein SSL benutzen, so verwenden Sie bitte

7 Handbuch sofortüberweisung.de, Version 3.0 Seite 7 von 15 Bei Abbruch-Link tragen Sie bitte folgendes ein: http(s)://-user_variable_3- WICHTIG: Die Variable muss in Minusstrichen (-) stehen Sollten Sie kein SSL benutzen, so verwenden Sie bitte ACHTUNG: Wir empfehlen die Automatische Weiterleitung zu aktivieren! Bitte klicken Sie nun auf SPEICHERN um das Projekt zu sichern Benachrichtigungen Sie haben die Möglichkeit sich als Händler mittels Benachrichtigungen über Sofortüberweisungen Ihrer Kunden informieren zu lassen. Hierzu navigieren Sie im Projektmenü zu Erweiterte Projekteinstellungen : Unter dem Menüpunkt Benachrichtigungen können Sie bestehende Benachrichtigungen bearbeiten oder neue Benachrichtigungen anlegen. Neue Benachrichtigung erstellen: Klicken Sie auf Neue Benachrichtigung anlegen und navigieren Sie anschließend über das Menü zu HTTP, wie der folgende Screenshot zeigt:

8 Handbuch sofortüberweisung.de, Version 3.0 Seite 8 von 15 Klicken Sie die Checkbox aktiviert an und geben als Benachrichtigungs-URL bitte folgendes an: http(s)://url_zum_shop/extras/pn_sofortueberweisung/callback.php WICHTIG: Die Variable muss in Minusstrichen (-) stehen Sollten Sie kein SSL benutzen, so verwenden Sie bitte Bitte speichern Sie nun die neu hinzugefügte Benachrichtigung mittels des Buttons Speichern Erweiterte Einstellungen Nicht änderbare Parameter Im Projektmenü unter erweiterte Projekteinstellungen gelangen Sie zu den Nicht änderbaren Parametern. Bitte setzen Sie hier Betrag und Verwendungszweck als nicht änderbar. (Häkchen aktivieren/sichtbar) Bestätigen Sie bitte abschließend mittels des Buttons Speichern Passwörter und Hash-Algorithmus Im Projektmenü unter erweiterte Projekteinstellungen gelangen Sie zu Passwörter und Hash- Algorithmus. Bitte generieren Sie hier ein Projekt-Passwort und ein Benachrichtigungspasswort. Als Hash- Algorithmus wählen Sie bitte den gleichen Algorithmus wie in Ihrem Shop-System im Modul pn_sofortueberweisung (z.b. SHA1). Die beiden Passwörter benötigen Sie ebenfalls im Modul (in Ihrem Zen-Cart-Shop-Admin). Außerdem ist das Häkchen für die Input-Prüfung zu setzen (bei neu

9 Handbuch sofortüberweisung.de, Version 3.0 Seite 9 von 15 erstellten Projekten nicht notwendig) Gehen Sie nun zurück in Ihren Zen-Cart-Shop und tragen Sie dort im Admin-Bereich unter Zahlungsoptionen in Ihrem sofortüberweisung.de Modul die benötigten Daten (Kundennummer, Projektnummer, Projekt-Passwort, Benachrichtigungspasswort und Hash-Algorithmus) ein. 2 Einstellungen in Zen-Cart Sollten Sie die Installation der Schnittstelle nicht über den Autoinstaller gemacht haben, so finden Sie folgend einige Erklärungen zu den Anpassungsmöglichkeiten. Alle Anpassungen können Sie über Ihren Shop-Admin unter Zahlungsweisen (Module) vornehmen. Kundennummer: Ihre Kundennummer bei sofortüberweisung.de Projektnummer: Ihre Projektnummer bei sofortüberweisung.de Projekt-Passwort: Ihr Projekt-Passwort bei sofortüberweisung.de (unter Erweiterte Einstellungen Passwörter und Hash-Algorithmus ) Benachrichtigungspasswort: Ihr Benachrichtigungspasswort bei sofortüberweisung.de (unter Erweiterte Einstellungen Passwörter und Hash-Algorithmus ) Hash-Algorithmus: Ihr gewählter Hash-Algorithmus bei sofortüberweisung.de (unter Erweiterte Einstellungen Passwörter und Hash-Algorithmus )

10 Handbuch sofortüberweisung.de, Version 3.0 Seite 10 von 15 Zahlungszone: Wenn eine Zone ausgewählt ist, gilt die Zahlungsmethode nur für diese Zone. Verwendungszweck Zeile 1: Auswahl zwischen Bestellnummer und sofortüberweisung.de Transaktionsnummer. Verwendungszweck Zeile 2: Im Verwendungszweck (maximal 27 Zeichen) werden folgende Platzhalter ersetzt: {{order_id}} {{order_date}} {{customer_id}} {{customer_name}} {{customer_company}} {{customer_ }} Zahlungsauswahl Grafik / Text: Angezeigte Grafik / Text bei der Auswahl Zahlungsoptionen. Bestätigter Bestellstatus: Order Status nach Eingang einer Bestellung, bei der von sofortüberweisung.de eine erfolgreiche Zahlungsbestätigung übermittelt wurde Zu überprüfender Bestellstatus: Order Status nach Eingang einer Bestellung bei der keine oder eine fehlerhafte Zahlungsbestätigung übermittelt wurde Temporärer Bestellstatus: Bestellstatus für noch nicht abgeschlossene Transaktionen Anzeigereihenfolge: Reihenfolge der Anzeige. Kleinste Ziffer wird zuerst angezeigt. Was Sie hier beachten sollten: Sie haben für die Platzhalter nur 27 Zeichen Platz im Überweisungsformular. Für Textänderungen können Sie unter dem Verzeichnis:../lang/german/modules/payment die entsprechende Datei ebenfalls anpassen. Achten Sie auf die sorgfältige Einhaltung der Klammerregeln.

11 Handbuch sofortüberweisung.de, Version 3.0 Seite 11 von 15 3 Beschleunigter Geldeingang Um die Banklaufzeiten zu verkürzen, können Sie alle Ihre Geschäftskonten für den Zahlungseingang bei sofortüberweisung.de im Projekt hinterlegen. Das System wählt in Abhängigkeit der Absenderbank die günstigste Zielbank. Bitte tragen Sie weitere Bankverbindungen im Projekt unter den Erweiterten Projekteinstellungen bei Bankverbindungen ein.

12 Handbuch sofortüberweisung.de, Version 3.0 Seite 12 von 15 4 Kundeninformationen und Bewerbung sofortüberweisung.de sofortüberweisung gehört zu den von Online-Käufern bevorzugten Bezahlmethoden. Allerdings gibt es nach wie vor Kunden, die nicht wissen, wie sofortüberweisung.de funktioniert, welche technischen und rechtlichen Schutzmechanismen geboten werden und welche Vorteile mit sofortüberweisung verbunden sind. Das Wissen Ihrer Kunden über sofortüberweisung.de ist entscheidend für die Akzeptanz und Effizienz dieser Zahlart. Es ist daher sehr wichtig, dass Sie Ihren Kunden in übersichtlicher Form zu dieser Zahlart informieren. Die meisten Kunden informieren sich erst dann über die angebotenen Zahlungsarten, wenn die Bezahlung einer Bestellung ausgeführt werden muss. Dies erfolgt auf der Zahlungsauswahlseite. Daher ist dieser Seite bei der Integration von sofortüberweisung.de besondere Aufmerksamkeit zu widmen. 4.1 Auswahl von Logo s, Banner und Kundeninformationen Die Payment Network AG bietet eine umfassende Sammlung von Logos, Banner und Vorlagen für Kundeninformationen (z.b.: für die Anzeige unserer Zahlart auf Ihrer Startseite) an. Eine Auswahl finden Sie unter folgendem Link: Zahlungsauswahlseite: Mindestinformationen Auf der Zahlungsauswahlseite empfehlen wir sofortüberweisung.de an erster Stelle zu platzieren, da sich dadurch Kunden häufiger für diese Zahlart entscheiden und Sie als Anbieter die mit dieser Bezahlmethode verbundenen Vorteile besser realisieren. Bei der Auswahl von sofortüberweisung.de als Zahlart empfehlen wir mindestens folgende Informationen:

13 Handbuch sofortüberweisung.de, Version 3.0 Seite 13 von 15 sofortüberweisung.de (empfohlen) 1. Direkte Überweisung per Online-Banking (PIN und TAN) 2. TÜV zertifzierter Datenschutz Tage schnellere Lieferung als Vorkasse 4. Ihre Bestellung wird sofort verarbeitet. 4.3 Zahlungsauswahlseite: individuelle Informationen Je nach den von Ihnen angebotenen Zahlarten können Sie Ihren Kunden auch speziell auf die Vorteile gegenüber den anderen Zahlarten aufmerksam machen: sofortüberweisung.de (empfohlen) 1. Direkte Überweisung per Online-Banking (PIN und TAN) 2. TÜV zertifzierter Datenschutz Tage schnellere Lieferung als bei Vorkasse 4. Automatisierte Übermittlung der Bestelldaten an Ihre Bank 5. Keine Nachnahmegebühren 6. Bezahlen ohne Kreditkarte 7. Kostenlos und ohne Registrierung 4.4 Informationen in Newsletter an Ihre Kunden Falls Sie regelmäßig Newsletter zu Ihren Angeboten an Ihre Kunden versenden, empfehlen wir Ihnen, die Bezahlart sofortüberweisung.de hier ebenfalls kurz vorzustellen. Damit erhöhen Sie wiederum die Akzeptanz und Effizienz dieser Bezahlmethode und profitieren vermehrt von den angebotenen Vorteilen. Vorlagen für Kundeninformationen in Ihren Newsletter finden Sie hier: Weitere Aktionen Falls Sie weitere gezielte Marketingaktionen für sofortüberweisung planen, bieten wir auch kostenlosen qualitativ hochwertigen Support. Bei Anfragen zu dieser Thematik wenden Sie sich bitte an den Support der Payment Network AG.

14 Handbuch sofortüberweisung.de, Version 3.0 Seite 14 von 15 5 sofortüberweisung.de testen sofortüberweisung.de bietet die Möglichkeit, die Applikation, die entsprechenden Benachrichtigungen etc. in einem Testmodus zu überprüfen. Loggen Sie sich in Ihren Administrationsbereich von ein unter Verwendung Ihrer Kundennummer und Passworts, das Sie bei der Registrierung bei Sofortüberweisung erhalten haben. Klicken Sie unter Projekte auf Übersicht Klicken Sie dann auf den Projektnamen. Setzen Sie neben Testmodus das Häkchen Klicken Sie dann am Ende der Seite auf Speichern Bei aktiviertem Testmodus können Sie mit einer frei erfundenen Kontonummer und der Bankleitzahl (8 Mal die 8) sofortüberweisung.de testen, ohne dass eine Überweisung durchgeführt wird. Sie haben somit die Möglichkeit, ihre - Benachrichtigungen oder HTTP-Benachrichtigungen zu überprüfen. Bitte beachten Sie, dass bei allen anderen Bankleitzahlen trotz Testmodus die Überweisung abgeschickt wird. Achtung: Für den produktiven Einsatz sollten Sie den Testmodus unbedingt deaktivieren.

15 Handbuch sofortüberweisung.de, Version 3.0 Seite 15 von 15 6 Support Das Team von sofortüberweisung.de steht Ihnen zur Verfügung, sollten Sie Hilfe benötigen. Sie können uns entweder eine an support@payment-network.com schreiben oder unter unser Supportformular ausfüllen. Ihre Nachricht wird dann an das sofortüberweisung.de Ticket-Support-System weitergeleitet, das sicherstellt, dass Ihre Frage von einem Mitarbeiter zeitnahe beantwortet wird. Wir helfen Ihnen gerne telefonisch unter der +49(0)89/ bei technischen Fragen weiter. 7 Impressum und Kontakt Payment Network AG Fussbergstr. 1 D Gauting Tel.: +49 (0) Fax: +49 (0)89 / Vorstand: Christoph Klein (Vorsitz), Andrea Anderheggen, Dr. Jens Lütcke, Georg Schardt Aufsichtsrat: Dr. Michael Riemenschneider (Vorsitz) Eingetragen beim Amtsgericht München: HRB