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: WooCommerce 2.1.x 2.4.x Modulversion: Erschienen: Inhaltsverzeichnis Einleitung... 2 Checkliste... 2 Funktionsweise... 3 Installation... 4 Konfiguration - micropayment - ControlCenter... 5 Konfiguration - micropayment - ControlCenter - Screenshot... 6 Konfiguration - micropayment - Gateway bei Wordpress... 8 Konfiguration - micropayment - Gateway bei Wordpress Screenshot... 9 Konfiguration - micropayment - WooCommerce - Zahlungsarten Konfiguration WooCommerce - Bestand Konfiguration - micropayment - WooCommerce Zahlungsarten - Screenshot 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 13

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 13

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 und der jeweilige Status gesetzt. 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. Bei Auslösen eines Stornos/Reversals senden die micropayment -Server eine Benachrichtigung an das Shop-Modul, welches 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 13

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: Das micropayment -WooCommerce-Plugin kann direkt über WordPress installiert werden: 1) Login über das WordPress-Admin-Backend 2) Plugins installieren Plugin hochladen Plugin im.zip Format hochladen 3) Sobald das Plugin installiert wurde, müssen Sie dieses noch aktivieren: Plugins WooCommerce micropayment Gateway aktivieren Seite 4 von 13

5 Konfiguration - micropayment - ControlCenter micropayment - Projekteinstellungen: Bevor Sie mit der Nutzung des WooCommerce-Moduls anfangen können, müssen Sie noch einige Einstellungen im micropayment -ControlCenter vornehmen. Hinweis: Einstellungen müssen für alle Zahlungsarten vorgenommen werden, die Sie verwenden möchten. 1) Login über 2) Konfiguration Zahlungsarten Wichtig: Hier wählen Sie bitte Zahlungsart abhängig die Event Option aus. z.b. CreditCard - Event Wichtig: Alle Zahlungsarten die Sie verwenden müssen konfiguriert werden 1) Zahlungsart: Aktivieren Sie die von Ihnen benötigten Zahlungsarten von micropayment. a. API-URL: Hier muss die entsprechende API-URL-Zahlungsart abhängig hinterlegt werden z.b. heißt ist Ihre Shop URL: Dann hinterlegen sie für Kreditkarte bei CreditCard Event API-URL Vorkasse: Kreditkarte: Lastschrift: Sofortüberweisung: Call2Pay: HandyPay: b. Optionen: API-URL Das senden zusätzlicher Daten aktivieren c. Zusätzliche GET-Parameter: Rechts Option bearbeiten und folgendes am Ende hinzufügen Name: order Wert: $order d. Erweiterte Sicherheit: aktivieren e. Testmodus: aktivieren / deaktivieren muss aktiviert sein, falls Sie im WooCommerce- Modul Testbestellungen durchführen wollen. Test Daten können Sie aus dem micropayment Kundenbereich entnehmen Hilfe Testmodus f. Fehler-URL: Hier Ihre URL zur Shop-Kasse hinterlegen z.b. g. Abbruch-URL: Hier Ihre URL zur Shop-Kasse hinterlegen z.b. Seite 5 von 13

6 2) API Secret AccessKey: Damit das WooCommerce-micropayment -Plugin Zahlungen entgegennehmen kann, ist es wichtig, dass Sie Ihren AccessKey aus dem micropayment - ControlCenter notieren. Konfiguration Übersicht 3) Projektkürzel: Das Projektkürzel von micropayment können Sie Ihrer Projektübersicht entnehmen. Bitte notieren! Konfiguration Projekte unter Projektname ist das Projektkürzel 4) Secretfield: Hier können sie dem automatisch erzeugten Wert aus dem ControlCenter von micropayment entnehmen. Bitte notieren! Konfiguration Zahlungsarten Zahlungsart zusätzliche GET-Parameter Konfiguration - micropayment - ControlCenter - Screenshot Seite 6 von 13

7 Screenshot: micropayment CreditCard Event Einstellung Seite 7 von 13

8 Konfiguration - micropayment - Gateway bei Wordpress micropayment Globale Einstellungen: Das micropayment -WooCommerce-Modul muss nun für die Globale Benutzung konfiguriert werden 1 Login über das Wordpress-Admin-Backend 2 WooCommerce Einstellungen micropayment Globale Einstellungen 1) Testmodus: Aktiviert den Sandbox-Modus von micropayment. 2) Logos deaktivieren: Logos deaktivieren, welche im Checkout für die jeweiligen Zahlarten angezeigt werden. 3) Paytext: Hier können Sie einen statischen Text hinterlegen, der auf den micropayment Paymentfenstern unter Produkt: angezeigt wird. 4) API Projekt: Das Projektkürzel von micropayment. 5) API Secret AccessKey: Hier können sie einen zufälligen Wert dem automatisch erzeugten Wert aus dem ControlCenter von micropayment entnehmen und verwenden. Konfiguration Übersicht. 6) Secret Field Key: Hier können sie einen zufälligen Wert dem automatisch erzeugten Wert aus dem ControlCenter von micropayment entnehmen und verwenden. 7) Zahlungsart Projekt zusätzliche GET-Parameter (QueryString) 8) Theme: (default: x1): Hier können Sie das Aussehen des Bezahlfensters ändern. Weitere Themes und Varianten der micropayment Bezahlfenster finden Sie in Ihrem ControlCenter unter dem Menüpunkt Hilfe. 9) Hintergrundfarber: Hintergrundfarbe der Bezahlfenster (Erlaubt sind HEX-Codes) 10) Logo-Code: Geben Sie hier Ihren Logo-Code an. Diesen finden Sie in Ihrem ControlCenter unter Tools -> Bezahlfenster-Grafiken (wenn Sie dieses Feld freilassen, wird das Standard-Logo angezeigt). 11) Fehlerseite: Hier kann eine individuelle Fehlerseite hinterlegt werden falls es Probleme bei der Zahlungsablauf gibt. Seite 8 von 13

9 Konfiguration - micropayment - Gateway bei Wordpress Screenshot Screenshot: WooCommerce Einstellungen Seite 9 von 13

10 Konfiguration - micropayment - WooCommerce - Zahlungsarten Nachdem Sie das Gateway aktiviert und konfiguriert haben, müssen Sie für die korrekte Funktionsweise noch die von Ihnen gewünschten Zahlungsarten im WooCommerce-Admin-Bereich aktivieren. Wordpress Admin WooCommerce Einstellungen - Kasse micropayment Vorkasse, Call2Pay, Kreditkarten, Lastschrift, Handypay, Sofortüberweisung 1. Aktivieren / Deaktivieren Aktivierung des Moduls zur Bezahlung in Ihrem Shop. 2. Titel Dieser Titel wird im Frontend angezeigt. 3. Beschreibung Hier können Sie den Beschreibungstext der jeweiligen Zahlungsarten anpassen. Wir empfehlen hier die standardmäßig hinterlegte Beschreibung. 4. Anleitung Anleitung, welche auf der Bestellbestätigungsseite angezeigt werden soll. Kann auch frei gelassen werden 5. Zahlungsgebühr Nur vorhanden mit WooCommerce Germanized Hier kann eine Zahlungsart-abhängige Gebühr mit hinzugefügt werden 6. Mwst. Berechen Nur vorhanden mit WooCommerce Germanized MwSt.-Berechnung für Kaufpreis aktivieren. (Pflicht für Shops innerhalb Deutschland) Konfiguration WooCommerce - Bestand Um einen reibungslosen Ablauf zu gewährleisten, empfehlen wir, dass die WooCommerceeigene Funktion Ware bereithalten verwendet wird. So werden alle nicht bezahlte n Bestellungen (außer bei Vorkasse) nach individuell definierten Minuten automatisch storniert. Wordpress Admin WooCommerce Einstellungen Produkte Bestand 1. Ware bereithalten Wir empfehlen 60 Minuten zu hinterlegen. Seite 10 von 13

11 Konfiguration - micropayment - WooCommerce Zahlungsarten - Screenshot Screenshot: WooCommerce Kasse Zahlungsart Einstellungen Hinweis Zahlungsarten: Die Zahlungsarten HandyPay und Call2Pay dürfen aus gesetzlichen Gründen nicht für physische Güter als Zahlungsart verwendet werden! Unbezahlte Bestellungen erhalten den Status: Zahlung ausstehend Erfolgreich bezahlte Bestellungen erhalten den Status: in Bearbeitung Seite 11 von 13

12 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 12 von 13

13 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 WooCommerce-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 13 von 13