Zahlungs-APIs warten: Deprecations und Webhook-Fehler

Der erste Schritt ist unspektakulär und wird deshalb oft übersprungen: eine vollständige Liste aller aktiven Integrationen. In gewachsenen Shops ist diese Liste länger als erwartet. Neben zwei bis vier Zahlungsarten hängen Versandetiketten, Sendungsverfolgung, Warenwirtschaft, Buchhaltungsexport, Steuerermittlung, Bonitätsprüfung, Marktplatzanbindung und Newsletter-Übergabe an eigenen Schnittstellen. Jede davon hat eine Version, ein Authentifizierungsverfahren und ein Verfallsdatum – und jede kann still ausfallen. Ein Register ist die Voraussetzung dafür, dass eine Abkündigung überhaupt jemanden erreicht.

Ein Register ist kein Selbstzweck. Es beantwortet im Ernstfall drei Fragen in Minuten statt in Stunden: Welche Integration ist betroffen? Welche Version läuft aktuell? Wer beim Anbieter ist erreichbar? Ohne diese Antworten beginnt jeder Vorfall mit Suchen. Wir führen das Register deshalb als Bestandteil der laufenden Shop-Wartung und schreiben es bei jedem Update fort, weil ein veraltetes Register schlechter ist als gar keines – es erzeugt falsche Sicherheit.

Webhooks sind die empfindlichste Stelle einer Zahlungsintegration, weil sie die Richtung umkehren: Nicht der Shop fragt, sondern der Anbieter meldet. Damit verlagert sich die Verantwortung. Der Shop muss einen Endpunkt bereitstellen, der dauerhaft erreichbar ist, jede Meldung eindeutig zuordnet, doppelte Zustellungen erkennt und im Fehlerfall nachvollziehbar reagiert. Sechs Eigenschaften unterscheiden einen belastbaren Endpunkt von einem, der im Ernstfall Umsatz verliert.

Diese Regeln gelten unabhängig vom einzelnen Anbieter, weil sie aus der Natur asynchroner Zustellung folgen: Meldungen können sich verzögern, wiederholen, überholen oder ausbleiben. Ein Endpunkt, der eine feste Reihenfolge voraussetzt, ist deshalb fehleranfällig. Robust ist ein Endpunkt, der jeden Zustand aus dem Ereignis selbst ableitet und einen älteren Statuswechsel verwirft, wenn bereits ein neuerer verarbeitet wurde. Wie stark solche Abhängigkeiten den Betrieb prägen, zeigt der Beitrag zu Ausfällen bei Drittanbietern.

Schnittstellen ändern sich nicht nur, weil Anbieter ihre Software modernisieren, sondern weil der Rechtsrahmen es verlangt. Für Zahlungsvorgänge im europäischen Raum sind derzeit drei Entwicklungen relevant, die sich unmittelbar auf Datenqualität, Stammdatenpflege und Prüfaufwand im Shop auswirken.

Die Verordnung über Echtzeitüberweisungen verpflichtet Zahlungsdienstleister, vor der Autorisierung einer Überweisung einen Abgleich von Empfängername und Kontokennung anzubieten und die zahlende Person bei einer Abweichung zu warnen; der Dienst ist für Nutzerinnen und Nutzer kostenfrei (Verordnung (EU) 2024/886, Amtsblatt der Europäischen Union). Im Euroraum gilt diese Pflicht seit dem 9. Oktober 2025 (Europäische Zentralbank). Der Abgleich folgt einem gemeinsamen Regelwerk des europäischen Zahlungsverkehrs, das die Rückmeldung in klar abgegrenzte Kategorien fasst: Übereinstimmung, teilweise Übereinstimmung mit Namenshinweis, keine Übereinstimmung sowie Prüfung nicht möglich (European Payments Council, Verification of Payee Scheme).

Für einen Shop ist das keine reine Bankangelegenheit, sondern eine Frage der Stammdaten. Überall dort, wo aus dem Shop heraus Überweisungen ausgelöst oder Empfängerdaten weitergegeben werden – Erstattungen, Auszahlungen an Marktplatzhändler, Lieferantenzahlungen, Rechnungsangaben mit abweichendem Kontoinhaber --, entscheidet die Sauberkeit der hinterlegten Namen darüber, ob eine Zahlung ohne Rückfrage durchläuft. Abgekürzte Firmennamen, Handelsnamen statt Kontoinhaber und veraltete Bankverbindungen erzeugen jetzt sichtbare Warnungen statt stiller Toleranz. Der Pflegeaufwand verschiebt sich damit von der Bank in die Datenhaltung des Händlers.

Parallel dazu verschiebt sich das Tempo. Echtzeitüberweisungen müssen dem Empfängerkonto binnen 10 Sekunden gutgeschrieben werden (Europäische Zentralbank), und die frühere Betragsobergrenze von 100.000 Euro je Echtzeitüberweisung entfällt (Europäische Zentralbank). Für den Shop bedeutet das: Zahlungseingänge treffen schneller und in größerer Höhe ein, als es viele nachgelagerte Prozesse gewohnt sind. Wer Freigaben, Versandauslösung und Buchhaltungsabgleich an nächtlichen Sammelläufen aufhängt, verschenkt genau die Zeit, die die Regulierung gerade freigeräumt hat.

Die nächste Stufe ist absehbar. Die Europäische Kommission hat am 28. Juni 2023 Vorschläge für eine neue Zahlungsdiensterichtlinie und eine Zahlungsdienste-Verordnung vorgelegt (Europäische Kommission); am 27. November 2025 wurde dazu eine politische Einigung zwischen Parlament und Rat erzielt (Europäische Kommission). Damit steht fest, dass sich Anforderungen an Authentifizierung und Schnittstellen erneut bewegen werden – mit Übergangsfristen, die sich planen lassen, sofern das Register gepflegt ist. Wer heute nicht weiß, welche API-Version im Einsatz ist, wird auch diese Umstellung als Notfall erleben statt als Termin.

Für Kartenzahlungen bleibt daneben die Skript-Integrität auf der Zahlungsseite ein eigener Prüfpunkt: Jedes dort ausgeführte Skript braucht Autorisierung, Integritätssicherung und eine dokumentierte Begründung, und unautorisierte Änderungen an Skripten sowie an sicherheitsrelevanten HTTP-Kopfzeilen müssen mindestens alle sieben Tage erkannt werden (PCI Security Standards Council, PCI DSS 4.0.1). Diese Prüfung betrifft dieselben Seiten wie die Zahlungsintegration und gehört deshalb in denselben Wartungstakt – ebenso wie die Pflege der Consent-Skripte, die auf genau diesen Seiten mitlaufen.

Schnittstellenwissen ist das flüchtigste Wissen im Shop-Betrieb. Es entsteht bei der Einrichtung, lebt danach in einem einzigen Kopf und verschwindet mit dem Wechsel der Person oder des Dienstleisters. Deshalb ist Dokumentation hier kein Nebenprodukt, sondern der eigentliche Übergabewert – und der Grund, warum ein Betreiberwechsel geordnet statt archäologisch verläuft.

Diese drei Bausteine erklären auch, warum Schnittstellenpflege in einen Wartungsvertrag gehört und nicht in ein Projekt. Ein Projekt endet mit der Inbetriebnahme; eine Schnittstelle beginnt genau dort zu altern. Der Beitrag zu den Inhalten eines Wartungsvertrags ordnet ein, welche Leistungen üblicherweise dazugehören und welche gesondert vereinbart werden.