De Verification of Payee- API
Eén realtime REST-aanroep om de naam van een begunstigde tegen een IBAN te bevestigen — matchresultaat, BIC van de antwoordende bank en verwerkingstijd in het antwoord. Gebouwd op het betalingsplatform van RoxPay en het SEPA VoP-schema.
{ "Name": "ACME Trading Ltd", "Iban": "DE89 3704 0044 0532 0130 00" }
{ "VopResult": "MATCH", "MatchType": "MTCH", "RespondingBic": "CRACIT33XXX" }
Begunstigdeverificatie in één verzoek
De Verification of Payee-API biedt het SEPA VoP-schema aan als een overzichtelijk REST-endpoint: stuur een naam en een IBAN en ontvang direct een gestandaardiseerd matchresultaat — zonder dat u de schema-aansluiting zelf hoeft te bouwen.
Het is dezelfde controle die RoxPay uitvoert binnen zijn bankplatform SwiftLine / RoxBusiness, beschikbaar voor banken, PSP's en bedrijven via een geauthenticeerde API en een dashboard. Elk antwoord bevat het matchtype, de BIC van de antwoordende instelling en de verwerkingstijd van de PSP.
Omdat de dienst wordt geleverd via de Europese open-bankinginfrastructuur van RoxPay, sluit u één keer aan en bereikt u begunstigdeverificatie in het hele SEPA-gebied — in plaats van met elke antwoordende bank apart te integreren.
Van nul naar verifieerd in vier stappen
Een standaard REST-integratie die naadloos aansluit op uw bestaande betaalflow.
Verkrijg uw inloggegevens
Activeer de dienst en authenticeer met een bearer-token — geen onboarding per bank te beheren.
Stuur naam + IBAN
POST de naam en IBAN van de begunstigde naar het verify-endpoint, optioneel met uw eigen referentie-id voor reconciliatie.
Lees het resultaat
Ontvang het resultaat (overeenkomst / bijna overeenkomst / geen overeenkomst / niet van toepassing), de antwoordende BIC en de verwerkingstijd.
Handel ernaar in uw UI
Toon de betaler een duidelijk signaal, of laat een betaalrun, een mandaat of een onboardingstap van het resultaat afhangen.
Wat de API teruggeeft
Elk antwoord komt overeen met een code van het SEPA VoP-schema, zodat uw logica eenvoudig blijft.
MATCH · MTCH
De naam komt overeen met de rekeninghouder. Het antwoord bevat ook de BIC van de antwoordende bank.
CLOSE_MATCH · CMTC
Bijna overeenkomst — behandel dit als een zachte waarschuwing en stel de geverifieerde naam voor.
NO_MATCH · NMTC
De naam komt niet overeen. Toon een duidelijke waarschuwing voordat de betaling wordt bevestigd.
NOT_APPLICABLE · NOAP
Verificatie voor deze IBAN momenteel niet beschikbaar. Laat de gebruiker beslissen.
VoP zelf bouwen versus de API
Wat u vermijdt door één endpoint aan te roepen in plaats van zelf tot het schema toe te treden.
Zelf ontwikkelen
- Schemaconnectiviteit Integratie per antwoordende PSP
- Tijd tot live Maanden
- Detail van het antwoord U normaliseert het zelf
- Herbruikbaar over producten Elke flow opnieuw bedraden
- Onderhoud Uw eigen verantwoordelijkheid
Verification of Payee-API
- Schemaconnectiviteit Eén verbinding, SEPA-breed bereik
- Tijd tot live Weken
- Detail van het antwoord Gestandaardiseerd resultaat + BIC + tijd
- Herbruikbaar over producten Eén API voor UI, batch & mandaten
- Onderhoud Afgehandeld door het platform
Eén API, drie doelgroepen
Hetzelfde endpoint bedient heel verschillende use cases.
Banken & betalingsdienstverleners
Bied rekeninghouders Verification of Payee aan en voldoe aan de verordening instantbetalingen, zonder zelf schemaconnectiviteit te bouwen.
Ontwikkelaars
Een voorspelbaar REST-contract, realtimeantwoorden, uw eigen referentie-id's en duidelijke schemacodes om op te vertakken.
Bedrijven & ERP's
Verifieer leveranciers- en salaris-IBAN's in bulk vóór een betaalrun en verminder het risico op factuurfraude.
De API, beantwoord
Wat ontwikkelaars en productteams als eerste vragen.
Ja. Een verify-aanroep antwoordt synchroon, doorgaans in ruim minder dan een seconde, en bevat de BIC van de antwoordende bank en de verwerkingstijd van de PSP, zodat u de prestaties kunt monitoren.
Aanroepen worden geauthenticeerd met een bearer-token over HTTPS. U kunt ook het RoxBusiness-dashboard gebruiken voor ad-hoccontroles zonder code te schrijven.
Een genormaliseerd resultaat (MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE), de matchtype-code van het SEPA-schema, een verificatie-id, de antwoordende BIC, de verwerkingstijd en uw optionele externe id.
Ja — roep het endpoint per record aan om een heel bestand met leveranciers of begunstigden te verifiëren vóór een betaalrun. Het is gebouwd voor hoge doorvoer.
Ja. De controle vergelijkt de ingediende naam met de geregistreerde rekeninghouder, of dat nu een particulier of een bedrijf is, en wordt binnen de SEPA-incassomandaatflow van RoxPay gebruikt als voorcontrole.
NO_MATCH is geen transportfout — het is een geldig 200-antwoord dat aangeeft dat de naam niet bij de IBAN hoort. Behandel het als een harde stop in uw UI of betaalrun: toon een duidelijke waarschuwing, blokkeer automatische goedkeuring en laat de gebruiker de begunstigde opnieuw controleren voordat er wordt verstuurd.
CLOSE_MATCH (schemacode CMTC) betekent dat de naam bijna goed is — een ontbrekende tweede voornaam, een statutaire naam versus een handelsnaam. Het antwoord bevat de geverifieerde rekeninghoudernaam, zodat u die als suggestie kunt tonen en de betaler om bevestiging kunt vragen in plaats van de betaling te weigeren.
Voor rechtspersonen staat het schema verificatie toe tegen het organisatie-identificatienummer naast de naam. U dient het identificatienummer in het verzoek in en de API geeft het standaardresultaat terug — handig wanneer de statutaire naam en handelsnaam verschillen.
Ja. Doorloop voor een betaalrun uw leveranciers- of salarisbestand en roep het verify-endpoint per record aan voordat u de batch vrijgeeft. Gebouwd voor hoge doorvoer, zodat financeteams IBAN's tegen namen kunnen massavalideren vóór elke betalingsrun.
Ja. U stuurt een JSON-verzoek met de naam en IBAN van de begunstigde en ontvangt de uitkomst, de geverifieerde naam (bij een bijna overeenkomst) en de antwoordende BIC. Bekijk een volledig verzoek en antwoord in ons VoP-voorbeeld, of de payloads en schemacodes in de API-documentatie.
Meer lezen
Integreer Verification of Payee
Verkrijg uw inloggegevens en ga live op het SEPA VoP-schema met één REST-integratie.