Przykład Verification of Payee
Jak w praktyce wygląda weryfikacja VoP? Oto konkretny przykład: zapytanie, które wysyłasz, odpowiedź JSON, którą otrzymujesz, i jak wygląda każdy z czterech wyników.
Jak wygląda weryfikacja VoP w praktyce
Weryfikacja Verification of Payee to jedno pytanie zadawane w czasie rzeczywistym: czy ta nazwa/imię i nazwisko należy do tego IBAN? Przesyłasz nazwę odbiorcy i IBAN, a bank odpowiadający zwraca ustandaryzowany wynik, zanim płatność zostanie autoryzowana.
Poniżej znajduje się uproszczony przykład zapytania i odpowiedzi. Dokładne nazwy pól zależą od dostawcy, ale każda odpowiedź VoP odpowiada tym samym czterem wynikom określonym w schemacie.
Przykładowe zapytanie
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"
}Cztery wyniki, z przykładami
Każda odpowiedź VoP sprowadza się do jednego z tych czterech wyników.
zgodność
Nazwa w pełni odpowiada posiadaczowi konta - np. wysłano 'Maria Rossi', a konto należy do 'Maria Rossi'.
częściowa zgodność
Prawie zgodne - np. wysłano 'M. Rossi', a posiadaczem jest 'Maria Rossi'. Zweryfikowana nazwa jest zwracana jako propozycja.
brak zgodności
Nazwa nie odpowiada IBAN - np. 'Acme Ltd' na koncie należącym do 'Maria Rossi'. Silny sygnał ostrzegający przed oszustwem.
weryfikacja niemożliwa
Weryfikacji nie można zakończyć - np. bank odbiorcy jest niedostępny lub IBAN nie jest jeszcze objęty usługą.
Przetestuj na własnych danych
Środowisko testowe (sandbox) RoxPay pozwala wysyłać rzeczywiste nazwy i numery IBAN oraz zobaczyć, jaki wynik zostanie zwrócony - to najszybszy sposób, aby zrozumieć działanie VoP przed integracją.
FAQ
Jest to niewielka, ustrukturyzowana odpowiedź zawierająca wynik (zgodność, częściowa zgodność, brak zgodności lub weryfikacja niemożliwa), a w przypadku częściowej zgodności - zweryfikowaną nazwę konta jako propozycję, a także BIC banku odpowiadającego i identyfikator zapytania.
Wysłanie 'M. Rossi', gdy posiadaczem konta jest 'Maria Rossi', zwykle zwraca częściową zgodność, wraz z propozycją 'Maria Rossi', dzięki czemu płatnik może potwierdzić lub poprawić nazwę.
Co najmniej nazwę odbiorcy i IBAN. W przypadku osób prawnych można dodatkowo podać identyfikator organizacji (np. numer VAT lub numer rejestrowy), aby zwiększyć dokładność dopasowania.
Tak. RoxPay udostępnia środowisko testowe (sandbox) oraz dokumentację API, dzięki czemu możesz wysyłać przykładowe zapytania i sprawdzać odpowiedź dla każdego wyniku przed wdrożeniem produkcyjnym.
Zobacz API VoP w działaniu
Uzyskaj dostęp do środowiska testowego i przetestuj rzeczywiste zapytania dla wszystkich czterech wyników.