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

Transkript

1 Handbuch zur Integration von micropayment Shopsystem: Shopversion CE: Oxid eshop 4.7.x 4.9.x Modulversion: Erschienen: Inhaltsverzeichnis Einleitung... 2 Checkliste... 2 Funktionsweise... 3 Installation... 4 Konfiguration... 5 Notification Server zu Server Kommunikation... 8 Micropayment - Bestellübersicht 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 11

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 11

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 11

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 ihren Server ein. Installationsbeginn: Kopieren Sie alle Dateien aus dem zip-archiv (mit bestehender Verzeichnis- Hierarchie) in Ihr Shop-Hauptverzeichnis. Bestehende Dateien aus der Oxid ecommerce Software 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 Oxid. 4) Es sollte nun der Ordner modules/micropayment/payment vorhanden sein. 5) Loggen Sie sich in den Adminbereich Ihres Shops ein und gehen zur Modul-Erweiterungen- Seite (Erweiterungen Module) 6) Dort sollten nun die Module von micropayment angezeigt werden. Das Modul heißt micropayment GmbH 7) Klicken Sie das Modul an und klicken Sie anschließend rechts auf Aktivieren. 8) Klicken Sie nun auf Einstell. um das Modul zu konfigurieren. Seite 4 von 11

5 Konfiguration Folgende Optionen stehen zur Auswahl: 1) Account-ID Geben Sie hier Ihre 5-stellige Account-ID von micropayment ein. 2) Access-Key Geben Sie Ihren Access-Key von micropayment ein. Diesen finden Sie in Ihrem Händler- Account unter Konfiguration. 3) Projekt-Kürzel Tragen Sie hier das Projektkürzel von micropayment ein. Dieses finden Sie in Ihren Händler- Account unter Projekte. 4) Bezahltext Wird auf der Rechnung bzw. als Titel im Bezahlfenster angezeigt. Der Platzhalter hierfür ist #ORDER#. 5) Theme Geben Sie hier ein Design von micropayment ein. Verfügbare Designs finden Sie in Ihrem Händler-Account unter Hilfe -> Bezahlfenster & Themes. Die Themes x1 oder x2 stehen Ihnen zur Auswahl. 6) GFX-Code Logo-Code von micropayment. (wenn Sie dieses Feld freilassen, wird das Standard-Logo angezeigt) 7) Hintergrundbild-Code Hintergrund-Bild / Code von micropayment. (wenn Sie dieses Feld freilassen, wird der Standard-Hintergrund angezeigt) 8) 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) Seite 5 von 11

6 9) Sicherheitsfeld 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. Hierbei können sie auch den automatisch erzeugten Wert verwenden. 10) Sicherheitswert 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, ) bis 14) Billing-URL Diesen Wert wird automatisch erstellt, somit müssen Sie die Billing-URL nicht ändern 15) Aktualisierungsintervall Dies wird festgesetzt um festzustellen wie oft das Modul Infodaten vom micropayment Server abholt. Keine Anpassung nötig. 16) Letzte Aktualisierung Hier wird angezeigt wann Infodaten als letztes abgeholt wurden sind. Keine Anpassung nötig. Seite 6 von 11

7 Navigieren Sie nun zu den Bezahlmethoden unter Shopeinstellungen Zahlungsarten. Aktivieren und konfigurieren Sie nun die Zahlungsarten je nach Ihren Wünschen. Bitte nicht vergessen, noch die Benutzergruppen, Länder und Versandarten der Zahlungsart zu zuordnen. Bezahlungsarten heißen Kreditkarte, Lastschrift, Sofortüberweisung und Vorkasse. Micropayment Zahlungsarten erkennen sie anhand die Beschreibung der Zahlungsart. 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 7 von 11

8 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) Loggen Sie sich in Ihrem micropayment ControlCenter 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(s)://ihre-shop-url/ (http oder https und Ihre Adresse bitte ergänzen) 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) Wichtig! Bei Optionen: erweiterte Sicherheit aktivieren 9) Zusätzliche GET-Parameter (QueryString) um folgendes ergänzen: a. Name: orderid Wert: $orderid b. Name: secretfield Wert: (secretfield wert muss dem Wert aus der Shop Konfiguration entsprechen siehe Punkt 10 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.) c. Name: cl Wert: micropayment_callback Wichtig: Achten Sie darauf, dass Sie sämtliche Einstellungen speichern und die Zahlungsart aktivieren. Drücken Sie hierfür auf den Button Einstellungen speichern. Seite 8 von 11

9 Seite 9 von 11

10 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) Bezahlstatus: Initiated payment with micropayment Kunde hat eine Bestellung ausgelöst. Eine Bestellung kann diesen Status dauerhaft besitzen falls der Kunde die Payment Fenster verlässt und keinen vollständigen Bezahlprozess durchläuft. 3) Bezahlstatus: Prepayment, outstanding. Deadline till Jahr-Monat-Tag Bestellung wurde mit Vorkasse durchgeführt. Diese wird angegeben sofern keine Bezahlungseingang vorhanden ist bei eine Vorkassen Bestellung. Angegeben Datum erläutert wann die Vorkassen Bestellung verfällt. 4) Bezahlstatus: Payment complete EUR Auth xxxxxxxxxxxxxx Bestellung wurde bezahlt. Angegeben wird Zahlbetrag und die Interne Micropayment Auth Schlüssel. Dies kann verwendet werden im ControlCenter um die Zahlung zu bearbeiten. 5) Bezahlmodule für weitere Shops finden Sie auf unserer Seite unter Micropayment - Bestellübersicht In diese Reiter können sie alle micropayment Bestellungen sehen mit letzte micropayment aktivität/bezahlungszustand. Seite 10 von 11

11 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 Oxid- Konfiguration als Grafik-Code hinterlegt. (Konfiguration - Punkt 6) 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 11 von 11