Sprawdź format krajowy, długość i cyfry kontrolne przed zapisaniem danych płatniczych klienta.
API walidacji IBAN SEPA
Sprawdzaj IBAN i uczestnictwo banku w systemach SEPA
Sprawdź IBAN oraz uczestnictwo banku w przelewach SEPA, przelewach natychmiastowych i poleceniach zapłaty Core oraz B2B. Otrzymuj osobny wynik dla każdego schematu w jednej odpowiedzi JSON, na podstawie danych bankowych i rejestrów uczestników EPC.
Zacznij od 10 bezpłatnych zapytań API na każde 24 godziny.
Czy IBAN jest prawidłowy i czy bank obsługuje Twój schemat SEPA?
To dwie odrębne weryfikacje. IBAN może przejść kontrolę formatu i cyfr kontrolnych, mimo że uczestnictwo banku w danym schemacie płatniczym pozostaje niepotwierdzone. Sprawdzaj oba aspekty podczas zbierania danych do płatności lub przygotowywania paczki płatności.
Korzystaj z dostępnych katalogów bankowych, aby ustalić bank i jego BIC. Weryfikacja w katalogach jest dostępna dla 40 krajów.
Odczytaj osobny wynik dla przelewu, przelewu natychmiastowego lub polecenia zapłaty.
Cztery schematy SEPA, cztery niezależne wyniki
Przelew SEPA
details.sepa.sct
Pokazuje uczestnictwo banku w standardowym schemacie przelewów SEPA.
Przelew natychmiastowy SEPA
details.sepa.sctInst
Pokazuje uczestnictwo w schemacie przelewów natychmiastowych. Nie jest to kontrola dostępności przez RT1/TIPS w czasie rzeczywistym ani gwarancja natychmiastowej realizacji.
Polecenie zapłaty Core
details.sepa.sddCore
Pokazuje uczestnictwo w schemacie poleceń zapłaty SEPA Core.
Polecenie zapłaty B2B
details.sepa.sddB2b
Pokazuje uczestnictwo w schemacie B2B dla firm. Nie wyciągaj tego wniosku na podstawie wyniku Core.
Dane uczestników pochodzą z osobnych rejestrów schematów European Payments Council. Potwierdzony wynik wymaga jednoznacznego przypisania banku oraz dopasowania do uczestnika z aktualnym statusem uczestnictwa w aktualnych danych rejestrowych.
Żądanie API SEPA i odpowiedź JSON
Użyj punktu końcowego walidacji IBAN ze swoim kluczem API. Wyniki SEPA są dołączane, gdy zwracane są dane banku; dodatkowe żądanie sprawdzające schematy nie jest potrzebne.
curl --get "https://www.iban-test.eu/api/v2/iban/validate" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--data-urlencode "iban=DE89370400440532013000"Przykładowy fragment odpowiedzi zawierający wyłącznie pola SEPA. Rzeczywiste wyniki zależą od IBAN oraz dostępnych danych rejestrowych.
{
"details": {
"sepa": {
"sct": {
"status": "confirmed",
"reason": "matched"
},
"sctInst": {
"status": "confirmed",
"reason": "matched"
},
"sddCore": {
"status": "confirmed",
"reason": "matched"
},
"sddB2b": {
"status": "confirmed",
"reason": "matched"
}
}
}
}Prawidłowo obsługuj wyniki potwierdzone i nieznane
Najpierw obsłuż nieprawidłowe numery IBAN. Uczestnictwo w SEPA jest dodatkową informacją i nie zmienia wyniku walidacji IBAN.
confirmed z przyczyną matched potwierdza uczestnictwo banku w danym schemacie. Każdy schemat należy oceniać oddzielnie.
unknown oznacza, że nie udało się potwierdzić uczestnictwa. Sprawdź przyczynę i zastosuj dodatkową weryfikację lub procedurę alternatywną, zamiast automatycznie oznaczać bank jako nieobsługujący schematu.
Na przykład missing_bic oznacza brak dostępnego BIC banku, no_match oznacza brak pasującego uczestnika, a stale_data oznacza nieaktualne dane rejestru.
To API sprawdza IBAN i uczestnictwo banku. Nie inicjuje płatności, nie weryfikuje właściciela ani istnienia rachunku, nie potwierdza zgody na polecenie zapłaty i nie gwarantuje rozliczenia. Możliwość użycia konkretnego rachunku oraz trasowanie płatności w czasie rzeczywistym musi obsłużyć Twój dostawca usług płatniczych.
Dodaj weryfikację SEPA do procesu płatności
Wykorzystuj te wyniki podczas rejestracji klientów, konfiguracji poleceń zapłaty i przygotowywania płatności. Zacznij od bezpłatnego klucza API, przeanalizuj odpowiedź i obsłuż wymagany schemat w swojej aplikacji.
Informacje o sprawdzaniu formatu, cyfr kontrolnych i katalogów bankowych znajdziesz na stronie API walidacji IBAN.