Een Verification of Payee- voorbeeld
Hoe ziet een VoP-controle er echt uit? Hier een concreet voorbeeld: het verzoek dat je verstuurt, het JSON-antwoord dat je terugkrijgt en hoe elk van de vier uitkomsten verschijnt.
Hoe een VoP-controle er in de praktijk uitziet
Een Verification of Payee-controle is één realtime vraag: hoort deze naam bij deze IBAN? Je stuurt de naam van de begunstigde en de IBAN, en de antwoordende bank geeft een gestandaardiseerde uitkomst terug voordat de betaling wordt geautoriseerd.
Hieronder een vereenvoudigd voorbeeld van het verzoek en het antwoord. De exacte veldnamen hangen af van de aanbieder, maar elk VoP-antwoord komt overeen met dezelfde vier schema-uitkomsten.
Voorbeeldverzoek
POST /v1/verification-of-payee
Authorization: Bearer <token>
{
"payee": {
"name": "Maria Rossi",
"iban": "DE89370400440532013000"
}
}{
"outcome": "match",
"matchedName": "Maria Rossi",
"respondingBic": "COBADEFFXXX",
"requestId": "vop_8f3a2c91",
"processedAt": "2026-06-24T10:00:00Z"
}De vier uitkomsten, met voorbeelden
Elk VoP-antwoord komt neer op een van deze vier resultaten.
match
De naam komt volledig overeen met de rekeninghouder — bijv. je stuurde 'Maria Rossi' en de rekening is 'Maria Rossi'.
close match
Bijna goed — bijv. je stuurde 'M. Rossi' en de houder is 'Maria Rossi'. De geverifieerde naam wordt als suggestie teruggegeven.
no match
De naam komt niet overeen met de IBAN — bijv. 'Acme BV' op een rekening van 'Maria Rossi'. Een sterk fraudesignaal.
not possible
De controle kon niet worden voltooid — bijv. de bank van de begunstigde is onbereikbaar of de IBAN wordt nog niet gedekt.
Test het met je eigen data
Met de RoxPay-sandbox kun je echte namen en IBAN's sturen en precies zien welke uitkomst terugkomt — de snelste manier om VoP-gedrag te begrijpen vóór integratie.
FAQ
Het is een klein gestructureerd antwoord met de uitkomst (match, bijna-match, geen match of niet mogelijk), en bij een bijna-match de geverifieerde rekeningnaam als suggestie, plus de BIC van de antwoordende bank en een verzoekreferentie.
'M. Rossi' sturen terwijl de houder 'Maria Rossi' is, geeft meestal een bijna-match, met 'Maria Rossi' als suggestie zodat de betaler de naam kan bevestigen of corrigeren.
Minimaal de naam van de begunstigde en de IBAN. Voor rechtspersonen kan ook een organisatie-identificatie (zoals btw- of registratienummer) worden meegegeven om de nauwkeurigheid te verbeteren.
Ja. RoxPay biedt een sandbox en API-documentatie om voorbeeldverzoeken te sturen en het antwoord voor elke uitkomst te inspecteren vóór livegang.
Zie de VoP-API in actie
Krijg sandbox-toegang en test echte verzoeken tegen alle vier uitkomsten.