Ontwikkelaar 6 min leestijd

Het datamodel van Verification of Payee begrijpen

Voordat u een regel integratiecode schrijft, helpt het om de vorm van een VoP-uitwisseling te begrijpen: de velden die u aanlevert, de uitkomsten die u ontvangt en de metadata die u helpt daarop te reageren.

Door Tomaas Vento Starrantino · Beoordeeld door Donato Leone

Het datamodel van Verification of Payee begrijpen

De belangrijkste punten

  • Een VoP-verzoek draait om de naam van de begunstigde, het IBAN en het rekeningtype.
  • Het antwoord geeft een gestandaardiseerde uitkomst plus ondersteunende details.
  • Schone, gestructureerde invoergegevens verbeteren de matchnauwkeurigheid.

Verification of Payee is conceptueel eenvoudig: u vraagt of een naam overeenkomt met een IBAN en krijgt een gestandaardiseerde uitkomst terug. Maar een robuuste integratie hangt af van het begrijpen van elk onderdeel van die uitwisseling en het aanleveren van schone gegevens.

De verzoekkant

  • Naam van de begunstigde: de naam zoals u die verwacht, idealiter gestructureerd en schoon.
  • IBAN: de rekening die wordt geverifieerd.
  • Rekeningtype: of de begunstigde een persoon of een organisatie is, wat het matchen beïnvloedt.
  • Een verzoekreferentie of idempotentiesleutel om de aanroep aan uw gegevens te koppelen.

De antwoordkant

  • Uitkomst: overeenkomst, gedeeltelijke overeenkomst, geen overeenkomst of niet beschikbaar.
  • Bij een gedeeltelijke overeenkomst de daadwerkelijk geregistreerde naam, zodat u die aan de betaler kunt tonen.
  • Een reden- of statuscode die context geeft bij de uitkomst.
  • Een identificator om te correleren met uw logs en afstemming.

Rommel erin, zwakke match eruit

De matchnauwkeurigheid hangt af van de kwaliteit van de invoer. Schone, goed gestructureerde namen en het juiste rekeningtype versturen verbetert de resultaten aanzienlijk.

Ontwerpen rond het model

De Verification of Payee-API van RoxPay biedt een duidelijk verzoek-/antwoordmodel met gestandaardiseerde uitkomsten en ondersteunende details, zodat uw integratie met vertrouwen op resultaten kan reageren.

FAQ

Veelgestelde vragen

Voornamelijk de naam van de begunstigde, het IBAN, het rekeningtype (persoon of organisatie) en een referentie of idempotentiesleutel om de aanroep aan uw gegevens te koppelen.

Een gestandaardiseerde uitkomst — overeenkomst, gedeeltelijke overeenkomst, geen overeenkomst of niet beschikbaar — plus ondersteunende details zoals de geregistreerde naam bij een gedeeltelijke overeenkomst en een statuscode.

De matchnauwkeurigheid hangt hiervan af. Schone, goed gestructureerde namen en het juiste rekeningtype verbeteren de verificatieresultaten aanzienlijk.

Bouw op een duidelijk datamodel

Praat met RoxPay over een Verification of Payee-API met een schoon verzoek-/antwoordmodel.