Regeln und Integration
Conversion- und Erstattungsereignisse zuverlässig verarbeiten
Verhindern Sie doppelte Provisionen und verlorene Änderungen durch stabile Kennungen, Wiederholungstests und Geschäftsabgleich.
Vor dem Start
Ein empfangenes Ereignis beweist keine korrekte Provision. Nachrichten können mehrfach eintreffen, Erstattungen der Verarbeitung vorausgehen und Dienste trotz fehlgeschlagener Geschäftsbuchung antworten. Programm und Integration brauchen deshalb überprüfbare Nachweise. Bestätigen Sie Transporteigenschaften anhand der Dokumentation Ihres Anbieters. Stripe dient als dokumentiertes technisches Beispiel; seine Eigenschaften gelten nicht automatisch für andere Systeme.
Drei Kennungen unterscheiden
Trennen Sie Nachrichten-ID, Geschäftsvorgangs-ID und Partner-ID. Sie erkennen wiederholte Zustellung, verbinden Bestellung, Rechnung, Stornierung und Export und tragen die Attribution. Ergänzen Sie Ereignistyp, Version und Geschäftszeitpunkt in der Fallliste. Betrag und Kundenadresse ergeben keine verlässliche Bestellreferenz. Verfolgen Sie denselben Vorgang durch alle beteiligten Systeme.
Vor Verarbeitung die Herkunft prüfen
Nutzen Sie das dokumentierte Authentizitätsverfahren, etwa Signaturprüfung, sofern verfügbar. Definieren Sie Protokollierung bei ungültiger Signatur, ohne personenbezogene Daten öffentlich zu machen. Ändern Sie keine Geheimnisse während einer redaktionellen Prüfung. Ein erfolgreicher HTTP-Status beweist weder Echtheit noch erfolgreiche Geschäftsbuchung; unterscheiden Sie Empfang, Speicherung und Verarbeitung.
Wiederholungen ohne doppelte Wirkung behandeln
Beim erneuten Ereignis wird das vorhandene Ergebnis gefunden, statt eine weitere Provision erzeugt. Verknüpfen Sie Verarbeitungsnachweis und Geschäftsvorgang. API-Idempotenzschlüssel und Deduplizierung eingehender Ereignisse lösen verschiedene Probleme. Prüfen Sie beide Wege getrennt; eine Schutzmaßnahme sichert den anderen Weg nicht automatisch. Testen Sie auch parallele Wiederholungen.
Ungeordnete Zustellung berücksichtigen
Beschreiben Sie eine Erstattung, deren Bestellung lokal noch fehlt. Je nach Anbieter können kontrolliertes Warten oder Abfragen des Ursprungssystems helfen. Eine ältere Änderung darf einen neueren Status nicht ohne ausdrückliche Regel überschreiben. Speichern Sie Ereignis- und Empfangszeitpunkt, damit Verzögerungen, Reihenfolge und spätere Korrekturen nachvollziehbar sind.
Ausfall und Wiederanlauf testen
Simulieren Sie in einer autorisierten Umgebung Nichterreichbarkeit, verspätete Antworten und wiederholten Empfang. Prüfen Sie Wiederholungsfristen und Grenzen des Anbieters. Manuelle Wiedergabe kann mit automatischen Wiederholungen zusammenfallen. Legen Sie Berechtigung, notwendige Belege und Nachkontrollen fest. Ziel ist genau eine Geschäftswirkung, nicht lediglich ein erfolgreich markierter Nachrichtenstatus.
Mit Geschäftsdaten abgleichen
Vergleichen Sie Ursprungsbestellungen und Rechnungen regelmäßig mit berechtigten Plattformvorgängen. Unterscheiden Sie üblichen Verzug, dokumentierte Ablehnung und tatsächlichen Verlust. Prüfen Sie Anzahl und Beträge je Währung: eine Summe kann Duplikate verbergen, die fehlende Vorgänge ausgleichen. Bewahren Sie durchgehende Referenzbeispiele für Käufe, Teilerstattungen und Stornierungen auf.
Nützliche Vorfallsnachweise vorbereiten
Sammeln Sie Geschäftsreferenz, Typ, Zeitpunkte, Version, Soll- und Iststatus ohne Geheimnisse. Finden Sie den ersten abweichenden Verarbeitungsschritt und bestimmen Sie Verantwortlichen und Frist. Wiederholen Sie nach der Reparatur den Fall und benachbarte Fälle: eine Erstattungskorrektur darf keine Käufe verdoppeln. Halten Sie Ursache und künftige Erkennung fest.
Praktische Antworten
Fragen für die Entscheidung
Bedeutet HTTP 200 eine korrekte Provision?
Es zeigt eine Antwort des Empfängers. Verarbeitung, Geschäftsreferenz, Berechtigung und Endstatus müssen zusätzlich geprüft werden; die Bestätigung hängt von der Integration ab.
Entfernt API-Idempotenz jedes Duplikat?
Nein. Sie gilt für den von der API definierten Vorgang und Umfang. Wiederholte Ereigniszustellungen brauchen eigene Kontrollen und getrennte Tests.
Quellen und weiterführende Informationen
Dieser Leitfaden dient der Bildung und ersetzt keine Rechts-, Steuer- oder Finanzberatung. Prüfen Sie aktuelle Bedingungen anhand offizieller Quellen und ziehen Sie bei Bedarf qualifizierte Fachleute hinzu.