JTL PayPal Zahlungsabgleich funktioniert nicht — das steckt dahinter und so gehst du vor

Auf einen Blick

• ✓Der JTL PayPal Zahlungsabgleich bricht seit März 2025 bei vielen Händlern ab, weil das interne Datenbankfeld `cReferenz` in älteren Wawi-Versionen auf maximal 50 Zeichen begrenzt ist — PayPal übergibt seit einem API-Update aber längere Referenzwerte. Wir als Vlarom E-Commerce Agentur haben dieses Problem in mehreren Kundenprojekten identifiziert und eingegrenzt.
• ✓Die interne Fehlermeldung lautet „string or binary data would be truncated“ — sie erscheint ausschließlich im Fehlerlog unter logs/, nicht im Wawi-Interface. Deshalb glauben viele Händler, der Abgleich laufe normal, während die Zahlungen tatsächlich lautlos abgebrochen werden und in den Kontobewegungen fehlen.
• ✓Fix laut JTL-Ticket WAWI-78802 (Status: Gelöst): JTL-Wawi auf Version 1.9.8.0 oder neuer aktualisieren — JTL hat das `cReferenz`-Feld dort auf eine ausreichend große Länge angepasst. Vor dem Update ist ein vollständiges Datenbank-Backup Pflichtschritt, danach genügt ein erneuter manueller Abgleich.

Dieses Problem ist tückisch, weil es sich nicht als klarer Fehler zeigt. Der Abgleich läuft scheinbar durch, die Statusanzeige wirkt unauffällig — und trotzdem kommen keine Zahlungen an. Als JTL Service Partner Gold aus Ahrensfelde bei Berlin hat die Vlarom E-Commerce Agentur diesen Fehler in der Praxis gesehen und kann klar sagen: Die Ursache liegt nicht bei PayPal, nicht bei der API-Konfiguration und nicht beim Netzwerk. Das Problem steckt in einem internen Datenbankfeld das für längere Referenzwerte nicht ausgelegt war. Wer das nicht weiß, sucht tagelang an der falschen Stelle.

Das Problem mit dem JTL PayPal Zahlungsabgleich ist kein Einzelfall. Kurz nach dem 20. März 2025 häuften sich im JTL-Forum Meldungen von Händlern mit identischen Symptomen: PayPal-Zahlungen ankommen, aber nicht in den Kontobewegungen erscheinen. Das macht das Problem zu einem der meistdiskutierten Zahlungsabgleich-Themen des Frühjahrs 2025 im JTL-Ökosystem.

Quelle JTL-Ticket WAWI-78802: Titel „Interne Länge vom Feld cReferenz nicht ausreichend“ — Status: Gelöst. Das Ticket dokumentiert, dass PayPal-Referenzwerte die interne NVARCHAR(50)-Feldgrenze überschreiten und damit den Zahlungsimport unterbrechen.

Was das Problem in der Praxis bedeutet:

• →Datum des ersten Auftretens: Ab dem 20. März 2025 — zeitgleich mit einem PayPal-API-Update das längere Referenzwerte einführte
• →Betroffene Wawi-Versionen: Alle Versionen vor 1.9.8.0, in denen das `cReferenz`-Feld auf NVARCHAR(50) begrenzt ist
• →Sichtbarkeit des Fehlers: Nur im Fehlerlog unter logs/ — kein Hinweis im Wawi-Interface selbst
• →Verlust der Daten: Keine — PayPal-Zahlungen bleiben im PayPal-Konto erhalten und lassen sich nach dem Fix nachholen

Der Fehler ist dokumentiert, gelöst und das Update verfügbar. Wer die Symptome kennt, kann das Problem schnell eingrenzen.

Nicht jeder Fehler beim PayPal-Abgleich hat dieselbe Wurzel. Aus der Praxis lassen sich zwei Muster klar unterscheiden — und das macht einen erheblichen Unterschied bei der Behebung. Das erste Muster betrifft fast alle Händler die seit März 2025 Probleme haben. Das zweite ist seltener, aber ebenfalls relevant wenn das Update allein nicht hilft.

Wichtig vorab: Beide Probleme haben nichts damit zu tun, ob PayPal korrekt angebunden ist. Die Verbindung steht in beiden Fällen — das Problem liegt tiefer.

primary

Zu langer Verwendungszweck — Datenbankfeld `cReferenz` zu kurz

PayPal übergibt bei jedem importierten Zahlungsvorgang eine Referenz — die sogenannte Invoice-ID oder Transaktionsreferenz. Diese Referenz wird in JTL-Wawi in das Datenbankfeld `cReferenz` geschrieben. In älteren Wawi-Versionen ist dieses Feld auf 50 Zeichen begrenzt (NVARCHAR(50)). Das war lange kein Problem, weil PayPal kürzere Referenzwerte sendete.

Seit einem PayPal-API-Update im Frühjahr 2025 sind diese Referenzwerte länger — teils 54 Zeichen oder mehr. Das führt zur internen SQL-Fehlermeldung „string or binary data would be truncated“. Der Import bricht an dieser Stelle ab. Keine Meldung im Wawi-Interface, kein sichtbarer Fehler — die Zahlungen erscheinen einfach nicht in den Kontobewegungen. Quelle: JTL-Ticket WAWI-78802 (Issue-Tracker, Status: Gelöst).

muted

PayPal-Zugangsdaten abgelaufen oder Verbindung unterbrochen

Ein zweiter, weniger häufiger Grund: Die gespeicherten PayPal-Zugangsdaten — API-Username, Passwort und Signatur — sind abgelaufen oder wurden auf PayPal-Seite geändert. Das passiert zum Beispiel nach einem Passwort-Reset oder wenn PayPal aus Sicherheitsgründen API-Credentials zurücksetzt.

In diesem Fall startet der Abgleich gar nicht erst oder bricht sofort ab. Der Unterschied zur `cReferenz`-Ursache: Bei abgelaufenen Zugangsdaten erscheint in der Regel eine Fehlermeldung im Abgleich-Dialog — beim Feldlängen-Problem dagegen keine sichtbare Rückmeldung. Prüfen lässt sich das über den JTL-Guide-Artikel zur PayPal-Anbindung.

Vollständige Kontobewegungen in JTL-Wawi

Nach dem Update auf 1.9.8.0 oder neuer laufen alle PayPal-Zahlungen wieder vollständig in die Kontobewegungen ein — einschließlich der farblichen Markierung im Zahlungsbereich, die vorher ebenfalls fehlte. Händler aus dem JTL-Forum berichten: mit dem Update liefen auch die zuvor fehlenden Zahlungen nach, sobald ein erneuter Abgleich gestartet wurde.

Weniger manueller Aufwand bei der Zahlungszuordnung

Wer den Fehler wochen- oder monatelang hatte, musste Zahlungen manuell prüfen und zuordnen. Mit dem korrekten JTL PayPal Zahlungsabgleich entfällt dieser Aufwand komplett. Der Automatismus übernimmt die Zuordnung wieder. Für den Alltag lohnt sich zusätzlich der JTL-Worker für den täglichen Abgleich — damit solche Lücken künftig sofort auffallen.

Der Ablauf richtet sich nach der Ursache. Prüfe zuerst ob du vom `cReferenz`-Bug betroffen bist — das ist der bei weitem häufigste Fall seit März 2025. Wenn du eine Wawi-Version vor 1.9.8.0 verwendest, ist die Diagnose schon so gut wie sicher. **Hinweis vor Schritt 3:** Erstelle ein vollständiges Datenbankbackup deiner JTL-Wawi-Datenbank, bevor du das Update einspielst — das gilt für jedes Wawi-Update. Für produktive Systeme empfehlen wir, das Update durch einen JTL Service Partner begleiten zu lassen.

Öffne in JTL-Wawi den Menüpunkt Hilfe > Info. Steht dort eine Version kleiner als 1.9.8.0, bist du sehr wahrscheinlich von WAWI-78802 betroffen. JTL hat das `cReferenz`-Feld in 1.9.8.0 auf eine ausreichend große Länge angepasst. Vor dem Update gehört laut JTL-Standard ein vollständiges Backup der Wawi-Datenbank zum Pflichtschritt — das schützt bei unerwarteten Problemen.

Wenn du dir nicht sicher bist, schau ins Fehlerlog von JTL-Wawi. Es befindet sich im Wawi-Programmordner unter dem Unterordner `logs/`. Suche nach der Zeichenkette „string or binary data would be truncated“. Findest du diesen Eintrag, ist die Ursache eindeutig das zu kurze `cReferenz`-Feld — und das Update auf 1.9.8.0 oder neuer ist der richtige Weg. Kein solcher Eintrag bedeutet: weiter zu Schritt 4.

Das Update auf eine aktuelle Wawi-Version behebt den Fehler. JTL stellt Updates über den integrierten JTL-Updater bereit. Wichtig: Warte nach einem Major-Update einige Wochen auf erste Hotfixes, bevor du produktiv weiterarbeitest — das gilt generell, nicht nur für dieses Problem. Den Zahlungsabgleich-Prozess nach dem Update beschreibt der JTL-Guide-Artikel zu PayPal-Konten abgleichen Schritt für Schritt.

Läuft der Abgleich nach dem Update immer noch nicht, prüfe die gespeicherten PayPal-Zugangsdaten. In JTL-Wawi unter Zahlungen > Zahlungsanbieter: API-Username, Passwort und Signatur müssen mit den aktuell in deinem PayPal Business-Konto hinterlegten Werten übereinstimmen. Falls sie veraltet sind, trage sie neu ein. Sicherer ist das Hinterlegen im Tresor — dann entfällt die manuelle Eingabe bei jedem Abgleich-Start.

Starte nach dem Update und der Prüfung der Zugangsdaten einen manuellen Abgleich über Zahlungen > Abgleich starten. Prüfe danach den Ordner Kontobewegungen in JTL-Wawi. Die zuvor fehlenden PayPal-Zahlungen sollten jetzt sichtbar und den Aufträgen zugeordnet sein. Nicht automatisch zugeordnete Zahlungen findest du unter Zahlungen > Nicht zugewiesene Zahlungen und kannst sie dort manuell den jeweiligen Aufträgen zuweisen.