Een Verification of Payee- voorbeeld
Hoe ziet een VoP-controle er in de praktijk uit? Hier is een concreet voorbeeld: het verzoek dat u verstuurt, het JSON-antwoord dat u 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 vraag in realtime: hoort deze naam bij dit IBAN? U dient de naam van de begunstigde en het IBAN in, en de antwoordende bank geeft een gestandaardiseerde uitkomst terug voordat de betaling wordt geautoriseerd.
Hieronder staat een vereenvoudigd voorbeeld van het verzoek en het antwoord. De exacte veldnamen verschillen per aanbieder, maar elk VoP-antwoord komt overeen met dezelfde vier uitkomsten van het schema.
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.
overeenkomst
De naam komt volledig overeen met de rekeninghouder — bijvoorbeeld u stuurde 'Maria Rossi' en de rekening staat op naam van 'Maria Rossi'.
bijna-overeenkomst
Bijna juist — bijvoorbeeld u stuurde 'M. Rossi' en de rekeninghouder is 'Maria Rossi'. De geverifieerde naam wordt als suggestie teruggegeven.
geen overeenkomst
De naam komt niet overeen met het IBAN — bijvoorbeeld 'Acme Ltd' op een rekening van 'Maria Rossi'. Een sterk fraudesignaal.
niet mogelijk
De controle kon niet worden voltooid — bijvoorbeeld de bank van de begunstigde is niet bereikbaar of het IBAN wordt nog niet ondersteund.
Probeer het met uw eigen gegevens
In de RoxPay-sandbox kunt u echte namen en IBAN's versturen en precies zien welke uitkomst terugkomt — de snelste manier om het gedrag van VoP te begrijpen vóór integratie.
FAQ
Het is een kleine, gestructureerde reactie met de uitkomst (overeenkomst, bijna-overeenkomst, geen overeenkomst of niet mogelijk), en bij een bijna-overeenkomst de geverifieerde rekeningnaam als suggestie, plus de BIC van de antwoordende bank en een verzoekreferentie.
Als u 'M. Rossi' verstuurt terwijl de rekeninghouder 'Maria Rossi' is, levert dat doorgaans een bijna-overeenkomst op, met 'Maria Rossi' als suggestie zodat de betaler de naam kan bevestigen of corrigeren.
Minimaal de naam van de begunstigde en het IBAN. Voor rechtspersonen kan ook een organisatie-identificatie (zoals een btw- of registratienummer) worden toegevoegd om de nauwkeurigheid te verbeteren.
Ja. RoxPay biedt een sandbox en API-documentatie zodat u voorbeeldverzoeken kunt versturen en het antwoord voor elke uitkomst kunt bekijken voordat u live gaat.
Bekijk de VoP-API in actie
Krijg toegang tot de sandbox en test echte verzoeken tegen alle vier de uitkomsten.