Anleitung anzeigen - Übersicht

Handbuch zur Integration von micropayment™
Shopsystem:
WooCommerce
Shopversion:
2.1.x – 2.4.x
Modulversion:
1.1.7
Erschienen:
16.11.2015
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 ..........................................10
Konfiguration – WooCommerce - Bestand................................................................................10
Konfiguration - micropayment™ - WooCommerce – Zahlungsarten - Screenshot .....................11
Grafik - Code............................................................................................................................13
Support / Kontakt .....................................................................................................................13
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.
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 1 von 13
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 6.000 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
www.micropayment.de abrufbar.
Checkliste
Folgende Dinge sind notwendig, um die Bezahlmodule nutzen zu können:

Anmeldung auf www.micropayment.de

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
[email protected], 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 I hrem ControlCenter
unter dem Menüpunkt „Zahlungsarten beantragen“.
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 2 von 13
Funktionsweise
Die zur Verfügung gestellten Module ermöglichen es, Zahlungen über folgende Zahlungsarten
abzuwickeln:
Kreditkarte
Zahlung per VISA, MasterCard und AMEX
Sofortüberweisung
Zahlung per Onlineüberweisung
Lastschrift
SEPA Elektronisches Lastschriftverfahren (ELV)
Vorkasse
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.
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 3 von 13
Installation
Sollten Sie das Installations-Paket und dieses Handbuch nicht von unserer Webseite
(http://ecommerce.micropayment.de/) 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
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 4 von 13
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 www.micropayment.de
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: https://WOOCOMMERCESHOP.de
Dann hinterlegen sie für Kreditkarte bei CreditCard – Event → API-URL
https://WOOCOMMERCESHOP.de/api/creditcard
Vorkasse:
https://WOOCOMMERCESHOP.de/api/banktransfer
Kreditkarte:
https://WOOCOMMERCESHOP.de/api/creditcard
Lastschrift:
https://WOOCOMMERCESHOP.de/api/directdebit
Sofortüberweisung:
https://WOOCOMMERCESHOP.de/api/sofortueberweisung
Call2Pay:
https://WOOCOMMERCESHOP.de/api/call2pay
HandyPay:
https://WOOCOMMERCESHOP.de/api/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 WooCommerceModul 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. https://WOOCOMMERCESHOP.de/warenkorb
g. Abbruch-URL: Hier Ihre URL zur Shop-Kasse hinterlegen
z.B. https://WOOCOMMERCESHOP.de/warenkorb
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 5 von 13
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
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 6 von 13
Screenshot: micropayment CreditCard – Event Einstellung
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 7 von 13
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.
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 8 von 13
Konfiguration - micropayment™ - Gateway bei Wordpress – Screenshot
Screenshot: WooCommerce Einstellungen
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 9 von 13
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.
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 10 von 13
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
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 11 von 13
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
http://ecommerce.micropayment.de/
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 12 von 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 – BezahlfensterGrafiken“ 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) 3000 22 11
Werktags von 9:00uhr bis 17:00uhr
Haben Sie Fragen? Kontaktieren Sie uns gern telefonisch unter (0800) 3000 22 11
oder per Email unter [email protected]
Seite 13 von 13