Von Alexander LuftJTL Service Partner Gold · Ahrensfelde bei Berlin · 20. November 2025 · 10 Min. Lesezeit
—
seo_title: „JTL Shop PayPal einrichten: Checkout, Webhook und häufige Fehler“
meta_description: „PayPal im JTL Shop 5 einrichten — welches Plugin, wie der Webhook konfiguriert wird und welche Fehler dabei am häufigsten auftreten. Praxisanleitung von Vlarom.“
slug: jtl-shop-paypal-einrichten
focus_keyphrase: „JTL Shop PayPal einrichten“
category: ANLEITUNG
featured_image: WP Image ID 3439
wp_post_id: 3440
status: publish
—
JTL Shop PayPal einrichten: Checkout, Webhook und häufige Fehler
PayPal gehört in Deutschland zu den meistgenutzten Zahlungsarten im Online-Handel. Für JTL-Shop-Betreiber ist die Einrichtung deshalb kein optionales Thema — sondern ein Muss. Was dabei schiefgeht, warum Webhooks so wichtig sind und wie du PayPal Checkout sauber in JTL Shop 5 integrierst, erklärt diese Anleitung.
Welches PayPal-Plugin für JTL Shop 5?
JTL Shop 5 nutzt das offizielle PayPal Checkout Plugin — nicht mehr das alte PayPal Standard oder PayPal Plus. Seit PayPal Plus Ende 2023 abgekündigt wurde, ist PayPal Checkout die einzige unterstützte Variante für neue Installationen.
Das Plugin findest du im JTL Extension Store. Es deckt alle relevanten Zahlarten in einem Plugin ab: PayPal, Kreditkarte, Lastschrift, Ratenzahlung, Bezahlen nach 30 Tagen und lokale Zahlarten wie Sofort oder Giropay.
Voraussetzungen vor der Installation
Bevor du anfängst, solltest du folgendes bereit haben:
- PayPal Business-Konto mit verifizierten Bankdaten und aktivierten Zahlungsarten
- JTL Shop 5.1.2 oder höher — ältere Versionen werden vom Plugin nicht unterstützt
- API-Zugangsdaten aus dem PayPal Developer Dashboard (Client ID + Secret)
- SSL-Zertifikat — PayPal akzeptiert keine unsicheren HTTP-Verbindungen
JTL Shop PayPal einrichten: Schritt für Schritt
1. Plugin installieren
Im JTL Shop Backend unter Zahlungsarten → Plugins das PayPal Checkout Plugin installieren und aktivieren.
2. API-Zugangsdaten hinterlegen
Im PayPal Developer Dashboard unter Apps & Credentials eine neue App anlegen. Client ID und Secret kopieren — diese kommen ins Plugin unter Konfiguration → API-Einstellungen.
3. Webhook konfigurieren
Dieser Schritt wird am häufigsten übersprungen — und ist die häufigste Fehlerquelle. Der Webhook-Endpunkt deines Shops muss in PayPal hinterlegt werden, damit Zahlungsbestätigungen, Rückbuchungen und Rückerstattungen automatisch in JTL Shop ankommen.
Die Webhook-URL deines Shops lautet in der Regel: https://deinshop.de/[plugin-endpoint]
Du findest die genaue URL im Plugin unter Konfiguration → Webhook. Dort trägst du sie in PayPal unter Webhooks → Add Webhook ein und wählst mindestens folgende Events:
- PAYMENT.CAPTURE.COMPLETED
- PAYMENT.CAPTURE.DENIED
- CHECKOUT.ORDER.APPROVED
4. Sandbox zuerst testen
PayPal stellt eine Sandbox-Umgebung bereit. Vor dem Live-Gang solltest du mindestens einen vollständigen Bestellvorgang mit einem PayPal Sandbox-Konto durchspielen — inklusive Bestätigung und Webhook-Empfang.
5. Live schalten und überwachen
Nach erfolgreichem Sandbox-Test API-Modus auf Live umstellen. Ersten echten Testauftrag mit echtem PayPal-Konto durchführen und prüfen ob die Bestellung in JTL Shop korrekt als bezahlt markiert wird.
Häufige Fehler beim JTL Shop PayPal einrichten
Bestellungen bleiben auf „Offen“
Ursache in fast allen Fällen: Der Webhook ist nicht konfiguriert oder die Webhook-URL ist falsch eingetragen. JTL Shop erfährt ohne Webhook nicht, dass die Zahlung bei PayPal erfolgreich war. Prüfe im PayPal Developer Dashboard ob der Webhook aktiv ist und ob Ereignisse ankommen.
Kreditkartenzahlung erscheint nicht als Option
PayPal muss Kreditkartenzahlungen für dein Konto explizit freischalten. Das passiert nicht automatisch. Im PayPal Business-Konto unter Kontoeinstellungen → Zahlungsarten prüfen ob Kreditkarte aktiviert ist.
Ratenzahlung und Bezahlen nach 30 Tagen fehlen
Diese Zahlungsarten setzt PayPal erst nach einer internen Prüfung des Händlerkontos frei. Neues Konto oder zu geringes Transaktionsvolumen kann dazu führen, dass diese Optionen noch nicht verfügbar sind.
Plugin-Update bricht bestehende Konfiguration
Nach Plugin-Updates müssen Webhook-URLs gelegentlich neu eingetragen werden, weil sich der Endpunkt ändert. Beim nächsten Update immer prüfen ob der Webhook noch korrekt registriert ist.
Welche Zahlungsarten stehen im JTL-Shop PayPal Plugin zur Verfügung?
Das PayPal Checkout Plugin ist kein reines PayPal-Konto-Plugin mehr. Es bündelt ein ganzes Sortiment an Zahlungsarten, die du gezielt ein- und ausschalten kannst. Das ist der größte Unterschied zu älteren Plugins wie PayPal Standard oder PayPal Plus, die jeweils nur einzelne Methoden abgedeckt haben.
Im Reiter Aktivierte Zahlungsarten im Plugin-Backend steuerst du per Schieberegler, welche Methoden dein Shop anzeigt:
- PayPal-Konto — die klassische Zahlung mit Login, beliebteste Methode in Deutschland
- Kreditkarte / Debitkarte — direkter Karteneintrag ohne PayPal-Login (Advanced Card Payments, inkl. 3D Secure)
- SEPA-Lastschrift — für Kunden ohne PayPal-Konto, besonders bei B2C-Stammsortiment
- Ratenzahlung — PayPals eigene Buy-now-pay-later-Option, wird separat von PayPal für dein Konto freigeschaltet
- Später bezahlen — Rechnungskauf über Ratepay, einmalige Transaktion ohne echte Ratenzahlung
- Apple Pay — digitale Wallet, erfordert eine zusätzliche Domain-Verifizierung bei PayPal
- Lokale Zahlarten — Sofort (Klarna), Giropay, iDEAL und weitere länderspezifische Methoden
Nicht alle Zahlarten müssen gleichzeitig aktiviert sein. Ein häufiges Muster in der Praxis: Shops haben sieben Optionen aktiv, die Hälfte davon ist für die eigene Zielgruppe nicht relevant. PayPal selbst weist in der Dokumentation darauf hin, dass die Anzahl der Zahlmethoden die Checkout-Konversion beeinflusst — weniger Optionen, die zum Zielmarkt passen, schneiden erfahrungsgemäß besser ab als vollständig aufgefächerte Listen.
Die Verfügbarkeit einzelner Zahlarten hängt außerdem vom Land des Shop-Besuchers ab. Welche Methoden in welchem Land gelten, dokumentiert JTL im offiziellen Guide zur PayPal Checkout Detailbeschreibung.
Webhook in PayPal hinterlegen: So kommen Zahlungsbestätigungen an
Der Webhook ist die Verbindung zwischen PayPal und deinem Shop. Ohne ihn erfährt JTL Shop nicht, ob eine Zahlung wirklich abgeschlossen wurde — Bestellungen bleiben auf „Offen“ stecken, auch wenn der Käufer längst bezahlt hat.
Das ist der mit Abstand häufigste Fehler, den wir bei neu eingerichteten PayPal-Integrationen sehen. Ein Händler im JTL-Forum beschreibt es so: „Kunden berichten, dass eine Bestellung mit PayPal nicht zurück zum Shop leitet — generell kommen aber die ganze Zeit auch Bestellungen per PayPal rein.“ Sporadische Lücken bei Bestellbestätigungen, obwohl PayPal Zahlungen eingeht: das ist fast immer ein Webhook-Problem.
Webhook-URL in JTL Shop finden
Die URL steht direkt im Plugin: Plugins → JTL PayPal Checkout → Einstellungen → Tab „Webhooks“. Dort siehst du Webhook-Typ, URL, Registrierungsstatus und ob der Webhook aktiv ist. Wenn dort „nicht installiert“ steht, auf Registrieren klicken.
Webhook im PayPal Developer Dashboard eintragen
Falls die automatische Registrierung nicht greift (passiert nach Migrationen oder Domain-Wechseln), trägst du die URL manuell ein:
- Im PayPal Developer Dashboard unter Apps & Credentials die passende App öffnen
- Bereich Webhooks aufrufen → Add Webhook
- Webhook-URL eintragen (aus dem Plugin-Tab kopieren)
- Folgende Events aktivieren:
PAYMENT.CAPTURE.COMPLETED,PAYMENT.CAPTURE.DENIED,CHECKOUT.ORDER.APPROVED
Webhook testen
Nach dem Eintragen im Developer Dashboard unter Webhooks → Simulate ein PAYMENT.CAPTURE.COMPLETED Event abfeuern. JTL Shop sollte die Anfrage empfangen und im Event-Log vermerken. Wenn nichts ankommt: Firewall-Regeln oder den Hosting-Provider prüfen — manche Anbieter blockieren eingehende PayPal-Requests.
Ein Sonderfall betrifft dritte Zahlarten wie iDEAL oder Sofort: Wenn Bestellungen über diese Methoden fehlen obwohl die Zahlung erfolgte, hilft es, die Option Capture aktivieren im Plugin für Third-Party-Zahlarten zu setzen. Das stellt sicher, dass der Betrag auch serverseitig bestätigt wird.
Von PayPal Plus zu PayPal Checkout: Was sich ändert
PayPal Plus wurde Ende 2023 eingestellt. Wer noch das alte Plugin betreibt, bekommt keine Updates mehr und riskiert Kompatibilitätsprobleme mit neuen JTL-Shop-Versionen.
Die Migration ist kein komplizierter Prozess, aber sie erfordert einen sauberen Schnitt. Das ist kein Update des alten Plugins, sondern ein Austausch.
Was sich konkret ändert:
- Altes Plugin deaktivieren: PayPal Plus im Backend deaktivieren, bevor das neue Plugin installiert wird. Beide gleichzeitig aktiv führt zu doppelten Zahlungsoptionen und Konfigurationskonflikten.
- Neue API-Zugangsdaten: PayPal Plus nutzte die klassische NVP/SOAP-API mit Benutzername, Passwort und Signatur. PayPal Checkout arbeitet mit OAuth 2.0: Client ID und Client Secret aus dem Developer Dashboard. Die alten Zugangsdaten funktionieren im neuen Plugin nicht.
- Ein Plugin statt mehrerer: PayPal Plus war oft in Kombination mit separaten Plugins für Ratenzahlung oder Kreditkarte installiert. All das übernimmt PayPal Checkout in einem Plugin.
Der häufigste Fehler dabei: alte API-Keys weiter verwenden. Händler kopieren die alten Zugangsdaten ins neue Plugin und wundern sich über den Fehler „Could not authenticate“. Im PayPal Developer Dashboard unter Apps & Credentials → Create App eine neue App anlegen — die liefert die richtigen OAuth-Credentials für PayPal Checkout.
Nach dem Wechsel unbedingt den Webhook neu registrieren. Der Endpunkt ändert sich durch das neue Plugin, ein veralteter Webhook-Eintrag in PayPal führt sonst wieder zu den bekannten Bestellproblemen.
Häufige Fragen zur PayPal-Einrichtung im JTL Shop
Wie richte ich das JTL PayPal Checkout Plugin ein?
Das aktuelle JTL PayPal Checkout Plugin gibt es über den JTL Extension Store, installiert wird es unter Plugins > Meine Käufe. Den Verbindungsschritt findet man unter Plugins > Installierte Plugins > JTL PayPal Checkout: Testmodus deaktivieren, dann auf „JTL-Shop jetzt mit PayPal verbinden“ klicken. Das Onboarding läuft automatisch: einmal bei PayPal authentifizieren und die notwendigen Berechtigungen erteilen. Danach die PayPal-Zahlungsarten unter Administration > Versand > Versandarten jeder Versandoption zuordnen. Schlägt das automatische Onboarding fehl, geht der manuelle Weg über Merchant ID, Client ID und Client Secret. Wir helfen gerne, wenn es dabei hakt.
Warum schlägt die PayPal-Zahlung im JTL Shop fehl?
Die häufigste Ursache für „Die Zahlung konnte nicht verarbeitet werden“ ist ein Konflikt mit einer alten PayPal Plus-Registrierung. Wer früher PayPal PLUS genutzt hat, muss diese Registrierung über ein PayPal-Support-Ticket aktiv löschen lassen — sonst blockiert sie das neue Checkout-Plugin. Ein zweiter häufiger Auslöser sind doppelte Bestellnummern nach einem Shop-Neuaufbau oder einer Migration: Das System lehnt bekannte Bestellnummern ab. Der Log-Eintrag OrderCaptureResponseFailed weist auf genau diese Fälle hin. Bei der Vlarom E-Commerce Agentur prüfen wir bei solchen Fehlern immer zuerst das Shop-Log unter Logs > Plugin-Logs, bevor wir weitere Schritte einleiten.
Was tun bei PayPal-Webhook-Fehlern in JTL Shop?
Webhook-Fehler im JTL PayPal Checkout Plugin zeigen sich meist als loadWebhook failed oder createWebhook failed: Invalid data provided im Shop-Log. Die häufigste Ursache ist überraschend einfach: In der Konfigurationsdatei config.JTL-Shop.ini.php fehlt das „s“ bei der Shop-URL, also http:// statt https://. Ein korrekter SSL-Eintrag behebt das Problem sofort. Daneben hilft es, im Plugin-Tab Webhook den bestehenden Webhook zu löschen und neu zu registrieren. Sandbox-Webhooks aus der Testphase vorher ebenfalls entfernen, da sie manchmal die Produktiv-Verbindung blockieren. Den Shop-Cache danach vollständig leeren.
PayPal Standard, PLUS oder Checkout — welche Variante für JTL Shop?
PayPal PLUS und PayPal Standard sind veraltete Integrationen, die JTL nicht mehr aktiv weiterentwickelt. Das aktuelle JTL PayPal Checkout Plugin ersetzt beide und deckt deutlich mehr ab: Smart-Payment-Buttons, Ratenzahlung über „Später bezahlen“, Apple Pay, Kreditkartenzahlung ohne PayPal-Konto und lokale Zahlungsarten für internationale Käufer. Wer noch PayPal PLUS betreibt: PayPal hat PLUS offiziell abgekündigt, ein Wechsel ist fällig. Beim Wechsel gilt: Neue Zahlungsarten im Checkout-Plugin erst aktivieren, dann das alte Plugin deaktivieren. Sonst entstehen kurze Ausfälle im Checkout. Wir begleiten diesen Wechsel regelmäßig bei Kundenprojekten.
Wie aktualisiere ich PayPal-Token im JTL Shop nach Ablauf?
Das JTL PayPal Checkout Plugin verwaltet die API-Zugangsdaten über das automatische Onboarding. Ein manuelles Token-Management wie beim alten PayPal Basic entfällt für die meisten Shops damit komplett. Treten trotzdem Token-Fehler auf (invalid token im Log), liegt das Onboarding oft nicht korrekt abgeschlossen vor. In diesem Fall: Im Plugin unter Zugangsdaten den Verbindungsstatus prüfen, die Verbindung trennen und den Onboarding-Prozess erneut durchlaufen. Alternativ lassen sich Merchant ID, Client ID und Client Secret manuell aus dem PayPal Developer Dashboard eintragen. Danach den Shop-Cache vollständig leeren und einen Testkauf mit einem PayPal-Sandbox-Konto durchführen.
Quellen: PayPal-Plugin installieren und konfigurieren — JTL-Guide · Detailbeschreibung: JTL PayPal Checkout — JTL-Guide · JTL-Forum: PayPal Checkout Fehler · JTL-Forum: Webhooks erstellen · JTL-Forum: Invalid Token
Häufige Fragen zu PayPal in JTL-Shop
PayPal einrichten lassen
Wer die Einrichtung lieber delegiert: Als JTL Service Partner Gold übernehmen wir die komplette PayPal-Integration — Plugin-Installation, API-Konfiguration, Webhook-Setup und Testphase. Der Aufwand hängt von Zahlarten-Konfiguration, Sandbox-Umfang und bestehenden Plugin-Konflikten ab — eine Einschätzung gibt es nach dem Erstgespräch.
