Verification of Payee jest koncepcyjnie proste: pytasz, czy nazwa odpowiada numerowi IBAN, i otrzymujesz w odpowiedzi standaryzowany wynik. Jednak solidna integracja zależy od zrozumienia każdej części tej wymiany i zasilania jej czystymi danymi.
Strona żądania
- Nazwa odbiorcy: nazwa w takiej formie, jakiej się oczekuje, najlepiej ustrukturyzowana i czysta.
- IBAN: konto podlegające weryfikacji.
- Typ konta: czy odbiorca jest osobą fizyczną czy organizacją, co wpływa na dopasowanie.
- Referencja żądania lub klucz idempotencji łączący wywołanie z Twoimi rekordami.
Strona odpowiedzi
- Wynik: zgodność, częściowa zgodność, brak zgodności lub niedostępne.
- W przypadku częściowej zgodności - nazwa faktycznie zarejestrowana na koncie, którą możesz pokazać płatnikowi.
- Kod przyczyny lub statusu dający kontekst wyniku.
- Identyfikator do korelacji z Twoimi logami i rekoncyliacją.
Śmieci na wejściu, słaba zgodność na wyjściu
Dokładność zgodności zależy od jakości danych wejściowych. Wysyłanie czystych, dobrze ustrukturyzowanych nazw oraz właściwego typu konta znacząco poprawia wyniki.
Projektowanie wokół modelu
API Verification of Payee od RoxPay udostępnia jasny model żądania/odpowiedzi ze standaryzowanymi wynikami i informacjami pomocniczymi, dzięki czemu Twoja integracja może działać na podstawie wyników z pewnością.