De Verification-of-Payee- API
Eén realtime REST-aanroep om een begunstigdenaam tegen een IBAN te bevestigen — resultaat, BIC van de antwoordende bank en verwerkingstijd in de respons. Gebouwd op het RoxPay-platform en het SEPA-VoP-schema.
{ "Name": "ACME Trading Ltd", "Iban": "DE89 3704 0044 0532 0130 00" }
{ "VopResult": "MATCH", "MatchType": "MTCH", "RespondingBic": "CRACIT33XXX" }
Begunstigdecontrole in één verzoek
De Verification-of-Payee-API stelt het SEPA-VoP-schema beschikbaar als een net REST-endpoint: stuur een naam en een IBAN, ontvang een gestandaardiseerd resultaat in realtime — zonder zelf het schemaleidingwerk te hoeven bouwen.
Het is dezelfde controle die RoxPay binnen zijn bankplatform SwiftLine / RoxBusiness uitvoert, beschikbaar voor banken, PSP's en bedrijven via een geauthenticeerde API en een dashboard. Elke respons bevat het overeenkomsttype, de BIC van de antwoordende instelling en de PSP-verwerkingstijd.
Omdat het wordt geleverd via de Europese open-banking-infrastructuur van RoxPay, verbindt u één keer en bereikt u begunstigdecontrole in heel SEPA — in plaats van te integreren met elke antwoordende bank.
Van nul tot geverifieerd in vier stappen
Een standaard REST-integratie die in uw bestaande betaalstroom past.
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 / gedeeltelijk / geen / niet van toepassing), de antwoordende BIC en de verwerkingstijd.
Handel 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
Elke respons komt overeen met een code van het SEPA-VoP-schema, zodat uw logica eenvoudig blijft.
MATCH · MTCH
De naam komt overeen met de rekeninghouder. De respons bevat ook de BIC van de antwoordende bank.
CLOSE_MATCH · CMTC
Gedeeltelijke overeenkomst — behandel het als een 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.
Zelf VoP bouwen vs. de API
Wat u vermijdt door één endpoint aan te roepen in plaats van alleen toe te treden tot het schema.
Intern bouwen
- Schemaconnectiviteit Integratie per antwoordende PSP
- Tijd tot live Maanden
- Responsdetail U normaliseert het
- Hergebruik over producten Elke stroom opnieuw bedraden
- Onderhoud Voor u
Verification-of-Payee-API
- Schemaconnectiviteit Eén verbinding, SEPA-breed bereik
- Tijd tot live Weken
- Responsdetail Gestandaardiseerd resultaat + BIC + timing
- Hergebruik over producten Eén API voor UI, batch & mandaten
- Onderhoud Afgehandeld door het platform
Eén API, drie doelgroepen
Hetzelfde endpoint dient zeer verschillende taken.
Banken & PSP's
Bied rekeninghouders de Verification of Payee aan en voldoe aan de verordening instantbetalingen zonder 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 IBAN's van leveranciers en salarissen in bulk vóór een betaalrun en verminder het risico op factuuromleiding.
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 PSP-verwerkingstijd om de prestaties te bewaken.
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 overeenkomsttype-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 in de SEPA-incassomandaatstroom van RoxPay gebruikt als voorcontrole.
NO_MATCH is geen transportfout — het is een geldige 200-respons die 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 begunstigde opnieuw controleren vóór verzending.
CLOSE_MATCH (schemacode CMTC) betekent dat de naam bijna goed is — een ontbrekende tweede voornaam, een statutaire vs handelsnaam. De respons 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 de organisatie-identificatie naast de naam. U dient de identificatie 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 kunnen finance-teams IBAN's massaal tegen namen valideren vóór elke run.
Integreer de Verification of Payee
Verkrijg uw inloggegevens en ga live op het SEPA-VoP-schema met één REST-integratie.