Ein Verification-of-Payee- Beispiel
Wie sieht eine VoP-Prüfung tatsächlich aus? Hier ein konkretes Beispiel: die Anfrage, die Sie senden, die JSON-Antwort, die Sie erhalten, und wie jedes der vier Ergebnisse erscheint.
Wie eine VoP-Prüfung in der Praxis aussieht
Eine Verification-of-Payee-Prüfung ist eine einzige Echtzeit-Frage: Gehört dieser Name zu dieser IBAN? Sie übermitteln den Namen des Zahlungsempfängers und die IBAN, und die antwortende Bank liefert ein standardisiertes Ergebnis, bevor die Zahlung autorisiert wird.
Nachfolgend ein vereinfachtes Beispiel für Anfrage und Antwort. Die genauen Feldnamen hängen vom Anbieter ab, aber jede VoP-Antwort entspricht denselben vier Schema-Ergebnissen.
Beispielanfrage
POST /v1/verification-of-payee
Authorization: Bearer <token>
{
"payee": {
"name": "Maria Rossi",
"iban": "DE89370400440532013000"
}
}{
"outcome": "match",
"matchedName": "Maria Rossi",
"respondingBic": "COBADEFFXXX",
"requestId": "vop_8f3a2c91",
"processedAt": "2026-06-24T10:00:00Z"
}Die vier Ergebnisse, mit Beispielen
Jede VoP-Antwort läuft auf eines dieser vier Ergebnisse hinaus.
match
Der Name stimmt vollständig mit dem Kontoinhaber überein — z. B. Sie sendeten 'Maria Rossi' und das Konto lautet 'Maria Rossi'.
close match
Fast richtig — z. B. Sie sendeten 'M. Rossi' und der Inhaber ist 'Maria Rossi'. Der geprüfte Name wird als Vorschlag zurückgegeben.
no match
Der Name passt nicht zur IBAN — z. B. 'Acme GmbH' auf einem Konto von 'Maria Rossi'. Ein starkes Betrugssignal.
not possible
Die Prüfung konnte nicht abgeschlossen werden — z. B. die Empfängerbank ist nicht erreichbar oder die IBAN ist noch nicht abgedeckt.
Testen Sie es mit Ihren eigenen Daten
Die RoxPay-Sandbox lässt Sie echte Namen und IBANs senden und genau sehen, welches Ergebnis zurückkommt — der schnellste Weg, das VoP-Verhalten vor der Integration zu verstehen.
FAQ
Es ist eine kleine strukturierte Antwort mit dem Ergebnis (Treffer, Beinahe-Treffer, kein Treffer oder nicht möglich) und bei einem Beinahe-Treffer dem geprüften Kontonamen als Vorschlag, dazu der BIC der antwortenden Bank und eine Anfragereferenz.
'M. Rossi' zu senden, wenn der Inhaber 'Maria Rossi' ist, liefert in der Regel einen Beinahe-Treffer, mit 'Maria Rossi' als Vorschlag, damit der Zahler den Namen bestätigen oder korrigieren kann.
Mindestens den Empfängernamen und die IBAN. Für juristische Personen kann zusätzlich eine Organisationskennung (z. B. USt-IdNr. oder Registernummer) angegeben werden, um die Genauigkeit zu verbessern.
Ja. RoxPay bietet eine Sandbox und API-Dokumentation, um Beispielanfragen zu senden und die Antwort für jedes Ergebnis vor dem Go-live zu prüfen.
Sehen Sie die VoP-API in Aktion
Erhalten Sie Sandbox-Zugang und testen Sie echte Anfragen gegen alle vier Ergebnisse.