API Verification of Payee
Jedno wywołanie REST w czasie rzeczywistym, aby potwierdzić nazwę odbiorcy względem numeru IBAN - wynik, BIC banku odpowiadającego i czas przetwarzania w odpowiedzi. Zbudowane na platformie płatniczej RoxPay i schemacie SEPA VoP.
{ "Name": "ACME Trading Ltd", "Iban": "DE89 3704 0044 0532 0130 00" }
{ "VopResult": "MATCH", "MatchType": "MTCH", "RespondingBic": "CRACIT33XXX" }
Weryfikacja odbiorcy w jednym zapytaniu
API Verification of Payee udostępnia schemat SEPA VoP jako przejrzysty punkt końcowy REST: wysyłasz nazwę i numer IBAN, a w odpowiedzi otrzymujesz standaryzowany wynik w czasie rzeczywistym - bez konieczności budowania infrastruktury schematu samodzielnie.
To ta sama weryfikacja, którą RoxPay wykorzystuje wewnątrz swojej platformy bankowej SwiftLine / RoxBusiness, dostępna dla banków, PSP i firm poprzez uwierzytelnione API i panel. Każda odpowiedź zawiera typ zgodności, BIC instytucji odpowiadającej oraz czas przetwarzania przez PSP.
Ponieważ usługa jest dostarczana poprzez europejską infrastrukturę bankowość otwarta RoxPay, łączysz się jeden raz i uzyskujesz dostęp do weryfikacji odbiorcy w całej SEPA - zamiast integrować się z każdym bankiem odpowiadającym.
Od zera do zweryfikowanego w czterech krokach
Standardowa integracja REST, która wpisuje się w istniejący przepływ płatności.
Uzyskaj dane uwierzytelniające
Aktywuj usługę i uwierzytelnij się za pomocą tokenu Bearer - bez konieczności zarządzania wdrożeniem dla każdego banku.
Wyślij nazwę i numer IBAN
Wyślij metodą POST nazwę odbiorcy i numer IBAN do punktu końcowego weryfikacji, opcjonalnie z własnym identyfikatorem referencyjnym do rekoncyliacji.
Odczytaj wynik
Otrzymaj wynik (zgodność / częściowa zgodność / brak zgodności / nie dotyczy), BIC odpowiadający i czas przetwarzania.
Działaj w swoim interfejsie
Wyświetl jasny sygnał płatnikowi lub uzależnij od wyniku zwolnienie paczki płatności, mandatu lub etapu wdrożenia.
Co zwraca API
Każda odpowiedź odpowiada kodowi schematu SEPA VoP, dzięki czemu logika pozostaje prosta.
MATCH · MTCH
Nazwa odpowiada posiadaczowi rachunku. Odpowiedź zawiera również BIC banku odpowiadającego.
CLOSE_MATCH · CMTC
Częściowa zgodność - traktuj to jako łagodne ostrzeżenie i zaproponuj zweryfikowaną nazwę.
NO_MATCH · NMTC
Nazwa nie jest zgodna. Wyświetl jasne ostrzeżenie przed potwierdzeniem płatności.
NOT_APPLICABLE · NOAP
Weryfikacja niedostępna obecnie dla tego numeru IBAN. Pozwól użytkownikowi zdecydować.
Budowa VoP samodzielnie a API
Czego unikasz, wywołując jeden punkt końcowy, zamiast samodzielnie przystępować do schematu.
Budowa we własnym zakresie
- Łączność ze schematem Integracja z każdym PSP odpowiadającym
- Czas do uruchomienia produkcyjnego Miesiące
- Szczegółowość odpowiedzi Normalizujesz ją samodzielnie
- Ponowne użycie w różnych produktach Trzeba przebudować każdy przepływ
- Utrzymanie Po twojej stronie
API Verification of Payee
- Łączność ze schematem Jedno połączenie, zasięg w całej SEPA
- Czas do uruchomienia produkcyjnego Tygodnie
- Szczegółowość odpowiedzi Standaryzowany wynik + BIC + czas
- Ponowne użycie w różnych produktach Jedno API dla UI, partii i mandatów
- Utrzymanie Obsługiwane przez platformę
Jedno API, trzy grupy odbiorców
Ten sam punkt końcowy odpowiada na bardzo różne potrzeby.
Banki i PSP
Zaoferuj Verification of Payee posiadaczom rachunków i spełnij wymogi rozporządzenia w sprawie płatności natychmiastowych bez budowania łączności ze schematem.
Programiści
Przewidywalny kontrakt REST, odpowiedzi w czasie rzeczywistym, własne identyfikatory referencyjne i jasne kody schematu do rozgałęziania logiki.
Firmy i systemy ERP
Weryfikuj numery IBAN dostawców i wynagrodzeń w partiach przed zwolnieniem paczki płatności, ograniczając ryzyko przekierowania faktur.
API - odpowiedzi
Pytania, które najczęściej zadają programiści i zespoły produktowe.
Tak. Wywołanie weryfikacji zwraca odpowiedź synchronicznie, zwykle w czasie znacznie krótszym niż sekunda, i zawiera BIC banku odpowiadającego oraz czas przetwarzania przez PSP, dzięki czemu można monitorować wydajność.
Wywołania są uwierzytelniane za pomocą tokenu Bearer poprzez HTTPS. Można również skorzystać z panelu RoxBusiness do doraźnych weryfikacji bez pisania kodu.
Znormalizowany wynik (MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE), kod typu zgodności schematu SEPA, identyfikator weryfikacji, BIC odpowiadający, czas przetwarzania i opcjonalny zewnętrzny identyfikator.
Tak - wywołaj punkt końcowy dla każdego rekordu, aby zweryfikować cały plik dostawców lub odbiorców przed zwolnieniem paczki płatności. Rozwiązanie jest przygotowane na dużą przepustowość.
Tak. Weryfikacja porównuje przesłaną nazwę z zarejestrowanym posiadaczem rachunku, niezależnie od tego, czy jest to osoba fizyczna czy firma, i jest wykorzystywana w przepływie mandatów polecenie zapłaty SEPA RoxPay jako kontrola wstępna.
NO_MATCH nie jest błędem transportu - to prawidłowa odpowiedź 200 informująca, że nazwa nie należy do tego numeru IBAN. Traktuj to jako zdecydowany stop w swoim interfejsie lub paczce płatności: wyświetl jasne ostrzeżenie, zablokuj automatyczną akceptację i pozwól użytkownikowi ponownie zweryfikować odbiorcę przed wysłaniem.
CLOSE_MATCH (kod schematu CMTC) oznacza, że nazwa jest prawie prawidłowa - brakuje drugiego imienia, występuje nazwa prawna inna niż nazwa handlowa. Odpowiedź zawiera zweryfikowaną nazwę posiadacza rachunku, dzięki czemu można ją wyświetlić jako propozycję i poprosić płatnika o potwierdzenie, zamiast odrzucać płatność.
Dla osób prawnych schemat umożliwia weryfikację względem identyfikatora organizacji (np. polskiego NIP) oprócz nazwy. Przesyłasz identyfikator w zapytaniu, a API zwraca standardowy wynik zgodności - przydatne, gdy nazwa zarejestrowana różni się od nazwy handlowej.
Tak. Przed zwolnieniem paczki płatności przejdź przez plik dostawców lub wynagrodzeń i wywołaj punkt końcowy weryfikacji dla każdego rekordu. Rozwiązanie jest przygotowane na dużą przepustowość, dzięki czemu zespoły finansowe mogą masowo walidować numery IBAN względem nazw przed każdym przelewem.
Tak. Wysyłasz zapytanie JSON z nazwą odbiorcy i numerem IBAN, a w odpowiedzi otrzymujesz wynik, zweryfikowaną nazwę (w przypadku częściowej zgodności) i BIC odpowiadający. Zobacz pełne zapytanie i odpowiedź w naszym przykładzie VoP, a struktury danych i kody schematu w dokumentacji API.
Czytaj dalej
Zintegruj Verification of Payee
Uzyskaj dane uwierzytelniające i uruchom produkcyjnie schemat SEPA VoP za pomocą jednej integracji REST.