Integracja Stripe z KSeF

KSeF (Krajowy System e-Faktur) to centralny system informatyczny Ministerstwa Finansów, który służy do wystawiania, odbierania i przechowywania faktur ustrukturyzowanych w Polsce. Został uruchomiony dobrowolnie w 2022 roku, a obowiązek wchodzi etapami: od 1 lutego 2026 dla dużych firm (sprzedaż w 2024 powyżej 200 mln zł brutto) i od 1 kwietnia 2026 dla wszystkich pozostałych przedsiębiorców.

W praktyce KSeF działa jak centralny rejestr faktur prowadzony przez państwo. Zamiast wysyłać fakturę bezpośrednio do kontrahenta (e-mailem, pocztą, PDF-em), wystawiasz ją w KSeF. System nadaje fakturze unikalny numer KSeF, potwierdza jej poprawność i udostępnia ją odbiorcy. Faktura istnieje w jednym miejscu (w systemie rządowym) i obie strony transakcji mają do niej dostęp.

Faktura w KSeF to nie PDF ani skan. To plik XML w ściśle określonej strukturze (schemat FA(2)), zawierający wszystkie wymagane dane: dane sprzedawcy i nabywcy, NIP-y, pozycje, stawki VAT, kwoty netto i brutto, datę wystawienia i datę sprzedaży. Format jest jednolity dla wszystkich, dzięki czemu urząd skarbowy może automatycznie weryfikować faktury i krzyżowo sprawdzać deklaracje VAT.

Dlaczego Polska wprowadza KSeF?

Głównym celem KSeF jest uszczelnienie systemu VAT i walka z luką podatkową. Ministerstwo Finansów szacuje, że luka VAT w Polsce wynosi kilkanaście miliardów złotych rocznie. Obowiązkowe e-faktury pozwalają administracji skarbowej:

• Weryfikować faktury w czasie rzeczywistym, co eliminuje fikcyjne faktury
• Automatycznie sprawdzać zgodność deklaracji VAT z wystawionymi i otrzymanymi fakturami
• Wykrywać karuzele VAT i oszustwa na wczesnym etapie
• Przyspieszyć zwroty VAT dla firm, które wystawiają faktury wyłącznie przez KSeF

Dla przedsiębiorców KSeF oznacza też korzyści: brak konieczności przechowywania papierowych faktur (system archiwizuje je przez 10 lat), uproszczoną wymianę dokumentów z kontrahentami i szybsze zwroty VAT (40 zamiast 60 dni).

Jeśli przyjmujesz płatności przez Stripe w Polsce, masz problem. Od 2026 roku każda faktura musi trafić do KSeF. Stripe tego nie robi, ponieważ nie ma integracji z polskim systemem fakturowania i nie planuje jej w najbliższej przyszłości.

Stripe posiada wbudowane fakturowanie (Stripe Invoicing), ale generuje ono zwykłe faktury PDF, a nie faktury ustrukturyzowane w formacie XML wymaganym przez KSeF. Nawet jeśli korzystasz ze Stripe Invoicing, te faktury nie są uznawane przez polski system i nie spełniają nowych wymogów prawnych.

To oznacza, że bez dodatkowego narzędzia musisz ręcznie wystawiać faktury w osobnym programie za każdą płatność ze Stripe. Przy kilkunastu transakcjach dziennie to strata czasu i ryzyko błędów: pomylone kwoty, brakujące NIP-y, opóźnione faktury.

Potrzebujesz pośrednika, czyli sposobu na przeniesienie danych z płatności Stripe do polskiego programu księgowego, który wystawi fakturę ustrukturyzowaną i wyśle ją do KSeF. Są na to trzy drogi, różniące się czasem wdrożenia, kosztem i ryzykiem.

Każda polska firma przyjmująca płatności przez Stripe ma ten sam problem i w zasadzie trzy możliwe rozwiązania. Poniżej uczciwe porównanie: co się opłaca komu i na jakich warunkach.

Niezależnie od tego, czy wybierasz własny kod, czy gotowe narzędzie, ogólny przepływ danych wygląda tak samo. Stripe nie wysyła faktur bezpośrednio do KSeF, bo to polski system, którego Stripe nie obsługuje. W środku musi być pośrednik, czyli polski program do fakturowania z oficjalnym wsparciem KSeF (Fakturownia, inFakt lub wFirma). Przepływ danych wygląda następująco:

Podłączenie Stripe do KSeF przez Stripto zajmuje dosłownie minutę. Nie musisz pisać kodu, konfigurować webhooków ani bawić się w XML. Oto jak to zrobić:

Wdrożenie KSeF przeszło kilka zmian terminów. Poniżej aktualny harmonogram obowiązujący w 2026 roku:

Krótka odpowiedź: każdego, kto wystawia faktury w Polsce. Ale diabeł tkwi w szczegółach: kto musi wejść do KSeF od lutego, a kto od kwietnia?

Od 1 lutego 2026: duże firmy (powyżej 200 mln zł sprzedaży)

W pierwszym etapie do KSeF wchodzą największe firmy, czyli przedsiębiorcy, których wartość sprzedaży (razem z kwotą VAT) przekroczyła w 2024 roku 200 mln zł. To zwykle:

• Duże spółki akcyjne i grupy kapitałowe
• Sieci handlowe i e-commerce o dużych obrotach
• Dostawcy B2B obsługujący duże kontrakty
• Oddziały dużych firm zagranicznych zarejestrowane w Polsce jako podatnicy VAT

Od 1 kwietnia 2026: wszystkie pozostałe firmy

Dwa miesiące później dołączają wszyscy pozostali przedsiębiorcy, niezależnie od tego, czy są czynnymi podatnikami VAT, czy są z VAT zwolnieni (podmiotowo bądź przedmiotowo). Dotyczy to w praktyce zdecydowanej większości firm w Polsce:

• Spółek z o.o., spółek akcyjnych i innych spółek prawa handlowego poniżej progu 200 mln zł
• Jednoosobowych działalności gospodarczych (JDG), zarówno czynnych podatników VAT, jak i zwolnionych
• Spółek cywilnych i jawnych
• Firm zwolnionych podmiotowo z VAT (obrót poniżej 200 000 zł) oraz zwolnionych przedmiotowo

Od 1 stycznia 2027: najmniejsi podatnicy

W okresie przejściowym (do końca 2026) z obowiązku KSeF są tymczasowo wyłączeni tak zwani cyfrowo wykluczeni, czyli przedsiębiorcy z niską miesięczną sprzedażą do 10 tys. zł. Od 1 stycznia 2027 również oni muszą wystawiać faktury w KSeF, tego dnia wygasa też możliwość wystawiania faktur z poziomu kas rejestrujących.

Specyfika firm przyjmujących płatności przez Stripe

Jeśli prowadzisz firmę w Polsce i przyjmujesz płatności online przez Stripe (SaaS, e-commerce, kursy, subskrypcje), z dużym prawdopodobieństwem musisz wystawiać faktury w KSeF. Typowe scenariusze:

• SaaS B2B: klienci firmowi potrzebują faktur VAT do odliczenia kosztów. Każda faktura musi trafić do KSeF.
• E-commerce: sprzedaż produktów cyfrowych i fizycznych. Faktury dla klientów B2B obowiązkowo w KSeF. Paragony dla konsumentów (B2C) poza KSeF, chyba że klient zażąda faktury.
• Kursy i szkolenia online: jeśli sprzedajesz przez Stripe Checkout i wystawiasz faktury, muszą one trafić do KSeF.
• Subskrypcje: cykliczne płatności generują cykliczne faktury. Automatyzacja przez Stripto oznacza, że każda płatność automatycznie tworzy fakturę w KSeF.

Faktura ustrukturyzowana w KSeF to plik XML zgodny ze schematem FA(2) opublikowanym przez Ministerstwo Finansów. Nie musisz znać XML-a, bo program do fakturowania (Fakturownia, inFakt lub wFirma) generuje go automatycznie. Ale warto wiedzieć, jakie dane musi zawierać poprawna faktura:

Stripe to globalny procesor płatności obsługujący firmy w ponad 40 krajach. Jego model biznesowy opiera się na uniwersalnym API z jednym rozwiązaniem dla wszystkich rynków. KSeF to polski system wymagający specyficznej integracji, która dotyczy wyłącznie jednego kraju.

Jest kilka powodów, dla których Stripe nie planuje integracji z KSeF:

• Skala vs. lokalizacja: Stripe skupia się na globalnych funkcjach (płatności, subskrypcje, Checkout). Integracja z systemem fakturowania jednego kraju nie pasuje do tego modelu. Każdy kraj ma inne wymagania, np. Włochy mają SDI, Francja ma Chorus Pro, Hiszpania ma SII. Stripe nie integruje się z żadnym z nich.
• Stripe Invoicing ≠ faktura ustrukturyzowana: Stripe Invoicing generuje PDF-y do zbierania płatności. To narzędzie do wysyłania rachunków, nie do spełniania wymogów podatkowych poszczególnych krajów. Format faktury Stripe nie jest zgodny ze schematem XML FA(2) wymaganym przez KSeF.
• Brak obecności prawnej w Polsce: Stripe operuje w Polsce przez irlandzki podmiot (Stripe Payments Europe). Nie ma dedykowanego zespołu ds. polskiego compliance, który mógłby budować i utrzymywać integrację z KSeF.
• Marketplace integracji: Stripe tradycyjnie zostawia lokalne integracje partnerom (takim jak Stripto). To samo robi z księgowością (Xero, QuickBooks), podatkami (TaxJar, Avalara) i innymi lokalnymi wymaganiami.

Wniosek jest prosty: Stripe nie zintegruje się z KSeF. Potrzebujesz pośrednika, czyli programu do fakturowania, który przyjmie dane ze Stripe i wystawi fakturę ustrukturyzowaną w KSeF. Dokładnie to robi Stripto.

Fakturownia.pl to jeden z najpopularniejszych polskich programów do fakturowania online z ponad 100 000 użytkowników. Oficjalnie wspiera KSeF: po autoryzacji kontem w systemie Ministerstwa Finansów faktury wystawiane w Fakturowni są automatycznie konwertowane do formatu XML FA(2), podpisywane i wysyłane do KSeF. Każda faktura dostaje numer KSeF, który można pobrać przez API Fakturowni.

Autoryzacja KSeF w Fakturowni:

• Logowanie na konto Fakturowni i przejście do Ustawienia → KSeF
• Wygenerowanie tokena autoryzacyjnego KSeF przez portal Ministerstwa Finansów
• Wklejenie tokena w ustawieniach Fakturowni (wspiera też podpis kwalifikowany i profil zaufany)
• Automatyczne wysyłanie faktur do KSeF można włączyć dla całego konta albo per typ dokumentu

Co Fakturownia oferuje w kontekście KSeF:

• Automatyczne wysyłanie faktur sprzedażowych do KSeF zaraz po wystawieniu
• Walidację danych jeszcze przed wysyłką (NIP, stawki VAT, kompletność pól)
• Obsługę faktur korygujących i zaliczkowych w formacie FA(2)
• Synchroniczne API z natychmiastową odpowiedzią (przydatne przy automatyzacjach)
• Odbiór faktur zakupowych z KSeF bezpośrednio do panelu Fakturowni

Do połączenia Stripe z Fakturownią potrzebujesz klucza API (Ustawienia → API → Token API) i nazwy domeny konta (np. twojafirma.fakturownia.pl). Możesz użyć ich we własnym kodzie albo wkleić do gotowej integracji jak Stripto. W obu przypadkach to Fakturownia odpowiada za wysyłkę do KSeF, różnica polega na tym, kto pisze warstwę łączącą Stripe z Fakturownią. Szczegóły mapowania danych i typowe problemy znajdziesz w dedykowanym przewodniku Stripe + Fakturownia.

inFakt to drugi popularny polski program do fakturowania i księgowości online, szczególnie ceniony wśród jednoosobowych działalności gospodarczych. W przeciwieństwie do Fakturowni, inFakt łączy wystawianie faktur z pełną księgowością: KPiR, ryczałt, deklaracje VAT i JPK. Dzięki temu jeden program zajmuje się całym backendem podatkowym firmy, a KSeF to jedna z jego wielu funkcji.

Autoryzacja KSeF w inFakt:

• Logowanie na konto inFakt i przejście do Ustawienia → KSeF
• Wygenerowanie tokena autoryzacyjnego w systemie KSeF (portal Ministerstwa Finansów)
• Wklejenie tokena i podpisanie elektroniczne (podpis kwalifikowany, profil zaufany lub pieczęć elektroniczna)
• Włączenie automatycznego wysyłania faktur sprzedażowych do KSeF

Co inFakt oferuje w kontekście KSeF:

• Automatyczne wysyłanie faktur do KSeF po wystawieniu (w tle, bez klikania)
• Automatyczne pobieranie numerów KSeF i zapisywanie ich przy fakturze
• Odbiór faktur zakupowych z KSeF i automatyczne księgowanie ich w KPiR
• Obsługę faktur korygujących i zaliczkowych zgodnych z FA(2)
• Automatyczne generowanie JPK-V7 na podstawie faktur z KSeF

Do połączenia Stripe z inFakt potrzebujesz tylko klucza API (Ustawienia → Integracje → Klucz API), bez osobnej domeny. Specyfika API inFakt to format kwot w groszach i asynchroniczne tworzenie faktur (status trzeba odpytywać). Możesz podłączyć Stripe własnym kodem lub gotową integracją (np. Stripto). Szczegóły mapowania danych i wbudowanej księgowości znajdziesz w dedykowanym przewodniku Stripe + inFakt.

Poprawna faktura ustrukturyzowana wymaga kompletnych danych kupującego: nazwy firmy, NIP-u i adresu. To warunek, żeby faktura przeszła walidację w KSeF. Dobra wiadomość jest taka, że Stripe Checkout potrafi zebrać wszystkie te dane od klienta już w trakcie płatności, dzięki czemu trafiają do programu księgowego razem z kwotą i walutą transakcji. Trzy pola, które musisz mieć:

• NIP: pobierany ze Stripe Tax ID (pole tax_id w Checkout Session). Stripe obsługuje NIP-y z ponad 50 krajów, polski numer VAT to typ pl_vat.
• Nazwa firmy: z pola billing details (company name). Pojawia się na fakturze jako dane nabywcy.
• Adres: ulica, miasto, kod pocztowy i kraj z billing address w Stripe Checkout. KSeF wymaga co najmniej kraju i kodu pocztowego dla kontrahentów z Polski.

Jak włączyć zbieranie NIP w Stripe Checkout

Domyślnie Stripe Checkout nie pyta o NIP ani adres. Musisz to włączyć ręcznie. W Stripe Dashboard przejdź do Settings → Checkout i zaznacz opcję "Collect tax IDs". Dodatkowo włącz "Collect billing address" w trybie "required" albo "auto". Jeśli tworzysz Checkout Session programowo, dodaj do requestu parametry:

tax_id_collection: { enabled: true },
billing_address_collection: "required"

Wtedy klient w formularzu Checkout zobaczy dodatkowe pola: typ NIP-u (wybiera kraj), numer NIP i adres rozliczeniowy. Stripe waliduje format NIP-u po stronie klienta zanim przyjmie płatność.

Szczegóły konfiguracji z gotowym kodem znajdziesz w poradniku o fakturach ze Stripe.

Co jeśli klient nie poda NIP-u?

W przypadku sprzedaży B2C (do konsumentów) NIP nie jest wymagany na fakturze i to jest OK. Jeśli klient B2B nie poda NIP-u, masz dwa wyjścia: wymusić podanie NIP-u na poziomie Checkout Session (parametr customer_update.address: "auto" + własna walidacja w webhooku) albo uzupełnić NIP później ręcznie w panelu programu księgowego przed wysyłką do KSeF. Drugie podejście jest wygodniejsze dla klienta, ale wymaga dyscypliny po twojej stronie.

Ustawodawca przewidział okres przejściowy i sankcje za niestosowanie się do obowiązku KSeF. Oto co warto wiedzieć:

Okres przejściowy w 2026 roku

Do końca 2026 roku KSeF jest już obowiązkowy (od 1 lutego dla dużych firm, od 1 kwietnia dla pozostałych), ale kary finansowe nie są jeszcze naliczane. Ministerstwo Finansów daje firmom czas na wdrożenie systemów. Jednak faktura wystawiona poza KSeF nie jest uznawana za fakturę ustrukturyzowaną, co może powodować problemy u kontrahentów (np. brak możliwości odliczenia VAT). W okresie przejściowym można też wystawiać faktury z kas rejestrujących, a najmniejsi podatnicy (sprzedaż do 10 tys. zł miesięcznie) mogą odroczyć wejście do KSeF do 1 stycznia 2027.

Od 1 stycznia 2027: kary finansowe

Po zakończeniu okresu przejściowego Ministerstwo Finansów może nałożyć kary za wystawianie faktur poza KSeF:

• Do 100% kwoty VAT na fakturze za wystawienie faktury poza KSeF, gdy istniał obowiązek jej wystawienia w KSeF
• Minimum 1 000 zł kary za każdą fakturę wystawioną poza KSeF (nawet jeśli kwota VAT jest niższa)

Przy kilkunastu transakcjach dziennie kary mogą szybko rosnąć. Dla firmy przetwarzającej 100 faktur miesięcznie po 500 zł netto (115 zł VAT każda), potencjalna kara to 11 500 zł miesięcznie.

Konsekwencje dla kontrahentów

Nawet w okresie przejściowym wystawianie faktur poza KSeF ma konsekwencje. Twoi kontrahenci B2B mogą mieć problem z odliczeniem VAT z faktury, która nie jest fakturą ustrukturyzowaną. To może wpłynąć na relacje biznesowe, bo kontrahent może wymagać faktur z KSeF, żeby nie ryzykować problemów z urzędem skarbowym.