Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) Handbuch zur Integration von micropayment. Inhaltsverzeichnis

Transkript

1 Handbuch zur Integration von micropayment Shopsystem: Modified ecommerce Shop Shopversion: 1.06 Modulversion: Erschienen: Inhaltsverzeichnis Einleitung... 2 Checkliste... 2 Funktionsweise... 3 Installation... 4 Konfiguration... 5 Notification Server zu Server Kommunikation... 9 Grafik - Code Support / Kontakt Copyright micropayment GmbH - alle Rechte vorbehalten Die micropayment GmbH übernimmt kein Gewähr für Funktion oder Teilfunktion der beschriebenen Bezahlmodule. Des Weiteren wird keine Haftung für eventuelle, aus der Verwendung resultierende, Folgeschäden übernommen. Bitte beachten Sie, dass es nicht gestattet ist, Inhalte dieses Dokumentes ohne schriftliche Genehmigung der micropayment GmbH zu verändern, vervielfältigen oder zu verbreiten. Seite 1 von 12

2 Einleitung Die micropayment GmbH ist einer der führenden Anbieter für E-Payment und Abrechnungssysteme im Internet. Das Unternehmen bietet umfangreiche Zahlungssysteme zur Abrechnung im Bereich E-Commerce und Digital Content speziell für Onlineshops, Verlage und Paid-Content-Anbieter an. Die Transaktionen werden über ein eigenes Rechenzentrum abgewickelt. Die micropayment GmbH ist nach PCI:DSS Level 1 zertifiziert und wird somit den hohen Anforderungen eines modernen Full-Service-Payment-Anbieters gerecht. Die Abrechnung erfolgt dabei wahlweise direkt im Onlineshop des Anbieters oder über die Webseite der micropayment GmbH. Es stehen neben der einmaligen Abrechnung auch wiederkehrende Zahlungen, z.b. für Verlagsanbieter oder Abo-Commerce-Modelle, zur Verfügung. Zum Kundenstamm der micropayment GmbH zählen derzeit circa Businesskunden aus den Bereichen Verlagswesen (z.b. VDI Verlag GmbH, Bauer Digital KG & Huss Medien), Spieleplattformen (z.b. GameDuell, Upjers, RedMoon Studios & Playa Games GmbH), Content - Portale (z.b. fotograf.de, deutsche-boerse.com & aboalarm.de), Spendenorganisationen (z.b. Welthungerhilfe, Deutsches Rotes Kreuz, German Doctors e.v. & Roche) und viele weitere Bereiche des klassischen E-Commerce (Milka, Whiskas & EOL Tierportale). Weitere Informationen über die micropayment GmbH sind im Internet unter der Adresse abrufbar. Checkliste Folgende Dinge sind notwendig um die Bezahlmodule nutzen zu können: Anmeldung auf Freischaltung des Accounts seitens micropayment Projekt unter Konfiguration angelegt Projekt durch micropayment freigeschaltet Sollten Sie Fragen haben, steht Ihnen unser Support-Team jederzeit zur Verfügung. Wichtig: Bei der Nutzung der Zahlungsart Kreditkarte muss eine Händlervertragsnummer (VU- Nummer) beantragt werden. Bitte beantragen Sie diese rechtzeitig in Ihrem micropayment ControlCenter unter Konfiguration -> Zahlungsarten beantragen oder über backoffice@micropayment.de, da eine Freischaltung ca. 21 Tage in Anspruch nehmen kann. Wichtig: Bei der Nutzung der Zahlungsart Lastschrift senden Sie uns bitte die Lastschrift-Checkliste zur Freischaltung. Dieses Dokument finden Sie in Ihrem ControlCenter unter dem Menüpunkt Zahlungsarten beantragen. Seite 2 von 12

3 Funktionsweise Die zur Verfügung gestellten Module ermöglichen es, Zahlungen über folgende Zahlungsarten abzuwickeln: Kreditkarte Sofortüberweisung Lastschrift Vorkasse Zahlung per VISA, Mastercard und AMEX Zahlung per Onlineüberweisung SEPA Elektronisches Lastschriftverfahren (ELV) Direkte Banküberweisung Die vom Benutzer eingegebenen Kreditkarten- oder Lastschriftdaten werden an die micropayment -Server weitergegeben. Nach erfolgreicher Datenvalidierung wird die Buchung durchgeführt. Ereignis im Fehlerfall Verläuft die Transaktion nicht erfolgreich, wird dem Käufer eine Fehlermeldung mit Hinweis auf die Fehlerbehebung ausgegeben. Ereignis bei Erfolg Verlief die Buchung erfolgreich, meldet der micropayment -Server dem Shop, dass die Bezahlung erfolgreich war. Wie bei Bestellungen über andere Payment-Module wird die Bestellung nach erfolgter Transaktion in die Shop-Datenbank geschrieben, der jeweilige Status gesetzt und die Bestell- s an den Shop-Betreiber sowie den Einkäufer versendet. Die Bankdaten werden zweifach überprüft: 1) nach Eingabe durch den Käufer per JavaScript 2) nach Absenden der Daten an die micropayment -Server Ist eine Zahlung erfolgreich durchgeführt worden, können Sie die bestellte Ware sofort versenden oder zum Download anbieten. Bei Auslösen eines Stornos/Reversals senden die micropayment -Server eine Benachrichtigung an das Shop-Modul, welche den Status der dem Storno zugehörigen Bestellung auf offen zurücksetzt. Die nun offene Bestellung wird Ihnen im Administrator-Bereich des Shops automatisch zur weiteren Bearbeitung wieder vorgelegt. Seite 3 von 12

4 Installation Sollten Sie das Installations-Paket und dieses Handbuch nicht von unserer Webseite ( geladen haben, prüfen Sie bitte zunächst, ob eine neuere Version dieses Pakets zur Verfügung steht. SICHERN SIE BITTE IHR GESAMTES SHOPVERZEICHNIS SOWIE DIE DATENBANK IHRES SHOPS. Vorwort: Für die Installation der Bezahlmodule benötigen Sie Zugriff auf die Dateien der Shopsoftware. Üblicherweise loggen Sie sich hierfür per FTP auf Ihrem Server ein. Installationsbeginn: Kopieren Sie alle Dateien aus dem zip-archiv (mit bestehender Verzeichnis- Hierarchie) in Ihr Shop-Hauptverzeichnis. Bestehende Dateien aus der modified ecommerce Shopsoftware werden dabei nicht überschrieben. Ausnahme: Falls Sie bereits ein micropayment -Modul installiert haben, löschen Sie dieses bitte, BEVOR Sie das neue Modul installieren! 1) Verbinden Sie sich mit dem Dateisystem Ihres Webservers, meist über FTP. 2) Entpacken Sie das Modul-Archiv auf Ihren Computer. 3) Laden Sie den Inhalt anschließend in das Hauptverzeichnis von Modified. Die Verzeichnisse callback, images, includes und lang sollten dabei überschrieben werden. Es werden KEINE vorhandenen Dateien überschrieben. 4) Im Ordner callback sollte nun ein micropayment Ordner vorhanden sein. 5) Loggen Sie sich in den Adminbereich Ihres Shops ein und navigieren sie zur Auswahl Module Zahlungsoptionen. 6) Dort sollten nun die Module von micropayment angezeigt werden. Die Module heißen micropayment Kreditkarte, micropayment Lastschrift, micropayment Sofortüberweisung, micropayment Vorkasse. 7) Wählen Sie das gewünschte Modul aus, klicken Sie rechts auf Installieren und anschließend auf Bearbeiten um das Modul wie folgt zu konfigurieren: Seite 4 von 12

5 Konfiguration Nachdem Sie das jeweilige Modul installiert haben, müssen Sie für die korrekte Funktionsweise noch einige Optionen anpassen. Gehen Sie dazu in den Administrations Bereich des Shops, und wählen Sie unter Module -> Zahlungsoptionen das Modul aus, für welches Sie die Optionen anpassen wollen. Button: Bestellung aufräumen Ein Button, der alle Bestellungen mit dem Status Bezahlung steht aus / pending payment löscht, die X Tage alt sind. So können nicht-abgeschlossene Bestellungen manuell entfernt werden. Folgende Optionen stehen zur Auswahl: 1) Status Aktivieren (True) Sie hier das Bezahlmodul, um es im Shop verfügbar zu machen. 2) Mindestbestellwert Geben Sie hier den Mindestbestellwert ein. Oder eine 0 für keinen Mindestbestellwert. 3) Maximalbestellwert Geben Sie hier den Maximalbestellwert ein. Oder eine 0 für keinen Maximalbestellwert. 4) Positionierung Geben Sie hier die Position an, an der die Bezahlart im Shop angezeigt werden soll. 1 ist oben; umso höher die Zahl, desto tiefer wird das Bezahlmodul angezeigt. 5) Länderauswahl Geben Sie hier ein, in welchen Ländern das Bezahlmodul zur Verfügung steht. Falls Sie mehrere Länder angeben möchten, trennen Sie die Länder mit einem Komma z.b.: de, en. Falls Sie keine Einschränkung vornehmen wollen, lassen Sie das Feld leer. Die folgenden Einstellungen sind für alle Bezahlmodule von micropayment gültig und müssen nur einmalig eingetragen werden. Sollten Sie alle Bezahlmodule von Micropayment deinstallieren, werden auch diese Einstellungen entfernt. 6) Status Hiermit de-/aktivieren Sie das micropayment Bezahlmodul. Um ein Bezahlmodul zu nutzen, müssen Sie dieses aktivieren (true). 7) Account-ID Geben Sie hier Ihre 5 stellige Account-ID von micropayment ein. Account-ID muss gesetzt werden damit die Shopmodule aktiv verwendet werden können. 8) Access-Key Geben Sie Ihren Access-Key von micropayment ein. Diesen finden Sie in Ihrem Händler- Account unter Konfiguration. 9) Projektcode Tragen Sie hier das Projektkürzel von micropayment ein. Dieses finden Sie in Ihren Händler- Account unter Projekte. Seite 5 von 12

6 10) Bezahltext Wird auf der Rechnung bzw. als Titel im Bezahlfenster angezeigt. Der Platzhalter hierfür ist #ORDER#. 11) Theme Geben Sie hier ein Design von micropayment ein. Verfügbare Designs finden Sie in Ihrem Händler-Account unter Hilfe -> Bezahlfenster & Themes. 12) Logo-Code Geben Sie hier den Logo-Code von Ihnen an. Diesen finden Sie in Ihrem ControlCenter unter Tools -> Bezahlfenster-Grafiken klicken. Die Themes x1 oder x2 stehen Ihnen zur Auswahl. 13) Hintergrund-Grafik-Code Geben Sie hier den Hintergrundbild-Code von Ihnen an. Diesen bekommen Sie bei unserem Support. Details zu Größe und Format finden Sie in Ihrem ControlCenter unter Hilfe -> Hintergrundgrafik. (wenn Sie dieses Feld freilassen wir der Standard-Hintergrund angezeigt) 14) Hintergrundfarbe Geben Sie hier die Hintergrundfarbe im HEX-Format an (z.b. ababab oder ). Lesen Sie hierzu bitte die dazugehörige Dokumentation. (wenn Sie dieses Feld freilassen wird die Standard- Hintergrundfarbe angezeigt) 15) Löschen von nicht bezahlten Bestellungen Wie lang kann eine Bestellung sich noch im Status "Bezahlung steht aus" befinden, bevor Sie vom "Bestellung aufräumen" Button entfernt wird. Dies wird verwendet um festzusetzen wie alt eine Bestellung mindestens sein muss um von dem Button: Bestellung aufräumen entfernt zu werden. Einstellungen zwischen 3-30 Tage sind möglich. 16) Sicherheitsfeld Name Hier können Sie sich einen Feldnamen ausdenken, der für die Notifikations-API benutzt wird, um die Kommunikation zwischen den Servern zu sichern. Erlaubt sind Kleinbuchstaben und Zahlen. Sollten Sie einen eigenen Feldnamen verwenden, bitte den GET-Parameter im micropayment ControlCenter ebenfalls anpassen. Falls nicht wird secretfield verwendet. 17) Sicherheitsfeld Wert Hier tragen Sie bitte einen zufälligen Wert ein. Dieser sollte mindestens 5 Zeichen lang und ebenfalls im ControlCenter als GET-Parameter hinterlegt sein. Erlaubte Zeichen sind a-z, A-Z, ) Bestellstatus: in Bezahlung (Standard: Bezahlung steht aus) Wählen Sie hier den Status aus, den eine Bestellung während des Bezahlvorgangs hat. 19) Bestellstatus: bezahlt (Standard: In Bearbeitung) Wählen Sie hier einen Status aus, den eine Bestellung erhält, sobald der Kunde bezahlt hat und das Geld bei micropayment eingegangen ist. 20) Bestellstatus: Abgebrochen (Standard: Storniert) Wählen Sie hier einen Status aus, den eine Bestellung erhält, sobald eine Stornierung des Geldes eingeht. Seite 6 von 12

7 21) Bestellstatus: Bezahlung prüfen (Standard: Bestellung prüfen) Bei Problemen mit der Bezahlung, wird dieser Status gesetzt, damit Sie dies prüfen können. 22) Bestellstatus: Konflikt (Standard: Event-Problem!) Sollte es zu Konflikten im Bezahl-Ablauf kommen, wird dieser Status gesetzt. 23) Bestellstatus: Vorkasse Teilzahlung (Standard: Vorkasse, Teilzahlung) Wenn ein Zahlungseingang bei Vorkasse gemeldet wird, der zu bezahlende Betrag aber nicht voll erreicht ist, wird dieser Status gesetzt. Empfehlung! Order Status muss nicht verändert werden und kann problemlos 1-zu-1 übernommen werden. Seite 7 von 12

8 Shop-Installation fertig! Sie haben nun sämtliche Einstellungen in Ihrer Shopsoftware getätigt. Letztlich nehmen Sie bitte noch wichtige Einstellungen im micropayment ControlCenter vor. Nach Abschluss dieser Einstellungen können Sie die micropayment Bezahlmodule einsetzen. Seite 8 von 12

9 Notification Server zu Server Kommunikation Allgemeine Informationen zum Thema Notification (serverseitige Benachrichtigungen) Im Folgenden wird erläutert, welche Formen der nachträglichen Statusänderung (Notification) vom micropayment System gesandt werden. Dieser Abschnitt gilt zur allgemeinen Erläuterun g solcher Notifications. micropayment sendet einen STORNO / CHARGEBACK-Status, wenn eine Stornierung einer Transaktion festgestellt wurde. Ein CHARGED-Status wird gesendet, wenn der offene Betrag per Lastschrift erfolgreich bezahlt wurde, RECHARGED, wenn der Betrag nach einem Storno erfolgreich bezahlt/überwiesen wurde. Wichtig: Dieser Kommunikationskanal wird abgesichert durch den GET-Parameter secretfield. Umso wichtiger ist es den secretfield Wert geheim zu halten. Dieses Modul verarbeitet diesen Status und setzt den Bestellstatus für die jeweilige Bestellung ggf. wieder auf offen / bezahlt. Bitte beachten sie, zurzeit können keine Stornierung oder Refunds innerhalb des Shops ausgelöst werden. Hierfür müssen sie sich im micropayment ControlCenter einloggen und entsprechend auslösen. ControlCenter 1) Gehen Sie nun auf micropayment.de und loggen Sie sich ein. 2) Nach dem einloggen begeben Sie sich zu den Zahlungsarten Konfiguration Zahlungsarten 3) Wählen Sie die gewünschte Zahlungsart z.b. Lastschrift Event. 4) Kicken sie auf das + vor Lastschrift danach auf Aktionen Konfigurieren 5) Bei der API-URL geben sie folgendes ein (http oder https und Ihre Adresse bitte ergänzen): http(s)://ihre-shop-url-hier/callback/micropayment/notification.php 6) Optionen: API-Url Das Senden zusätzlicher Daten aktivieren aktivieren. 7) Optionen: Abbruch-Url: Bitte hier die URL für den manuellen Abbruch hinterlegen. 8) Optionen: Fehler-Url: Bitte hier Ihre Shop-Url eintragen, um Ihre Kunden bei einer Fehlermeldung zurück zu Ihrem Shop leiten zu können. 9) Wichtig! Bei Optionen: erweiterte Sicherheit aktivieren 10) Wichtig! GET-Parameter (QueryString) um folgendes ergänzen: a. Name: orderid Wert: $orderid b. Name: secretfield Wert: (wert muss dem Wert aus der Shopkonfiguration entsprechen - Punkt 17 der Modul-Konfiguration. Vorsicht! Hier müssen sie bei jeder Zahlungsart den gleichen secretfield Wert verwenden. z.b. können sie den secretfield wert aus Vorkasse kopieren und bei alle andere Konfiguration mit einfügen.) Vorsicht! Secretfield ist bereits vorhanden, dies darf nicht überschrieben werden! Wichtig: Achten Sie bitte darauf, dass Sie sämtliche Einstellungen speichern und die Zahlungsart aktivieren. Drücken Sie hierfür auf den Button Einstellungen speichern. Seite 9 von 12

10 Seite 10 von 12

11 Herzlichen Glückwunsch! Die micropayment Bezahlmodule sind ab sofort einsatzbereit. Hinweise 1) Die Bezahlung über die micropayment -Module können ausschließlich in der Währung (EUR) durchgeführt werden. Sollten Sie eine andere Währung in Ihrem Shop anbieten, so wird dieser Wert umgerechnet. 2) Bezahlmodule für weitere Shops finden Sie auf unserer Seite unter Seite 11 von 12

12 Grafik - Code Sie haben die Möglichkeit, im Bezahlfenster von micropayment eine individuelle Grafik mit der Größe 200x200px zu hinterlegen. Diese Grafik wird mittels Grafik-Code aufgerufen. In Ihrem micropayment ControlCenter können Sie diese unter dem Menüpunkt Tools Bezahlfenster- Grafiken hochladen. Der generierte Code (Kürzel) wird im folgenden Schritt in Ihrer Magento - Konfiguration als Grafik-Code hinterlegt. Support / Kontakt Wir helfen Ihnen bei der Konfiguration sowie der Integration unserer Zahlungssysteme und beraten Sie gern. KOSTENLOS Kundenhotline (0800) Werktags von 9:00uhr bis 17:00uhr Seite 12 von 12