De Verification of Payee vanaf nul bouwen betekent integreren met elke responderende PSP en elke respons normaliseren. Een VoP-API neemt dat werk weg: u maakt één keer verbinding en de aanbieder regelt de schema-connectiviteit binnen heel SEPA. Uw taak wordt een nette verzoek/antwoord-integratie.
1. Authenticeren
Aanroepen verlopen via HTTPS en worden geauthenticeerd met een bearer token. Bewaar de credential als secret, nooit in de client. Voor handmatige of laagvolume-controles is een dashboard beschikbaar, zodat niet-ontwikkelaars kunnen verifiëren zonder code te schrijven.
2. Stuur het verzoek
POST de naam en IBAN van de begunstigde naar het verify-endpoint. Voeg uw eigen referentie-id toe zodat u het resultaat kunt afstemmen op de betaling of het onboardingrecord waar het bij hoort.
Houd het idempotent
Geef bij elk verzoek een stabiele externe id mee, zodat herhalingen geen dubbele verificaties opleveren en u een asynchrone logregel kunt terugkoppelen aan de oorspronkelijke actie.
3. Behandel de vier uitkomsten
Elke respons komt overeen met een SEPA-schemacode, dus uw vertakking blijft eenvoudig:
- MATCH (MTCH) - de naam komt overeen met de rekeninghouder; ga met vertrouwen verder.
- CLOSE_MATCH (CMTC) - bijna goed; toon de voorgestelde geverifieerde naam en vraag de gebruiker om bevestiging.
- NO_MATCH (NMTC) - toon een duidelijke waarschuwing voordat de betaling wordt bevestigd.
- NOT_APPLICABLE (NOAP) - verificatie is nu niet beschikbaar; laat de gebruiker beslissen.
De respons bevat ook de BIC van de responderende bank en de verwerkingstijd, nuttig voor monitoring en auditlogs.
4. Hergebruik het overal
Omdat het contract hetzelfde is, dient het ene endpoint meerdere doelen: een inline-controle terwijl een betaler een nieuwe begunstigde bekijkt, batchverificatie van een leveranciersbestand en een voorcontrole binnen een SEPA Direct Debit-mandaatflow. RoxPay gebruikt VoP precies zo - ook als verplichte voorcontrole voordat een ondertekeningslink voor een SDD-mandaat wordt uitgegeven.