Ontwikkelaar 7 min leestijd

Integrating the Verification of Payee-API: A Developer's Guide

De Verification of Payee aan een product toevoegen hoeft niet te betekenen dat u bank voor bank tot het schema toetreedt. Met één REST-endpoint stuurt u een naam en IBAN en krijgt u realtime een gestandaardiseerde uitkomst terug. Zo integreert u het goed.

Door Tomaas Vento Starrantino · Beoordeeld door Donato Leone

Developer integrating the Verification of Payee REST API with standard SEPA match outcomes

Het Wichtigste

  • Een VoP-API verwandelt het SEPA-Schema in een authentifizierten REST-Aufruf: Name + IBAN senden, standardisiertes Ergebnis erhalten.
  • Verzweigen U Uw Logik op vier Ergebnisse — MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE.
  • Nutzen U denselben Endpunkt voor In-App-controleen, Stapelverifizierung en Mandats-Vorcontroleen.

De Verification of Payee van Grund op naar bauen bedeutet, sich met jedem antwortenden PSP naar integrieren en jede Antwort naar normalisieren. Een VoP-API nimmt Ihnen diese Arbeit ab: U binden sich einmal an, en de Anbieter ubernimmt de Schema-Anbindung over SEPA hinweg. Uw Aufgabe wird een saubere Anfrage/Antwort-integratie.

1. Authentifizieren

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.

Halten U u idempotent

Ubergeben U bij jede Anfrage een stabile externe ID, damit Wiederholungen geen doppelten Verifizierungen erzeugen en U een asynchronen Log-Eintrag de auslosenden Aktion zuordnen konnen.

3. De vier Ergebnisse behandeln

Elke respons komt overeen met een SEPA-schemacode, dus uw vertakking blijft eenvoudig:

  • MATCH (MTCH) — de Name passt naar de rekeninghouder; fahren U zuversichtlich fort.
  • CLOSE_MATCH (CMTC) — fast richtig; zeigen U de vorgeschlagenen verifizierten Namen en bitten U de Nutzer um Bestatigung.
  • NO_MATCH (NMTC) — toon een duidelijke waarschuwing voordat de betaling wordt bevestigd.
  • NOT_APPLICABLE (NOAP) — Verifizierung derzeit niet verfugbar; lassen U de Nutzer entscheiden.

De Antwort tragt ausserdem de BIC de antwortenden bank en de Verarbeitungszeit, nutzlich voor Monitoring en Audit-Logs.

4. Uberall wiederverwenden

Da de Vertrag derselbe ist, dient de een Endpunkt mehreren Zwecken: een Inline-controle, wahrend een Zahler een neuen begunstigde controleert, de Stapelverifizierung einer leveranciersdatei en een Vorcontrole in einem SEPA-Lastschriftmandat-Flow. RoxPay nutzt de VoP genau so — auch als verpflichtende Vorcontrole, voordat een SDD-Mandats-Signaturlink ausgegeben wird.

Alle artikelen
FAQ

Veelgestelde vragen

Ja. Een Verify-Aufruf antwortet synchron, in de Regel in deutlich weniger als einer Sekunde, en enthalt de BIC de antwortenden bank en de PSP-Verarbeitungszeit naar de Leistungsuberwachung.

Een normalisiertes Ergebnis (MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE), de Ubereinstimmungstyp-Code van de SEPA-Schemas, een Verifizierungs-ID, de antwortende BIC, de Verarbeitungszeit en Uw optionale externe ID.

Ja. Rufen U de Endpunkt pro Datensatz auf, um een hele begunstigdedatei vóór einem betalingslauf naar controleren — er ist op hohen Durchsatz ausgelegt.

Verder lezen

De Verification-of-Payee-API Het volledige REST-contract en de uitkomsten. RoxPay Verification of Payee Hoe de API op de RoxPay-Plattform bereitgestellt wird. De Verordening instantbetalingen en de VoP How the API is delivered on RoxPay's platform. Verification of Payee-prijzen Per-check pricing for API volumes.

Integrieren U de Verification of Payee

Holen U sich Uw Zugangsdaten en gehen U met einer einzigen REST-integratie op de SEPA-VoP-Schema live.

Praat met een expert Lees het API-overzicht