INHALTSVERZEICHNIS
Antworten auf Fragen zu Mollie, die nicht das Plugin betreffen, bekommst du direkt bei Mollie:
Video Tutorial
Schau dir hier im Video an, wie du Mollie im JTL-Shop einrichtest.
Hinweise zum Start
Testlauf durchführen
Folgenden Testlauf empfehlen wir dir nach Installation des Mollie Plugins, damit du sichergehen kannst, dass du alles korrekt konfiguriert hast:
- Bestellung im Test-Modus durchführen
- Bestellung über Mollie's Test Portal bezahlen
- Bestellung über WAWI abrufen
- Bestellung über WAWI versenden
- Bestellung über WAWI stornieren
Da in diesem Plugin mit Warteschlangen gearbeitet wird, ist es notwendig, dass im Shop auch Traffic herrscht (also Aufrufe des Shop Frontends).
Ein JTL-WAWI Abgleich einer versendeten Bestellung wird erst durch einen echten Aufruf des JTL-Shops im Browser an Mollie übertragen (i.d.R. durch einen Besucher ausgelöst).
Technischer Bestellablauf
Im JTL-Shop kannst du wählen, ob Zahlungen vor oder nach dem Bestellabschluss durchgeführt werden. Du entscheidest, welche Setup am besten zu dir passt, beides hat Vor- und Nachteile.
Zahlung vor Bestellabschluss
Wir empfehlen diese Variante für alle Zahlungsarten zu verwenden, bei denen Zahlung vor Bestellabschluss möglich ist. Wichtig ist dabei, dass der Shop uneingeschränkt für die Webhook-Aufrufe von Mollie erreichbar ist.
Zahlungen laufen damit immer vor dem Bestellabschluss. Damit ist sichergestellt, dass keine unbezahlten Bestellungen entstehen.
Zahlung nach Bestellabschluss
Zahlungen werden damit immer nach Bestellabschluss durchgeführt. Damit ist sichergestellt, dass keine Bestellungen verloren gehen, d.h. es gibt keine Zahlungen ohne eine abgeschlossene Bestellung.
Dabei kann es zu unbezahlten Bestellungen kommen, wenn der Kunde die Zahlung beispielsweise selbst abbricht, oder diese bei Mollie fehlschlägt! Die Bestellungen werden jedoch von der WAWI erstmal nicht abgerufen, wenn die Einstellung "Nur bezahlte Bestellungen in die WAWI übertragen" aktiviert ist.
Sobald die Bestätigung/Autorisierung der Zahlung von Mollie (per Webhook) an den Shop gesendet wird, wird die Bestellung dann auf "bezahlt" gesetzt und für den Abruf durch die WAWI freigegeben.
Mollie Plugin Dashboard
Im Dashboard des Plugins findet man den Einrichtungsassistenten, eine Zusammenfassung der Umsätze, sowie eine Übersicht aller aktiven und inaktiven Zahlungsarten.
Zahlungsarten
Im Tab Zahlungsarten findest du nähere Informationen zu allen Zahlungsarten, die in deinem Mollie Account freigeschaltet sind, sofern diese auch im Plugin integriert sind. Eine vollständige Liste der verfügbaren Zahlungsarten befindet sich in folgendem Artikel: Verfügbare Mollie Zahlungsarten (Liste)
Das Icon in der oberen rechten Ecke zeigt den aktuellen Status der Zahlungsart:
- Grüner Haken: Zahlungsart ist im Shop aktiv
- Gelbes "i": Hinweis/Warnung (durch Hovern wir ein Informationstext angezeigt)
- Rotes X: Zahlungsart ist nicht im Shop aktiv
Durch Klick auf eine bestimmte Zahlungsart öffnet sich die Detailansicht mit weiteren Informationen:
- Durch Klick auf das Zahnrad gelangt man direkt zu den Shop-Einstellungen der jeweiligen Zahlungsart
- Status der Zahlungsart im Mollie Account
- Status der Zahlungsart im JTL Shop
- Zeigt, ob die Zahlungsart mit einer Versandart verknüpft ist
- Empfohlene Konfiguration der Zahlungsart
- Verwendete Mollie-API (inzwischen ausschließlich Payment-API)
- Minimalbetrag der Zahlung
- Maximalbetrag der Zahlung
- Währungen, für welche die Zahlungsart verfügbar ist
Bestellungen per Mollie
Übersicht
Im Tab Bestellungen befindet sich eine Tabelle mit allen Bestellungen, die über Mollie bezahlt wurden.
Hier werden zu jeder Zahlung Informationen, wie u.a. die Bestellnummer, die Mollie-Transaktionsnummer und der Mollie- und JTL-Status angezeigt.
Um einen Webhook durch Mollie zu simulieren, kann unter Aktionen der Status einer Zahlung aktualisiert werden:
Details
Durch Klick auf die Bestellnummer öffnet sich die Detail-Ansicht der Zahlung:
1. Bestelldetails
Alle Infos zu einer einzelnen Bestellung. Weitere Infos findest du auch in deinem Mollie Account.
2. Bestell-Positionen
Die einzelnen Positionen einer Bestellung.
3. Bestellung erstatten/stornieren
Hierüber kann die Zahlung bei Mollie storniert und rückerstattet werden.
4. Refunds
Hier werden veranlasste Rückerstattungen (inklusive ID, Status und Betrag) angezeigt.
Plugin Einstellungen
Zu den Plugineinstellungen kommt man im Plugin-Backend über den Tab Einstellungen
Hier erscheint dann eine Übersichtsseite, über die API Keys eingetragen und weitere Einstellungen getroffen werden können. Die API Key (oder Zugriffstokens) erhältst du in deinem Mollie Account unter:
- Entwickler
- API-Zugriffstokens
Live Key: Trage hier den Live API Key aus dem Mollie-Backend ein (live_...)
Test Key: Trage hier den Test API Key aus dem Mollie-Backend ein (test_...)
Profil ID: Trage hier die Profil ID aus dem Mollie-Backend ein (pfl_...). Dieser wird für die Mollie-Components benötigt.
Test API als Admin: Ist diese Option aktiviert, verwendet man als Shop-Benutzer automatisch die Test-API, wenn man gleichzeitig im JTL Shop Backend angemeldet ist. Um es zu deaktivieren, muss auch die Shop Session gelöscht werden.
Abgeschlossene Bestellungen ausblenden: Ist diese Option aktiviert, werden Bestellungen, die im Shop und bei Mollie abgeschlossen sind, im Plugin-Backend ausgeblendet.
Bestellungen automatisch bei Mollie stornieren: Ist diese Option aktiviert, werden Bestellungen bei Mollie automatisch abgebrochen oder rückerstattet, wenn sie über die WAWI storniert werden. Nur bei komplettem Storno. Teilstornos muss derzeit noch manuell passieren.
Die folgenden zwei Einstellungen sollten nur aktiviert werden, wenn eine Zahlungsart mit Zahlung nach Bestellabschluss verwendet wird. Wir empfehlen für alle Zahlungsarten, wo dies möglich ist, Zahlung vor Bestellabschluss zu aktivieren, damit keine Bestellungen ohne erfolgreiche Zahlung auftreten können. Weitere Informationen findest du hier.
Unbezahlte Bestellungen bei Mollie stornieren: Soll bei fehlgeschlagener Zahlung die Bestellung storniert werden? Angabe in Stunden nach Bestellung. (0 = deaktiviert) Achtung: Gilt nur für Bestellungen, die noch nicht an die WaWi übertragen wurden.
Nur bezahlte Bestellungen in die WAWI übertragen: Ist diese Option aktiviert, werden alle Bestellungen, bis sie bezahlt sind, vor der WAWI versteckt.
___
Achtung: Die Einstellung Versand bei Mollie wurde mit der kommenden Version 2.0 aus dem Plugin entfernt, da die Meldung der Lieferung bei Mollie nicht mehr möglich sein wird.
Hinweis: Durch die Abschaltung der Order- und Shipment-API können keine Versandinformationen mehr an mollie gemeldet werden (z.B.: Sendungsnummer, Trackinglinks, etc.). Dies betrifft jedoch nicht den Status der Bestellung.
Klarna-Zahlungen werden weiterhin automatisch bei mollie "erfasst", sobald die Bestellung versendet wurde und die Einstellung aktiviert ist. Diese nennt sich nun "Captures an Mollie melden". Damit werden die Zahlungen weiterhin nach Versand der Bestellung seitens Klarna ausbezahlt.
Versand bei Molle ( in Zukunft: Captures an Mollie melden ): Sollen die Zahlungen für Klarna und Billie bei Mollie automatisch gecaptured werden? Damit werden die Zahlung bei Mollie abgeschlossen, sobald die Bestellung versendet wurde.
Teilversand Verhalten: Bestimmt das Verhalten, wenn die Zahlung bei Mollie gecaptrued wird. Teilversand von Gast-Bestellungen können entweder direkt, oder erst nach Komplettversand an Mollie weitergegeben werden. Dabei wird bei Mollie immer der gesamte Betrag gecaptured.
Ablaufdatum als Bestellattribut an die WaWi übertragen: Soll das Ablaufdatum von Bestellungen bei Mollie als Bestellattribut an die WaWi übertragen werden (mollieOrderExpirationDate)?
Payment API Beschreibung: Beschreibung der Zahlung in Mollie. Folgende Variablen stehen zur Verfgung: {orderNumber}, {storeName}, {customer.firstname}, {customer.lastname}, {customer.company}
Zahlart bei erneutem Zahlvorgang zurücksetzen: Ist diese Option aktiviert, wird nach einer fehlgeschlagenen Zahlung versucht, die Zahlungsmethode zurück zu setzten, somit hat der Kunde wieder eine größere Auswahl.
Fallback-Locale: Sollte im Shop eine Sprache verwendet werden, die Mollie nicht unterstützt, wird für das Zahlungsportal automatisch diese Einstellung verwendet. Die Sprache ist durch den Kunden im Zahlungsportal anpassbar.
Klarna EID: Von Klarna vergebene und dem Händler bekannte ShopID. Benötigt für die korrekte Checkbox-Verlinkung bei Klarna Zahlarten. Wenn diese nicht bekannt ist, kann sie bei Klarna oder Mollie erfragt werden.
Zahlungserinnerung: Hier kann man einstellen, nach wie vielen Stunden eine Erinnerungsmail mit Zahlungslink an unbezahlte Bestellungen verschickt werden soll. "0" heißt deaktiviert. Die E-Mail-Vorlage kann über den Shop angepasst werden.
Achtung: auch dies ist nur notwendig, wenn Zahlungsarten mit Zahlung nach Bestellabschluss aktiv sind
Kunden bei Mollie anlegen (Customer API): Ist diese Option aktiviert, hat der (registrierte) Kunde die Möglichkeit, per Checkbox, seine Kundendaten bei Mollie zu speichern. Wird z.B. für den Single-Click Checkout benötigt.
Bestellabschluss Weiterleitung:
- Nach 3 Sekunden weiterleiten: Es wird versucht, den Kunden nach 3 Sekunden per Meta-tag weiterzuleiten.
- Direkt weiterleiten: Es wird versucht, den Kunden direkt, per Header-Weiterleitung, weiterzuleiten.
- Nicht weiterleiten: Der Kunde wird nicht automatisch weitergeleitet, und muss zum Zahlen einen Button klicken.
PayPal ID im Zahlungseingang: Welche ID soll bei PayPal-Zahlungen im Zahlungseingang für die WaWi hinterlegt werden?
Abarbeitung der Queue: Alle Vorgänge, die von der WaWi oder Mollie an das Plugin gesendet werden und verarbeitet werden müssen, werden im Plugin in einer Warteschlange (Queue) gespeichert. Daraufhin werden sie schrittweise abgearbeitet.
- Synchron: Die Queue wird vor jedem Shopaufruf serverseitig abgearbeitet. Diese Methode ist sehr zuverlässig, kann aber bei sehr vielen Queue-Einträgen die Ladezeit beeinflussen
- Asynchron: Die Queue wird über asynchrone Aufrufe via Javascript auf der Shopseite abgearbeitet. Diese Methode beeinflusst nicht die Ladezeit der Seite, da die Queue parallel durch einen zweiten "versteckten" Aufruf an den Shop abgearbeitet wird. Wenn die Ausführung des Javascript-Codes durch externe Quellen beeinträchtigt wird, kann es jedoch zu Ausfällen der Aufrufe kommen, wodurch die Abarbeitung der Queue verhindert wird.
Anstoßen der Queue bei jedem X-ten Aufruf: In welchem Intervall soll der Code für die asynchrone Abarbeitung der Queue auf der Shopseite ausgspielt werden? (z.B.: 1 = bei jedem Shopaufruf, 10 = bei jedem 10. Shopaufruf, usw.)
Zahlungsart-Einstellungen
1. Mollie Components (nur Kreditkarte)
Hier kann eingestellt werden, ob die Mollie Components für die Abfrage der Kreditkarten-Daten im Checkout verwendet werden sollen.
2. Mollie Trust Grafik (nur Kreditkarte)
Hier kann eingestellt werden, ob unter den Mollie Components, ein Mollie Badge angezeigt werden soll.
3. API
Mit Plugin-Version 2.0 wird die Order API aus dem Plugin entfernt, da diese von mollie nicht weiter unterstützt wird. Zukünftig werden alle Zahlungen über die Payment API abgehandelt.
Hier kann eingestellt werden, ob die Payment API oder die Order API verwendet werden soll. Nähere Informationen dazu sind hier zu finden: https://docs.mollie.com/orders/why-use-orders
4. Gültigkeit in Tagen
Hier kann eingestellt werden, wann nicht bezahlte, oder autorisierte Zahlungen ablaufen sollen. Nähere Informationen zu Status-Änderungen sind hier zu finden: https://docs.mollie.com/orders/status-changes
5. AGB Checkbox für Klarna anzeigen (nur Klarna)
Für die Zertifizierung bei TrustedShops gibt es die Voraussetzung, die Klarna AGBs im Checkout zu akzeptieren.
Diese Checkbox kann hiermit aktiviert werden. Nähere Information dazu findest du hier: https://developers.klarna.com/static/Trusted_Shops_Guideline_DE_23072015.pdf
Konstanten
Mit Konstanten können kleinere individuelle Einstellungen vorgenommen werden:
- MOLLIE_QUEUE_MAX: Wieviele Tasks sollen pro Frontend-Zugriff maximal abgearbeitet werden. (Standard: 3)
- MOLLIE_REDIRECT_DELAY: Sekunden, nachdem der Kunde zur Zahlung weitergeleitet werden soll (Standard: 3)
- MOLLIE_REMINDER_PROP: Wahrscheinlichkeit der Ausführung der Zahlungserinnerung und (unbezahlte) Bestellstornierung (Standard: 10, bedeutet im Schnitt jeder 10. Aufruf)
- MOLLIE_HOOK_DELAY: Delay in Minuten zur Abarbeitung der WAWI Hooks (Standard: 3)
- MOLLIE_DEFAULT_MAX_EXPIRY_LIMIT: Max. Gültigkeits-Limit für Mollie Zahlungen (Standard: 100)
- MOLLIE_KLARNA_MAX_EXPIRY_LIMIT: Max. Gültigkeits-Limit für Klarna Zahlungen (Standard: 28) Nur anpassen, wenn durch Mollie/Klarna bestätigt.
- MOLLIE_CLEANUP_DAYS: Aufräumen von Queue-Einträgen die älter sind als X Tage. (Standard: 30)
- MOLLIE_CLEANUP_PROP: Wahrscheinlichkeit das Aufräumarbeiten durchgeführt werden. (Standard: 10, im Schnitt, jeder 10er Aufruf. 0 = deaktiviert)
Buchhaltung mit JTL-Shop und Mollie?
PayJoe kann das für dich:
Tags: