Egy Verification of Payee példa
Hogyan néz ki valójában egy VoP-ellenőrzés? Íme egy konkrét példa: az elküldött kérés, a visszakapott JSON-válasz, és hogyan jelenik meg a négy kimenetel.
Hogyan néz ki egy VoP-ellenőrzés a gyakorlatban
A Verification of Payee ellenőrzés egyetlen valós idejű kérdés: ehhez az IBAN-hoz tartozik ez a név? Ön beküldi a kedvezményezett nevét és az IBAN-t, és a válaszadó bank még a fizetés engedélyezése előtt szabványosított kimenetelt ad vissza.
Az alábbiakban a kérés és a válasz egyszerűsített példája látható. A pontos mezőnevek a szolgáltatótól függenek, de minden VoP-válasz ugyanarra a négy rendszerkimenetelre képezhető le.
Példa kérés
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"
}A négy kimenetel példákkal
Minden VoP-válasz e négy eredmény valamelyikére vezethető vissza.
match
A név teljesen megegyezik a számlatulajdonossal – pl. Ön „Maria Rossi”-t küldött, és a számla „Maria Rossi”.
close match
Majdnem helyes – pl. Ön „M. Rossi”-t küldött, a tulajdonos pedig „Maria Rossi”. A megerősített nevet javaslatként adja vissza.
no match
A név nem egyezik az IBAN-nal – pl. „Acme Ltd” egy „Maria Rossi” nevű számlán. Erős csalásjelzés.
not possible
Az ellenőrzést nem sikerült befejezni – pl. a kedvezményezett bankja nem elérhető, vagy az IBAN még nincs lefedve.
Próbálja ki saját adataival
A RoxPay sandbox lehetővé teszi, hogy valós neveket és IBAN-okat küldjön, és pontosan lássa, melyik kimenetel érkezik vissza – a leggyorsabb módja a VoP viselkedésének megértésére az integráció előtt.
FAQ
Egy kis strukturált válasz, amely tartalmazza a kimenetelt (egyezés, részleges egyezés, nincs egyezés vagy nem elérhető), részleges egyezés esetén a megerősített számlanevet javaslatként, valamint a válaszadó bank BIC-kódját és egy kérésazonosítót.
Ha „M. Rossi”-t küld, miközben a számlatulajdonos „Maria Rossi”, az jellemzően részleges egyezést ad vissza, „Maria Rossi” javaslatával, hogy a fizető megerősíthesse vagy kijavíthassa a nevet.
Legalább a kedvezményezett nevét és az IBAN-t. Jogi személyek esetében egy szervezeti azonosító (például áfa- vagy cégjegyzékszám) is megadható a pontosabb egyeztetés érdekében.
Igen. A RoxPay sandboxot és API-dokumentációt biztosít, hogy példakéréseket küldhessen, és az élesítés előtt megvizsgálhassa az egyes kimenetelek válaszát.
Nézze meg a VoP API-t működés közben
Szerezzen sandbox-hozzáférést, és teszteljen valós kéréseket mind a négy kimenetellel.