De meeste VoP-integratiegidsen stoppen bij 'stuur een naam en IBAN, lees de uitkomst'. Productie voegt twee problemen toe: netwerken falen en clients proberen opnieuw, en later vraagt finance 'bij welke betaling hoorde deze verificatie?'. Eén veld — een stabiele external id per verzoek — lost beide op.
Idempotentie bij retries
Als een verzoek verloopt, kan uw client het opnieuw proberen. Zonder een idempotentiesleutel is dat een tweede verificatie — extra kosten en verwarrende logs. Dezelfde external id aan de retry koppelen laat het systeem die herkennen als hetzelfde logische verzoek, dus retries zijn veilig.
Eén id, eenmaal gegenereerd
Genereer de external id wanneer u de betaalintentie aanmaakt, niet per HTTP-poging. Zo draagt elke retry van dezelfde logische verificatie dezelfde id.
Reconciliatie
Dezelfde external id is uw correlatiesleutel. Bewaar hem op uw betaalrecord, stuur hem met de verificatie, en u kunt later het verificatieresultaat aan de exacte betaling koppelen — essentieel voor geschillen, audits en analyse.
Bouw de audittrail
- 1 Genereer een external id per verificatie en persisteer hem met uw betaling.
- 2 Stuur hem in het verzoek; hergebruik hem bij elke retry.
- 3 Log de teruggegeven verificatie-id, de uitkomst en de antwoordende BIC ertegenover.
De Verification of Payee-API van RoxPay accepteert een external id per verzoek en geeft zijn eigen verificatie-id terug met de antwoordende BIC, zodat idempotentie en reconciliatie uit één schoon patroon voortvloeien.