De meisten VoP-Integrationsleitfaden enden bij „senden U een Namen en IBAN, lesen U het Ergebnis“. De Produktion fugt zwei Probleme hinzu: Netzwerke fallen aus en Clients wiederholen, en spater fragt de financieelabteilung „zu welcher betaling gehorte diese Verifizierung?“. Een einziges Feld — een stabile External ID pro Anfrage — lost beides.
Idempotentie bij retries
Wanneer een Anfrage ablauft, kann Uw Client u wiederholen. Zonde Idempotenzschlussel ist het een zweite Verifizierung — zusatzliche Kosten en verwirrende Logs. Dieselbe External ID aan de Retry anzuhangen erlaubt de System, ihn als dieselbe logische Anfrage naar erkennen, sodass Retries sicher sind.
Eén id, eenmaal gegenereerd
Generieren U de External ID, wanneer U de betalingsabsicht erstellen, niet pro HTTP-Versuch. So tragt jede Retry derselben logischen Verifizierung dieselbe ID.
Reconciliatie
Dieselbe External ID ist Uw Korrelationsschlussel. Speichern U u in Uw betalingsdatensatz, senden U u met de Verifizierung, en U konnen spater het Verifizierungsergebnis de genauen betaling zuordnen — essenziell voor Streitfalle, Audits en Analytik.
De Audit-Trail aufbauen
- 1 Generieren U een External ID pro Verifizierung en persistieren U u met Uw betaling.
- 2 Senden U u in de Anfrage; verwenden U u bij jedem Retry wieder.
- 3 Protokollieren U de zuruckgegebene Verifizierungs-ID, het Ergebnis en de antwortenden BIC dazu.
De Verification-of-Payee-API van RoxPay akzeptiert een External ID pro Anfrage en gibt ihre eigene Verifizierungs-ID met de antwortenden BIC zuruck, sodass Idempotenz en Abstimmung aus einem sauberen Muster hervorgehen.