Entwicklerleitfaden
Dem Ereignis folgen. Das Ergebnis abgleichen.
Finanzereignisse halten Ihr System auf dem Laufenden. Verifizierung, Mehrfachzustellung und Abgleich mit dem zugrunde liegenden Vorgang einplanen.
Ereignisse an ihre Quelle binden.
- Den Vorgang identifizieren
Jedes Ereignis der stabilen Objektkennung aus dem API-Vertrag zuordnen.
- Die Zustellung prüfen
Die für Webhooks spezifizierte Authentifizierung oder Signaturprüfung umsetzen. Diese Seite definiert weder Headernamen noch Signaturalgorithmus.
- Wiederholte Ereignisse behandeln
Dokumentierte Ereigniskennungen und Wiederholungsregeln nutzen, um doppelte Auswirkungen im eigenen System zu verhindern.
Für verzögerte oder mehrfache Zustellung planen.
Die Produktionsspezifikation muss Ereignistypen, Reihenfolge, Bestätigungen, Wiederholungen und erneute Auslieferung festlegen. Diese Übersicht garantiert weder Zustellreihenfolge noch genau einmalige Zustellung.
- Den Status verarbeiten
- Auftragsfreigabe, Übertragungsbestätigung und Zahlungsabgleich getrennt verfolgen. Eine Netzwerkbestätigung belegt keinen Eingang auf einem Bankkonto.
- Gezielt wiederherstellen
- Nach einer Unterbrechung die dokumentierten Wiederholungs- und Wiederauslieferungsregeln befolgen.
- Abgleichen
- Bei fehlenden, verzögerten oder unerwarteten Ereignissen die eigenen Aufzeichnungen mit dem Quellvorgang abgleichen.