De meeste VoP-integratiegidsen eindigen bij 'stuur een naam en IBAN, lees het resultaat'. Productie voegt twee problemen toe: netwerken vallen uit en clients herhalen, en later vraagt finance 'bij welke betaling hoorde deze verificatie?'. Eén veld - een stabiele external id per verzoek - lost beide op.
Idempotentie bij herhalingen
Wanneer een verzoek afloopt, kan uw client het herhalen. Zonder idempotentiesleutel is dat een tweede verificatie - extra kosten en verwarrende logs. Dezelfde external id aan de herhaling hangen laat het systeem die herkennen als hetzelfde logische verzoek, zodat herhalingen veilig zijn.
Eén id, één keer gegenereerd
Genereer de external id wanneer u de betalingsintentie aanmaakt, niet per HTTP-poging. Zo draagt elke herhaling van dezelfde logische verificatie dezelfde id.
Reconciliatie
Dezelfde external id is uw correlatiesleutel. Sla die op in uw betalingsrecord, stuur die mee met de verificatie, en u kunt later het verificatieresultaat aan de exacte betaling koppelen - essentieel voor geschillen, audits en analytics.
De audittrail opbouwen
- 1 Genereer een external id per verificatie en sla die op bij uw betaling.
- 2 Stuur die mee in het verzoek; hergebruik die bij elke herhaling.
- 3 Log de teruggegeven verificatie-id, het resultaat en de responderende BIC erbij.
De Verification of Payee-API van RoxPay accepteert een external id per verzoek en geeft zijn eigen verificatie-id met de responderende BIC terug, zodat idempotentie en reconciliatie uit één schoon patroon voortkomen.