RevenueCat-Webhooks: doppelte Verlängerungen vermeiden
Verhindere doppelte Umsatzbuchungen bei erneuter Zustellung: speichere Ereignis-IDs und teste den Empfang und die Verarbeitung.

Ein RevenueCat-Webhook meldet eine Verlängerung. Der Umsatz ist bereits verbucht, aber die HTTP-Antwort geht verloren. Beim nächsten Zustellversuch darf dieselbe Verlängerung weder einen zweiten Umsatzposten noch einen zweiten Auftrag erzeugen.
Zustellung und Ereignis getrennt betrachten
Die RevenueCat-Dokumentation empfiehlt, die Ereignis-ID zu speichern. Sie hilft, denselben Vorgang bei einer Wiederholung zu erkennen. Bei mehreren unabhängigen Integrationen sollte die Quelle Teil des Schlüssels sein. Eine Kunden-ID reicht dagegen nicht: Die Verlängerung im Folgemonat muss weiterhin als neuer Vorgang zählen.
Bilde diese Unterscheidung auch im Monitoring ab. Vier HTTP-Aufrufe können zu zwei Ereignissen gehören. Ein Anstieg der Zustellungen ist deshalb noch kein Anstieg der Verlängerungen.
Erst dauerhaft speichern, dann bestätigen
Prüfe die Herkunft des Requests nach den Vorgaben des Anbieters. Schreibe dann einen Eingangssatz mit eindeutigem Schlüssel. Werden Eingang und Arbeitsauftrag in derselben Datenbank verwaltet, speichere beide in einer Transaktion und bestätige erst nach dem Commit. Findest du bei einer Wiederholung einen bereits bestätigten Eingangssatz, antworte erfolgreich, ohne einen neuen Auftrag anzulegen.
Teste beide Seiten der Grenze: Ein Abbruch vor dem Commit muss eine spätere Speicherung ermöglichen. Ein Abbruch nach dem Commit darf bei der Wiederholung keine zweite Arbeit auslösen.
Auch die Verarbeitung auf Wiederholung auslegen
Nicht nur der Anbieter kann erneut zustellen. Auch dein eigener Hintergrundprozess kann nach einem Absturz neu starten. Nutze den Ereignisschlüssel deshalb auch als Eindeutigkeitsmerkmal in der Ergebnisbuchung. Bei einem externen Ziel verwende, falls unterstützt, dessen Idempotenzschlüssel. Für Zugriffsrechte zählt der verlässliche aktuelle Zustand, nicht die Reihenfolge eingegangener Nachrichten.
Ein Test mit einer klaren Sollzahl
Sende in einer Testumgebung eine Verlängerung zweimal und eine weitere Verlängerung für dasselbe Testkonto mit anderer Ereignis-ID genau einmal. Die Auswertung soll drei Zustellungen und zwei Buchungen zeigen. Protokolliere dafür Kennung und Verarbeitungsstatus, ohne vollständige Kundendaten in Logdateien zu kopieren.
Die RevenueCat-Anleitung von Submetry beschreibt die Erkennung doppelter Zustellungen und die Trennung von Testereignissen. Für Informationen zum Start kannst du dich auf die Submetry-Warteliste setzen.