Alexander LuftVon Alexander Luft
JTL Service Partner Gold · Ahrensfelde bei Berlin · 27. November 2025 · 10 Min. Lesezeit
JTL-Wawi PayPal Zahlungsabgleich — Ursachen und Fix bei fehlenden Kontobewegungen

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

Seit März 2025 melden Händler das gleiche Problem: Der JTL PayPal Zahlungsabgleich läuft scheinbar durch, aber die Zahlungen tauchen nicht in den Kontobewegungen auf. Das Geld ist bei PayPal angekommen, JTL-Wawi zeigt an den einzelnen Aufträgen auch die Zahlung — nur der Abgleich bleibt leer. Die Ursache ist nicht eine Konfigurationslücke, sondern ein Datenbankfeld das zu kurz ist: Das Feld `cReferenz` nimmt in älteren Wawi-Versionen maximal 50 Zeichen auf, PayPal übergibt seit einem API-Update aber Referenzwerte mit mehr als 50 Zeichen — und der Import bricht lautlos ab.

PayPal sendet die Daten, JTL-Wawi holt sie nicht ab — und du weißt nicht warum?

Dieser Beitrag zeigt dir die genaue Ursache, was im Hintergrund schiefläuft, und welcher Weg zur Lösung führt.

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.

Wie verbreitet ist das Problem — was die Meldungen aus dem JTL-Forum zeigen?

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.

Warum bricht der JTL PayPal Zahlungsabgleich ab — welche zwei Ursachen stecken dahinter?

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.

Was bringt der Fix konkret — welche Vorteile hat ein sauber laufender Zahlungsabgleich?

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.

Die Lektion

Erkenntnis aus der Projektpraxis der Vlarom E-Commerce Agentur: Fehler die sich nicht im Interface zeigen sind die gefährlichsten. Der `cReferenz`-Bug war aktiv, während Händler dachten, alles laufe normal. Regelmäßige Log-Checks und zeitnahes Aktualisieren der Wawi sind keine Kür — sie sind der einzige Weg, solche stillen Fehler frühzeitig zu erkennen.

So behebst du den fehlenden JTL PayPal Zahlungsabgleich in 5 Schritten

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.

JTL-Wawi-Version prüfen

Ö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.

Fehlerlog prüfen zur Bestätigung

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.

JTL-Wawi auf aktuelle Version updaten

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.

PayPal-Zugangsdaten im Tresor prüfen

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.

Testabgleich starten und Kontobewegungen kontrollieren

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.

Häufige Fragen zum JTL PayPal Zahlungsabgleich

Warum erscheinen meine PayPal-Zahlungen nicht in den JTL-Wawi Kontobewegungen, obwohl der Abgleich durchläuft?

Das Problem tritt auf, weil das interne Datenbankfeld `cReferenz` in älteren JTL-Wawi-Versionen zu kurz ist. PayPal übergibt seit einem API-Update im Frühjahr 2025 Referenzwerte mit mehr als 50 Zeichen — das ist die interne Feldgrenze in betroffenen Versionen. Der Import bricht an dieser Stelle lautlos ab. Das Update auf JTL-Wawi 1.9.8.0 oder neuer behebt das Problem, weil JTL die Feldlänge dort angepasst hat (Ticket WAWI-78802, Status: Gelöst). Wir haben diesen Fehler bei mehreren Händlern bestätigt gesehen.

Die ersten Meldungen im JTL-Forum häufen sich ab dem 20. März 2025. Das deckt sich zeitlich mit einem PayPal-API-Update, nach dem die Referenzwerte länger wurden als das JTL-Datenbankfeld aufnehmen konnte. Ein Händler im JTL-Forum schrieb dazu: ‚Seit dem 20.03. kommen bei uns keine Zahlungen mehr im Zahlungsabgleich an — obwohl PayPal die Zahlungen korrekt verbucht.‘ Das ist das typische Symptom dieses spezifischen Fehlers. Betroffen sind alle Wawi-Versionen vor 1.9.8.0.

Ohne Update gibt es keinen offiziell unterstützten Weg. Das Problem liegt im Datenbankschema von JTL-Wawi selbst — das `cReferenz`-Feld ist schlicht zu kurz für die neuen PayPal-Referenzwerte. Eine manuelle Datenbankänderung wäre technisch denkbar, wird aber von JTL nicht supportet und kann bei späteren Updates zu weiteren Konflikten führen. Der offizielle und einzig sinnvolle Fix ist das JTL-Wawi-Update auf 1.9.8.0 oder neuer. Vor dem Update ist ein vollständiges Datenbankbackup Pflicht.

Schau ins Fehlerlog von JTL-Wawi (Programmordner > logs/). Findest du dort den Eintrag „string or binary data would be truncated“, ist WAWI-78802 die Ursache. Kein solcher Eintrag, aber der Abgleich startet gar nicht erst? Dann prüfe die PayPal-Zugangsdaten unter Zahlungen > Zahlungsanbieter — abgelaufene API-Credentials sind das zweitwahrscheinlichste Problem. Bei Zugangsdaten-Problemen erscheint in der Regel eine explizite Fehlermeldung im Abgleich-Dialog.

Die Zahlungen gehen nicht verloren — sie stehen weiterhin in deinem PayPal-Konto. Nach dem Wawi-Update und einem erneuten Abgleich werden die ausstehenden Zahlungen importiert. Nicht automatisch zugeordnete Zahlungen findest du in JTL-Wawi unter Zahlungen > Nicht zugewiesene Zahlungen und kannst sie dort manuell den jeweiligen Aufträgen zuweisen. Dieser manuelle Abgleich sollte zeitnah nach dem Update stattfinden — PayPal hält die Zahlungsdaten bereit bis sie abgeholt werden.

Nein. Das `cReferenz`-Problem betrifft den internen Zahlungsabgleich in JTL-Wawi direkt — also die Verbindung von JTL-Wawi zu deinem PayPal-Konto. Es hat nichts mit dem JTL-Shop-Connector, dem dbeS-Sync oder der Auftragsübernahme aus dem Shop zu tun. Aufträge kommen normal in JTL-Wawi an, auch die Zahlungsart ist korrekt gesetzt — nur der Abgleich der tatsächlichen Zahlung mit den Zahlungseingängen fehlt.

JTL-Wawi regelmäßig aktualisieren ist der beste Schutz vor solchen Fehlern. Warte dabei vier bis sechs Wochen nach einem Release-Datum, bis erste Hotfixes nachgezogen sind — das senkt das Risiko, neue Fehler einzuspielen. Außerdem lohnt es sich, das Fehlerlog von JTL-Wawi gelegentlich zu prüfen, auch wenn keine offensichtlichen Probleme sichtbar sind. Viele Fehler wie WAWI-78802 zeigen sich nicht im Interface, sondern nur in den Logs. Die Vlarom E-Commerce Agentur empfiehlt nach jedem Wawi-Update einen kurzen Testlauf des Zahlungsabgleichs — so fällt ein stiller Fehler sofort auf, nicht erst Tage später.

PayPal-Zahlungen fehlen im Abgleich? Wir schauen drauf.

Vlarom hilft dir, den JTL PayPal Zahlungsabgleich wieder zum Laufen zu bringen.

Als JTL Service Partner Gold aus Ahrensfelde bei Berlin begleiten wir Händler bei genau solchen Problemen — von der Fehlerdiagnose bis zum sauber durchgelaufenen Abgleich. Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular für eine kurze Einschätzung.