API open banking: płatności, dane z rachunków i MCP
Jedno API do płatności z konta i danych z rachunków, callbacki ze statusami, serwer MCP dla agentów AI i gotowy widżet zgody. Napisz na [email protected], a wyślemy klucze do sandboxa.
Jak zacząć
- Krok 01
Napisz do nas
Na [email protected]: kim jesteś i co budujesz. Odsyłamy apiKey i token do sandboxa.
- Krok 02
Połącz się z sandboxem
Sandbox api.sandbox.fizen.com ma banki testowe, które symulują logowanie i SCA. Działa w godzinach 8:00-18:00 UTC, bez ograniczeń IP.
- Krok 03
Wykonaj pierwsze wywołanie
Zainicjuj płatność albo pobierz transakcje z rachunku testowego. Statusy przychodzą webhookiem na Twój adres.
Klucze do sandboxa
Dziś wydajemy je mailem, po krótkiej rozmowie. Klucze produkcyjne po weryfikacji firmy.
Produkty API
| Produkt | Co robi | Typowe użycie |
|---|---|---|
| Płatności (PIS) | Inicjuje przelew z rachunku płacącego, zatwierdzany w aplikacji jego banku. | Checkout, płatności cykliczne, odroczone i masowe |
| Dane (AIS) | Udostępnia salda, transakcje i dane posiadacza rachunku za zgodą użytkownika. | Scoring, weryfikacja klienta, księgowość, matching |
| MCP | Serwer Model Context Protocol, który daje agentom AI dostęp do danych z rachunków, tylko do odczytu. | Asystenci AI dla osób, firm i biur rachunkowych |
| Fizen Connect | Gotowy widżet: wybór banku, zgoda, wybór rachunków. Osadzasz go w swojej aplikacji. | Najszybsza integracja bez własnego UI zgody |
| Webhooki | Powiadomienia o zmianie statusu płatności, zgody i nowych transakcjach. | Aktualizacja zamówień i sald bez odpytywania API |
Płatności (PIS)
- Co robi
- Inicjuje przelew z rachunku płacącego, zatwierdzany w aplikacji jego banku.
- Typowe użycie
- Checkout, płatności cykliczne, odroczone i masowe
Dane (AIS)
- Co robi
- Udostępnia salda, transakcje i dane posiadacza rachunku za zgodą użytkownika.
- Typowe użycie
- Scoring, weryfikacja klienta, księgowość, matching
MCP
- Co robi
- Serwer Model Context Protocol, który daje agentom AI dostęp do danych z rachunków, tylko do odczytu.
- Typowe użycie
- Asystenci AI dla osób, firm i biur rachunkowych
Fizen Connect
- Co robi
- Gotowy widżet: wybór banku, zgoda, wybór rachunków. Osadzasz go w swojej aplikacji.
- Typowe użycie
- Najszybsza integracja bez własnego UI zgody
Webhooki
- Co robi
- Powiadomienia o zmianie statusu płatności, zgody i nowych transakcjach.
- Typowe użycie
- Aktualizacja zamówień i sald bez odpytywania API
Przykłady kodu
Przykłady są poglądowe. Dokładne ścieżki i pola znajdziesz w dokumentacji.
curl -X POST "https://api.sandbox.fizen.com/[ścieżka inicjacji płatności]" \ -H "apiKey: [TWÓJ_API_KEY]" \ -H "token: [TWÓJ_TOKEN]" \ -H "Content-Type: application/json" \ -d '{ "amount": "149.00", "currency": "PLN", "description": "Zamówienie 10482", "recipientIban": "[IBAN odbiorcy]", "redirectUrl": "https://twoj-sklep.pl/platnosc/powrot" }'curl "https://api.sandbox.fizen.com/[ścieżka listy transakcji]?accountId=[ID rachunku]&dateFrom=2026-10-01" \ -H "apiKey: [TWÓJ_API_KEY]" \ -H "token: [TWÓJ_TOKEN]"{ "mcpServers": { "fizen": { "type": "http", "url": "https://mcp.fizen.com" } }}<script src="[URL skryptu Fizen Connect]"></script><div id="fizen-connect"></div><script>FizenConnect.mount('#fizen-connect', { sessionId: '[ID sesji z API]' })</script>Dokumentacja i narzędzia
- Pokrycie bankoweLista banków z etapem wdrożenia AIS i PIS.
- CennikDane od 0 zł, płatności 0,5% od transakcji, bez opłat stałych.
- DokumentacjaPrzewodniki, quickstart i opis przepływów.
- API referenceWszystkie endpointy, pola i kody błędów.
- ChangelogZmiany w API i nowe banki.
- GitHubPrzykładowe integracje i SDK [jeśli są].
- PostmanGotowa kolekcja do sandboxa.
Jak dostać klucze produkcyjne
Weryfikacja trwa zwykle 3 dni robocze. Wymagamy jej, bo usługi świadczymy pod nadzorem KNF (dane jako dostawca AIS, płatności z licencjonowanym partnerem) i musimy znać firmę oraz cel, w jakim korzysta z danych i płatności.
- Krok 01
Umowa i weryfikacja firmy
Podpisujesz umowę, przesyłasz dane rejestrowe i wskazujesz beneficjenta rzeczywistego.
- Krok 02
Opis przypadku użycia
Opisujesz, do czego używasz płatności lub danych i jak informujesz użytkowników o zgodzie.
- Krok 03
Konfiguracja produkcji
Zgłaszasz adresy IP do whitelisty i adresy webhooków, dostajesz klucze produkcyjne.
Co przygotować
- KRS lub CEIDG, NIP i dane kontaktowe osoby technicznej
- Informację o beneficjencie rzeczywistym
- Opis przepływu i ekranów zgody dla użytkownika
- Stałe adresy IP serwerów, z których wołasz API
- Adres URL webhooków (HTTPS)
Pytania programistów
Jakie są limity zapytań?
Domyślnie [N] zapytań na minutę na klucz. Przy większym wolumenie podnosimy limit po rozmowie. Dodatkowo PSD2 ogranicza pobieranie danych bez obecności użytkownika do 4 razy na dobę na rachunek.
Co dzieje się po 180 dniach od udzielenia zgody?
Zgoda AIS jest ważna 180 dni zgodnie z PSD2. Przed wygaśnięciem wysyłamy webhook, a użytkownik odnawia zgodę jednym potwierdzeniem w banku (SCA). Bez odnowienia dostęp do danych wygasa.
Czy obsługujecie rachunki firmowe?
Tak, ale zakres zależy od banku: część banków udostępnia rachunki firmowe stabilnie, część z ograniczeniami (np. tylko jeden użytkownik bankowości). Aktualny stan per bank jest na stronie Banki.
W jakim formacie są dane?
REST API zwraca JSON przez HTTPS, webhooki też są w JSON. Transakcje mają ujednolicony format niezależnie od banku. Schematy są w API reference.
Jakie banki są w sandboxie?
Sandbox ma banki testowe, które symulują logowanie, SCA, wiele rachunków i typowe błędy. Dzięki temu przetestujesz cały przepływ bez prawdziwego konta. Lista banków testowych jest w dokumentacji.
Sprawdź Fizen na własnych danych
Konta dla firm i klucze API wydajemy po krótkiej rozmowie: napisz, czym się zajmujesz, odezwiemy się w ciągu jednego dnia roboczego. Prywatnie możesz zacząć od razu.