Die Verification of Payee von Grund auf zu bauen bedeutet, sich mit jedem antwortenden PSP zu integrieren und jede Antwort zu normalisieren. Eine VoP-API nimmt Ihnen diese Arbeit ab: Sie binden sich einmal an, und der Anbieter übernimmt die Schema-Anbindung über SEPA hinweg. Ihre Aufgabe wird eine saubere Anfrage/Antwort-Integration.
1. Authentifizieren
Aufrufe erfolgen über HTTPS und werden mit einem Bearer-Token authentifiziert. Speichern Sie die Zugangsdaten als Secret, nie im Client. Für manuelle oder volumenarme Prüfungen steht ein Dashboard zur Verfügung, sodass Nicht-Entwickler ohne Code prüfen können.
2. Anfrage senden
Senden Sie Empfängername und IBAN per POST an den Verify-Endpunkt. Fügen Sie eine eigene Referenz-ID bei, um das Ergebnis mit der zugehörigen Zahlung oder dem Onboarding-Datensatz abzugleichen.
Halten Sie sie idempotent
Übergeben Sie bei jeder Anfrage eine stabile externe ID, damit Wiederholungen keine doppelten Verifizierungen erzeugen und Sie einen asynchronen Log-Eintrag der auslösenden Aktion zuordnen können.
3. Die vier Ergebnisse behandeln
Jede Antwort entspricht einem SEPA-Schema-Code, sodass Ihre Verzweigung einfach bleibt:
- MATCH (MTCH) — der Name passt zum Kontoinhaber; fahren Sie zuversichtlich fort.
- CLOSE_MATCH (CMTC) — fast richtig; zeigen Sie den vorgeschlagenen verifizierten Namen und bitten Sie den Nutzer um Bestätigung.
- NO_MATCH (NMTC) — zeigen Sie eine klare Warnung, bevor die Zahlung bestätigt wird.
- NOT_APPLICABLE (NOAP) — Verifizierung derzeit nicht verfügbar; lassen Sie den Nutzer entscheiden.
Die Antwort trägt außerdem den BIC der antwortenden Bank und die Verarbeitungszeit, nützlich für Monitoring und Audit-Logs.
4. Überall wiederverwenden
Da der Vertrag derselbe ist, dient der eine Endpunkt mehreren Zwecken: eine Inline-Prüfung, während ein Zahler einen neuen Empfänger prüft, die Stapelverifizierung einer Lieferantendatei und eine Vorprüfung in einem SEPA-Lastschriftmandat-Flow. RoxPay nutzt die VoP genau so — auch als verpflichtende Vorprüfung, bevor ein SDD-Mandats-Signaturlink ausgegeben wird.