Integracja Stripe z KSeF
Stripe co miesiąc pobiera opłaty za subskrypcje, a faktury do KSeF ktoś wciąż przepisuje ręcznie albo eksportuje z CSV. Po integracji każda płatność sama staje się fakturą w KSeF, a zwrot korektą.
Co będzie działać samo
- klient płaci
- zwrot lub obniżka
- NIP klienta ze Stripe
- sprawdza NIP
- wystawia fakturę
- pilnuje, żeby nic nie zginęło
- faktura w KSeF
- numer KSeF
- potwierdzenie odbioru
Subskrypcja odnowiona i opłacona
Gdy Stripe pobierze opłatę, integracja wystawia na jej podstawie fakturę i wysyła ją do KSeF. Numer KSeF zapisuje się przy fakturze w Stripe, więc widać go w panelu i w Twojej aplikacji.
Zwrot, rabat lub zmiana planu
Zwrot lub obniżka wystawiona w Stripe tworzy fakturę korygującą, która wskazuje numer KSeF faktury pierwotnej. Proporcjonalne rozliczenia przy zmianie planu trafiają na fakturę jako osobne pozycje.
KSeF nie odpowiada
Faktura czeka i sama wysyła się ponownie, a przy ogłoszonej awarii idzie w trybie awaryjnym. Stripe dalej pobiera płatności, żadna faktura nie ginie.
Jak wygląda wdrożenie
- 1Rozmowa, 30 minut. Jak dziś rozliczasz Stripe, kto płaci (firmy z Polski, z UE, konsumenci), w jakich walutach i co ma się zmienić.
- 2Środowisko testowe KSeF. Pierwsze faktury idą ze Stripe w trybie testowym na środowisko testowe Ministerstwa Finansów, nie do urzędu. Sprawdzasz je na spokojnie.
- 3Odbiór z księgową. Razem przechodzimy stawki VAT, odwrotne obciążenie dla firm z UE, waluty, zwroty i moment wystawienia faktury przy subskrypcjach.
- 4Produkcja i opieka. Przełączenie na produkcyjny KSeF i na prawdziwe płatności w Stripe, alert e-mail, gdy faktura utknie, poprawki w cenie przez 30 dni.
Gotowa aplikacja czy integracja?
Gotowe usługi łączące Stripe z KSeF lub z programem do faktur (Fakturownia, inFakt, wFirma) wystarczą, gdy masz prosty cennik i klientów w Polsce. Integracja szyta na miarę ma sens, gdy
- sprzedajesz w kilku walutach i do firm z całej UE
- rozliczasz klientów za zużycie lub często zmieniają plany
- masz kilka kont Stripe lub Stripe Connect i jedną firmę
- faktury muszą trafić też do Optimy, Subiekta lub systemu księgowego biura
- chcesz mieć numer KSeF w Stripe i we własnej bazie klientów
Dla 5 pierwszych firm 30% taniej. W zamian zgadzasz się, żebym pokazał to wdrożenie jako przykład na swojej stronie (bez poufnych danych), i wystawiasz opinię w Google.
Zajmij miejsce →Pytania
Brakuje Twojego? Napisz je w formularzu, odpowiem konkretnie.
Stripe sam wystawia faktury. Czy to nie wystarczy?
Nie. Faktura ze Stripe Invoicing to dokument ze Stripe, a nie faktura ustrukturyzowana w KSeF. Stripe nie wysyła faktur do KSeF i nie przygotowuje ich w formacie, którego KSeF wymaga. Integracja bierze dane z faktury Stripe i wystawia na ich podstawie fakturę w KSeF.
Od kiedy KSeF jest obowiązkowy dla mojej firmy?
Firmy ze sprzedażą powyżej 200 mln zł brutto w 2024 roku wystawiają faktury w KSeF od 1 lutego 2026, pozostałe od 1 kwietnia 2026. Najmniejsi (sprzedaż udokumentowana fakturami do 10 tys. zł brutto miesięcznie) mają czas do 1 stycznia 2027. Kary za błędy w KSeF są zawieszone do końca 2026 roku.
Mam klientów prywatnych i firmy z zagranicy. Co idzie do KSeF?
Faktury dla osób fizycznych nieprowadzących działalności nie muszą trafiać do KSeF, można je wysyłać dobrowolnie. Faktury dla firm idą do KSeF, także dla nabywców z UE z odwrotnym obciążeniem. Zagraniczny klient dostaje fakturę poza KSeF, jako PDF z kodem QR. Szczegóły ustalamy z Twoją księgową.
Co z płatnościami w euro lub dolarach?
Faktura może być w walucie obcej, ale kwotę VAT trzeba przeliczyć na złote. Według art. 31a ustawy o VAT to kurs średni NBP z ostatniego dnia roboczego przed dniem powstania obowiązku podatkowego, a gdy faktura jest wystawiona wcześniej, przed dniem jej wystawienia. Integracja pobiera ten kurs i wpisuje go na fakturę. Który dzień jest właściwy przy Twoich usługach, potwierdź z księgową lub doradcą podatkowym.
Co się dzieje, gdy KSeF ma awarię?
Faktura powstaje w trybie awaryjnym z kodami QR i klient dostaje ją od razu. Gdy Ministerstwo ogłosi awarię, na dosłanie faktur do KSeF jest 7 dni roboczych od jej zakończenia. Integracja dosyła je sama.
Czy dostęp do KSeF i Stripe zostaje po mojej stronie?
Tak. Dostęp do KSeF generujesz sam w swoim KSeF, tylko z prawem do wystawiania faktur. W Stripe tworzysz dostęp, który pozwala integracji tylko na to, czego potrzebuje. Oba możesz w każdej chwili odebrać.
Dla działu IT
Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Jak płatność w Stripe zamienia się w fakturę FA(3)
Stripe wysyła zdarzenie invoice.paid, gdy faktura za subskrypcję lub jednorazowy zakup zostanie opłacona. Integracja pobiera pełną fakturę przez API Stripe, razem z pozycjami, rabatami, podatkiem i danymi klienta, i buduje z niej dokument w schemie FA(3). Płatności bez faktury w Stripe (na przykład jednorazowe Checkout Sessions bez włączonego tworzenia faktur) obsługujemy osobno, ze zdarzenia o udanej płatności. Do Stripe łączę się kluczem z ograniczonymi uprawnieniami (restricted key), a do KSeF tokenem lub certyfikatem z Twojego KSeF, z uprawnieniem tylko do wystawiania faktur.
NIP nabywcy pochodzi z pola Tax ID klienta w Stripe. Integracja sprawdza go w wykazie podatników VAT (Biała lista) dla firm z Polski i w VIES dla firm z UE, a nazwę i adres firmy uzupełnia z rejestru. Dzięki temu literówka z formularza nie trafia na fakturę.
Co wraca do Stripe
Po przyjęciu faktury KSeF nadaje jej numer. Integracja zapisuje go w metadanych faktury w Stripe razem z datą przyjęcia i linkiem do PDF. Obok zapisuje UPO, czyli urzędowe poświadczenie odbioru faktury przez KSeF. Obsługa i Twoja aplikacja widzą numer KSeF bez logowania do KSeF, a klient dostaje e-mail z fakturą w PDF i kodem QR do weryfikacji.
Subskrypcje, zmiany planów i korekty
Odnowienie subskrypcji to po prostu kolejna opłacona faktura, więc przechodzi tą samą drogą. Proporcjonalne rozliczenia (proration) przy zmianie planu, okresy próbne, kupony i saldo klienta przechodzą na fakturę jako osobne pozycje, tak żeby suma zgadzała się z kwotą pobraną przez Stripe. Rozliczenie za zużycie (metered billing) też kończy się fakturą w Stripe, więc idzie tą samą drogą.
Credit note w Stripe (credit_note.created) uruchamia fakturę korygującą, która wskazuje numer KSeF faktury pierwotnej. Korekta obejmuje tylko te pozycje i kwoty, które zawiera credit note. Moment wystawienia faktury przy usługach ciągłych i ewentualne faktury zaliczkowe ustalamy z księgową przed startem, bo to decyzja podatkowa, a nie techniczna.
Gdy KSeF nie działa
Każda faktura przechodzi przez kolejkę z ponowieniami. Chwilowy błąd API oznacza kolejną próbę, a nie zgubioną fakturę. Przy ogłoszonej awarii integracja wystawia fakturę w trybie awaryjnym, oznacza ją kodami QR i dosyła do KSeF po zakończeniu awarii, w ustawowym terminie.
Integracje z KSeF dla sklepów i firm →Integracje Stripe z polskimi systemami →