Alexander LuftVon Alexander Luft
JTL Service Partner Gold · Ahrensfelde bei Berlin · 29. August 2025 · 8 Min. Lesezeit
JTL-Shop-Backend mit Mollie-Plugin-Einstellungen, Mollie-Dashboard mit API-Key auf der rechten Seite

Mollie im JTL-Shop einrichten: API-Key, Profil-ID, Zahlarten und die häufigsten Fehler

Mollie ist für viele JTL-Shop-Betreiber der pragmatische Weg, mehrere Zahlarten ohne Vertragslaufzeit und ohne Grundgebühr anzubieten. Kreditkarte, SEPA, iDEAL, Klarna, Bancontact: alles über einen Anbieter. Die Einrichtung ist auf dem Papier schnell erledigt. In der Praxis hängt sie regelmäßig an drei Stellen: der API-Key wird falsch hinterlegt, die Profil-ID fehlt, oder die Zahlarten erscheinen einfach nicht im Checkout. Wer das vorher weiß, spart sich den Forum-Marathon.

Du willst Mollie im JTL-Shop sauber zum Laufen bringen ohne dich durch dutzende Helpdesk-Artikel zu klicken?

Dieser Beitrag zeigt dir den Ablauf so wie wir ihn in unseren JTL-Shop-Projekten durchführen — inklusive der Stolpersteine, die wir aus jeder zweiten Einrichtung kennen.

Auf einen Blick

  • ✓Wir richten Mollie regelmäßig im JTL-Shop ein: Die häufigste Fehlerursache ist nicht das Plugin, sondern die fehlende Verknüpfung der Mollie-Zahlarten mit den Versandarten im JTL-Backend.
  • ✓Mollie deckt Kreditkarte, SEPA-Lastschrift, PayPal, iDEAL, Bancontact, SOFORT und Klarna über eine einzige Integration ab. Wenn ein Händler schnell mehrere Zahlarten ohne Mehrfach-Verträge braucht, ist Mollie meist der direkteste Weg — wir sehen das in unseren JTL-Shop-Projekten regelmäßig.
  • ✓Pflicht: gültiger API-Key (Live + Test), Profil-ID beginnend mit pfl_, Webhook-URL erreichbar von außen. Fehlt eines davon, erscheinen die Zahlarten im Checkout nicht oder Bestellungen kommen in der Wawi als pm_mollie statt mit konkreter Zahlart an.

Eine Zahlart-Integration ist nie ein reines Plugin-Thema. Als JTL Service Partner Gold aus Ahrensfelde bei Berlin haben wir Mollie in JTL-Shop-5-Setups verschiedenster Größe eingerichtet: vom B2C-Onlineshop mit drei Zahlarten bis zum europäischen Multi-Country-Setup mit iDEAL für die Niederlande und Bancontact für Belgien. Was sich in jedem Projekt zeigt: Die fünf Minuten Plugin-Klick sind das eine, die saubere Konfiguration im Mollie-Dashboard, im Shop-Backend und in der Wawi-Zahlartenzuordnung das andere.

Mollie im JTL-Shop einrichten: die 5 Schritte

Das ist der Ablauf, wie wir Mollie in JTL-Shop-Projekten einrichten. Die Reihenfolge ist nicht beliebig: Wer Schritt 2 überspringt und gleich live geht, kämpft danach mit Zahlarten, die im Checkout fehlen oder Buchungen, die in der Wawi nicht zuzuordnen sind. Der Setup-Aufwand hängt von der Anzahl der gewünschten Zahlarten und der Komplexität deines Versandarten-Setups ab. Plane zusätzlich die Mollie-eigene Freischaltzeit für jede Zahlart ein (laut Mollie ein bis drei Werktage) — diese steuert Mollie, nicht das Plugin. Wer parallel Bestellverkehr fährt, sollte den Wechsel auf Mollie außerhalb der Stoßzeiten planen. Am ruhigsten läuft es Sonntagabend, wenn ein Hick-Up im Checkout am wenigsten Umsatz kostet.

Mollie-Account anlegen und Zahlarten freischalten

Lege einen kostenfreien Mollie-Account an. Im Mollie-Dashboard unter ‚Einstellungen → Zahlungsmethoden‘ aktivierst du jede Zahlart einzeln. Wichtig: Mollie schaltet einige Zahlarten erst nach Prüfung deiner Geschäftsdaten frei. Kreditkarte, Klarna und SEPA brauchen meistens 1-3 Werktage. Häufigster Fehler: Plugin wird installiert, bevor die Zahlarten im Mollie-Backend aktiv sind. Folge: Im Shop-Checkout erscheint nichts.

Mollie-Plugin im JTL-Extension-Store kaufen und installieren

Das Mollie-Plugin für JTL-Shop 5 findest du im offiziellen JTL-Extension-Store. Nach Kauf wird es automatisch im Plugin-Bereich deines Shops verfügbar. Lade es im JTL-Shop-Backend unter ‚Plugins → Übersicht‘ und klicke auf ‚Installieren‘. Tipp: Vor der Installation ein Backup der Datenbank, weil Plugin-Installationen Tabellenstruktur ändern und Rollback ohne Backup aufwändig ist.

API-Key und Profil-ID aus dem Mollie-Dashboard übertragen

Im Mollie-Dashboard findest du unter ‚Entwickler → API-Keys‘ zwei Schlüssel: einen Test-Key (beginnend mit test_) und einen Live-Key (beginnend mit live_). Beide trägst du im Plugin-Backend des JTL-Shops ein. Zusätzlich brauchst du die Profil-ID — sie beginnt mit pfl_ und steht im Mollie-Dashboard unter ‚Einstellungen → Webseiten‘. Pflichtfeld: Ohne Profil-ID funktionieren die Mollie-Components (Kreditkarteneingabe ohne Weiterleitung) nicht — die Eingabefelder bleiben grau.

Zahlarten mit Versandarten verknüpfen (der vergessene Schritt)

Das ist der Schritt, der in den meisten gescheiterten Einrichtungen fehlt. Im JTL-Shop-Backend gehst du zu ‚Storefront → Kaufabwicklung → Versandarten‘ und ordnest jede Mollie-Zahlart explizit den Versandarten zu. Ohne diese Zuordnung erscheint die Zahlart im Checkout nicht. Das Plugin meldet keinen Fehler, der Kunde sieht aber nichts. Die generische Mollie-Zahlart darf NICHT mit Versandarten verknüpft werden, sie ist nur ein technischer Rahmen. Quelle: WebStollen-Helpdesk Mollie-Dokumentation.

Webhook prüfen, Test-Bestellung durchführen, Live schalten

Mollie sendet Zahlungs-Status-Updates über einen Webhook an deinen Shop zurück. Die Webhook-URL wird vom Plugin automatisch generiert, sie muss aber von außen erreichbar sein. Wenn dein Hosting eine Firewall oder eine BasicAuth-Sperre hat, schlägt der Webhook lautlos fehl, und Bestellungen bleiben im Status ‚wartend‘. Führe eine Test-Bestellung mit Test-API durch (sichtbar nur für eingeloggte Backend-Nutzer), prüfe ob der Status nach Zahlung auf ‚paid‘ wechselt. Erst danach den Live-API-Key aktivieren. Pflicht-Hinweis: Ein Backup vor jedem Wechsel von Test auf Live, weil die Datenbank-Felder umgeschrieben werden. Nach dem Live-Gang die ersten echten Bestellungen aktiv beobachten — Logfiles in Plugin und Mollie-Dashboard parallel offen halten, damit eventuelle Webhook-Fehler in den ersten Stunden auffallen und nicht erst durch eine Kunden-E-Mail am nächsten Morgen bekannt werden.

Häufige Fragen zur Mollie-Einrichtung im JTL-Shop

Warum erscheinen Mollie-Zahlarten nicht im Checkout meines JTL-Shops?

In neun von zehn Fällen liegt es an einer fehlenden Verknüpfung der Zahlart mit der Versandart im JTL-Shop-Backend unter ‚Storefront → Kaufabwicklung → Versandarten‘. Weitere Ursachen: Die Zahlart ist im Mollie-Dashboard noch nicht aktiviert (manche brauchen 1-3 Werktage Freischaltung), bei aktivem JTL-PayPal-Plugin müssen Mollie-Zahlarten zusätzlich in der PayPal-Paywall aktiviert werden, oder es läuft noch ein Test-API-Key, denn im Test-Modus sind Zahlarten nur für eingeloggte Backend-Nutzer sichtbar. Quelle: WebStollen-Helpdesk.

Die Profil-ID ist eine Mollie-interne Kennung deiner Webseite und beginnt immer mit pfl_. Diese Kennung steht im Mollie-Dashboard unter ‚Einstellungen → Webseiten‘. Pflicht ist sie, sobald du Mollie-Components nutzen willst, also Kreditkarteneingabe direkt im Checkout ohne Weiterleitung auf eine Mollie-Seite. Wird sie falsch oder gar nicht eingetragen, bleiben die Eingabefelder im Checkout grau und der Kunde kann keine Kartendaten eingeben. Für reine Weiterleitungs-Zahlarten wie SEPA oder Sofort ist sie nicht zwingend erforderlich, wir tragen sie aber grundsätzlich ein, um spätere Erweiterungen vorzubereiten.

Das ist ein bekanntes Verhalten und liegt nicht an einem Konfigurationsfehler — Mollie überträgt zur Wawi standardmäßig die Sammel-Zahlart pm_mollie statt der vom Kunden gewählten Methode. Die konkrete Methode siehst du in der Wawi unter ‚Zahlungen → Zugewiesene Zahlungen‘ oder direkt im Mollie-Dashboard. Ein Händler im JTL-Forum: „Die Zahlungen werden als pm_mollie übertragen. Erst unter Zahlungen — Zugewiesene Zahlungen sehe ich welche Zahlungsmethode der Kunde gewählt hat.“ Wer das auflösen will, baut sich einen JTL-Workflow, der über die Mollie-API die echte Zahlart abfragt und das Bestellfeld nachträglich überschreibt. Wir setzen solche Workflows bei Bedarf auf — in der Toolbox der Vlarom E-Commerce Agentur liegt dafür eine Standard-Vorlage, die wir auf das jeweilige Setup zuschneiden und die die Wawi-Zahlartzuordnung sauber differenziert.

Für deutschen B2C-Handel sind Kreditkarte, SEPA-Lastschrift, PayPal und Klarna (Pay Later, Sofort bezahlen, Ratenkauf) die Pflicht-Auswahl. Bei niederländischen Kunden ist iDEAL nahezu Pflicht, bei belgischen Kunden Bancontact. Apple Pay lohnt sich, wenn die Zielgruppe mobil-affin ist — die Conversion-Rate auf mobilen Geräten ist mit Apple Pay messbar höher. Wichtig: Jede Zahlart muss separat im Mollie-Dashboard freigeschaltet UND im JTL-Shop einer Versandart zugewiesen werden. Die offizielle Mollie-Dokumentation zur Anbindung an JTL-Wawi steht unter guide.jtl-software.com.

Mollie ist ein Payment Service Provider (PSP), also ein Sammelanbieter, der dir mehrere Zahlarten über eine einzige Integration zur Verfügung stellt, einschließlich Klarna. Klarna direkt ist ein spezialisierter Anbieter mit eigenem JTL-Plugin, eigener Vertragsstruktur und meist günstigeren Konditionen, aber nur für die Klarna-Zahlarten (Pay Later, Sofort, Ratenkauf). Praktischer Vorteil von Mollie: ein Plugin, ein Vertrag, alle Zahlarten. Praktischer Vorteil von Klarna direkt: niedrigere Transaktionsgebühren bei reinem Klarna-Volumen. Mollie ist meist dann die ruhigere Wahl, wenn ein Händler den Aufwand eines zweiten Vertrags vermeiden will und die Klarna-Volumina noch überschaubar sind — wir gehen in unseren Projekten genau diesen Weg.

Symptom: Bestellungen bleiben im Status ‚wartend‘ obwohl der Kunde im Mollie-Dashboard als bezahlt geführt wird. Ursache ist fast immer eine externe Erreichbarkeits-Sperre: Hosting-Firewall, BasicAuth-Schutz auf der Live-Domain, .htaccess-Regel oder eine WAF beim Managed-Hosting. Test: Rufe die Webhook-URL aus dem Plugin manuell im Browser auf — Mollie erwartet einen HTTP-200. Wenn 401 oder 403 zurückkommt, sperrst du Mollie aus. Lösung: Webhook-Pfad explizit von BasicAuth ausnehmen, oder die Mollie-IP-Adressen freigeben. Die Liste der Mollie-IPs ändert sich gelegentlich, daher empfehlen wir eine Pfad-Ausnahme statt einer IP-Whitelist. Bei Managed-Hostings mit aktiver Web Application Firewall lohnt es sich, einmal mit dem Hosting-Support zu klären, ob die Webhook-Route auf einer separaten Whitelist landen kann — das spart spätere Diskussionen, wenn ein WAF-Update plötzlich Mollie-Anfragen blockt.

Ja, das ist sogar der häufigste Fall in unseren Projekten. Wichtig dabei: Wenn du gleichzeitig das offizielle JTL-PayPal-Checkout-Plugin nutzt, übernimmt PayPal die Steuerung der Paywall im Checkout. Du musst dann jede Mollie-Zahlart zusätzlich in der PayPal-Paywall-Konfiguration freischalten, sonst werden sie ausgeblendet. Außerdem: Betreibe Klarna nicht über zwei Wege gleichzeitig. Wenn neben Mollie-Klarna noch ein separates Klarna-Plugin eines Drittanbieters aktiv ist, konkurrieren zwei Integrationen um dieselbe Zahlart — in der Praxis führt das zu Anzeigefehlern im Checkout. Entscheide dich für einen Weg und deaktiviere den anderen.

Mollie sauber einrichten ohne Forum-Marathon? Wir übernehmen das Setup für dich.

Mollie im JTL-Shop — von Vlarom professionell eingerichtet.

Seit über 10 Jahren begleiten wir als JTL Service Partner Gold mittelständische Händler beim Aufbau und der Pflege ihrer JTL-Shops. Mollie-Einrichtung gehört zu den häufigsten Aufgaben in unserem Tagesgeschäft. Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular für eine unverbindliche Erstanalyse.