Die meisten VoP-Integrationsleitfäden enden bei „senden Sie einen Namen und IBAN, lesen Sie das Ergebnis“. Die Produktion fügt zwei Probleme hinzu: Netzwerke fallen aus und Clients wiederholen, und später fragt die Finanzabteilung „zu welcher Zahlung gehörte diese Verifizierung?“. Ein einziges Feld — eine stabile External ID pro Anfrage — löst beides.
Idempotenz bei Retries
Wenn eine Anfrage abläuft, kann Ihr Client sie wiederholen. Ohne Idempotenzschlüssel ist das eine zweite Verifizierung — zusätzliche Kosten und verwirrende Logs. Dieselbe External ID an den Retry anzuhängen erlaubt dem System, ihn als dieselbe logische Anfrage zu erkennen, sodass Retries sicher sind.
Eine ID, einmal generiert
Generieren Sie die External ID, wenn Sie die Zahlungsabsicht erstellen, nicht pro HTTP-Versuch. So trägt jeder Retry derselben logischen Verifizierung dieselbe ID.
Abstimmung
Dieselbe External ID ist Ihr Korrelationsschlüssel. Speichern Sie sie in Ihrem Zahlungsdatensatz, senden Sie sie mit der Verifizierung, und Sie können später das Verifizierungsergebnis der genauen Zahlung zuordnen — essenziell für Streitfälle, Audits und Analytik.
Den Audit-Trail aufbauen
- 1 Generieren Sie eine External ID pro Verifizierung und persistieren Sie sie mit Ihrer Zahlung.
- 2 Senden Sie sie in der Anfrage; verwenden Sie sie bei jedem Retry wieder.
- 3 Protokollieren Sie die zurückgegebene Verifizierungs-ID, das Ergebnis und den antwortenden BIC dazu.
Die Verification-of-Payee-API von RoxPay akzeptiert eine External ID pro Anfrage und gibt ihre eigene Verifizierungs-ID mit dem antwortenden BIC zurück, sodass Idempotenz und Abstimmung aus einem sauberen Muster hervorgehen.