RoxPay 6 min leestijd

Hoe u RoxPay Verification of Payee integreert

De Verification of Payee toevoegen hoeft geen project van maanden te zijn. Met RoxPay gaat u in een paar duidelijke stappen van sandbox naar productie. Dit is het pad van de eerste aanroep tot de go-live.

Door Tomaas Vento Starrantino · Beoordeeld door Donato Leone

Hoe u RoxPay Verification of Payee integreert

Kernpunten

  • Begin in de sandbox met testsleutels voordat u productie aanraakt.
  • Roep één endpoint aan met de naam van de begunstigde en de IBAN, en handel dan vier uitkomsten af.
  • Vertaal overeenkomst, bijna-overeenkomst, geen overeenkomst en niet mogelijk naar de UX van uw betaler.

De Verification of Payee (VoP) controleert of de naam op een betaling overeenkomt met de rekeninghouder achter de IBAN voordat er geld stroomt. Onder de EU-verordening instantbetalingen is ze verplicht voor euro-overboekingen, maar de integratie zelf hoeft niet complex te zijn. Met RoxPay komt het neer op een handvol stappen.

1. Sandbox-toegangsgegevens ophalen

Begin met het aanvragen van sandbox-API-sleutels. De sandbox spiegelt het productiegedrag met testgegevens, zodat u uw flow kunt bouwen en controleren zonder live rekeningen of echte klanten aan te raken.

2. Roep het verificatie-endpoint aan

Stuur de naam van de begunstigde en de IBAN naar één endpoint. RoxPay routeert de controle naar het juiste schema en de juiste bank, normaliseert het antwoord en geeft een duidelijke uitkomst — u beheert niet zelf individuele bankverbindingen.

Eén endpoint, volledige dekking

In plaats van elke bank of elk schema apart te integreren, roept u één RoxPay-endpoint aan en krijgt u genormaliseerde resultaten over de in SEPA bereikbare rekeningen.

3. Handel de vier uitkomsten af

  • Overeenkomst: naam en rekeninghouder komen overeen — laat de betaling doorgaan.
  • Bijna-overeenkomst: een bijna-overeenkomst (bijv. afkorting) — toon de voorgestelde naam en laat de betaler bevestigen.
  • Geen overeenkomst: de namen verschillen — waarschuw de betaler voordat hij doorgaat.
  • Verificatie niet mogelijk: de bank kon niet antwoorden — leg het uit en laat de betaler beslissen.

4. Ontwerp de ervaring van de betaler

De technische aanroep is maar de helft van het werk. Vertaal elke uitkomst naar een duidelijke, niet-alarmerende UI zodat betalers begrijpen wat ze moeten doen. Een bijna-overeenkomst moet de geverifieerde naam voorstellen; een geen overeenkomst moet waarschuwen zonder legitieme betalingen meteen te blokkeren.

5. Ga live

Zodra uw flow elke uitkomst afhandelt en u belastingstests hebt gedaan tegen realistische pieken, wisselt u de sandboxsleutels om voor productiesleutels. De monitoring en logging van RoxPay helpen u de integratie in de dagen na de go-live in het oog te houden.

FAQ

Veelgestelde vragen

Omdat u één endpoint aanroept en RoxPay de bank- en schemaconnectiviteit afhandelt, bouwen en testen de meeste teams de kernflow in dagen in plaats van maanden. Het meeste werk is het ontwerpen van de betalerervaring voor elke uitkomst.

Nee. U integreert één keer met RoxPay, dat controles routeert over de in SEPA bereikbare rekeningen en genormaliseerde uitkomsten teruggeeft, zodat u geen individuele bankverbindingen onderhoudt.

Ja. De sandbox gebruikt testgegevens die het productiegedrag spiegelen, zodat u elke uitkomst kunt bouwen en valideren voordat u live gaat.

Integreer VoP in dagen, niet maanden

Praat met RoxPay over sandboxsleutels en een Verification-of-Payee-integratie die bij uw stack past.