Dlaczego potrzebujesz integracji Stripe z Fakturownią
Stripe przetwarza płatności, ale nie wystawia faktur ustrukturyzowanych wymaganych w Polsce od lutego 2026. Fakturownia.pl to jeden z najpopularniejszych polskich programów do fakturowania — obsługuje KSeF, waliduje dane i wysyła faktury do rządowego systemu automatycznie. Problem? Stripe i Fakturownia nie komunikują się ze sobą natywnie.
Bez integracji musisz ręcznie przepisywać dane z każdej płatności Stripe do Fakturowni — kwotę, walutę, dane kupującego, NIP, opis usługi. Przy kilkunastu transakcjach dziennie to godziny straconego czasu i ryzyko błędów.
Stripto rozwiązuje ten problem. Łączy Stripe z Fakturownią automatycznie. Każda płatność w Stripe generuje fakturę w Fakturowni — z poprawnymi danymi, właściwą stawką VAT i automatyczną wysyłką do KSeF.
Dowiedz się więcej o tym, jak wystawić fakturę ze Stripe i porównaj dostępne opcje.
Jak działa integracja Stripe → Stripto → Fakturownia → KSeF
Integracja opiera się na łańcuchu automatycznych akcji. Każde ogniwo działa w ciągu kilku sekund:
- 1
Klient płaci przez Stripe
Stripe Checkout, subskrypcja, Payment Link lub bezpośrednia płatność kartą. Klient podaje dane do faktury (NIP, adres) podczas płatności.
- 2
Stripto odbiera webhook ze Stripe
Natychmiast po płatności Stripto otrzymuje powiadomienie i pobiera pełne dane: kwotę, walutę, NIP kupującego, nazwę firmy, adres, opis produktu.
- 3
Stripto tworzy fakturę w Fakturowni przez API
Stripto wysyła żądanie do API Fakturowni z danymi sprzedawcy, kupującego, pozycjami fakturowymi i stawką VAT. Fakturownia tworzy fakturę synchronicznie — odpowiedź jest natychmiastowa.
- 4
Fakturownia wysyła fakturę do KSeF
Fakturownia automatycznie konwertuje fakturę do formatu XML FA(2) i wysyła ją do KSeF. System nadaje fakturze numer KSeF.
- 5
Klient otrzymuje fakturę e-mailem
Stripto może automatycznie wysłać fakturę PDF do klienta na adres e-mail ze Stripe. Oryginał faktury jest w KSeF.
Cały łańcuch od płatności do faktury w KSeF trwa kilka sekund. Więcej o tym, jak KSeF działa i dlaczego Stripe go nie obsługuje, znajdziesz w przewodniku Stripe + KSeF.
Konfiguracja krok po kroku
Krok 1: Wygeneruj klucz API w Fakturowni
- Zaloguj się do swojego konta Fakturownia.pl
- Przejdź do Ustawienia → API → Token API
- Kliknij "Pokaż token" lub "Wygeneruj nowy token"
- Skopiuj token — będziesz go potrzebować w następnym kroku
Token API wygląda jak ciąg losowych znaków, np. abc123def456/789. Traktuj go jak hasło — nie udostępniaj go nikomu.
Krok 2: Sprawdź nazwę domeny konta
Twoja domena konta to część adresu URL po zalogowaniu do Fakturowni. Jeśli adres to twojafirma.fakturownia.pl, to domena to twojafirma.
Krok 3: Skonfiguruj KSeF w Fakturowni
- W Fakturowni przejdź do Ustawienia → Integracje → KSeF
- Autoryzuj połączenie tokenem KSeF
- Włącz automatyczne wysyłanie faktur do KSeF
Bez tego kroku Fakturownia będzie wystawiać faktury, ale nie wyśle ich do KSeF. Autoryzacja wymaga tokenu z systemu KSeF (nie mylić z tokenem API Fakturowni).
Krok 4: Podłącz Fakturownię w Stripto
- W panelu Stripto przejdź do Ustawienia → Fakturownia
- Wklej klucz API z Fakturowni
- Wpisz nazwę domeny konta
- Kliknij "Zapisz" — Stripto zweryfikuje połączenie
Jeśli dane są poprawne, zobaczysz potwierdzenie połączenia. Od teraz każda nowa płatność w Stripe automatycznie utworzy fakturę w Fakturowni.
Co trafia na fakturę — mapowanie danych Stripe → Fakturownia
Stripto automatycznie mapuje dane z płatności Stripe na odpowiednie pola faktury w Fakturowni. Nie musisz ręcznie przepisywać niczego.
| Pole na fakturze | Źródło w Stripe | Pole w Fakturowni API |
|---|---|---|
| Dane sprzedawcy | — | Z konta Fakturowni (automatycznie) |
| NIP kupującego | customer.tax_ids (pl_vat) | buyer_tax_no |
| Nazwa kupującego | customer.name / billing_details | buyer_name |
| Adres kupującego | billing_details.address | buyer_street, buyer_city, buyer_post_code |
| Kwota | amount / amount_total (w groszach) | total_price_gross (w złotych) |
| Waluta | currency (np. pln, eur, usd) | currency |
| Opis pozycji | line_items / description | positions[].name |
| Data sprzedaży | created (timestamp płatności) | sell_date |
| Metoda płatności | — | payment_type: "card" |
Stawka VAT jest ustawiana zgodnie z konfiguracją w Stripto. Domyślnie 23%, ale możesz zmienić stawkę w ustawieniach (np. 8%, 5%, zw., np.).
Kwoty w Fakturowni są podawane w złotych (np. 100.00), nie w groszach. Stripto automatycznie przelicza kwoty ze Stripe (które są w najmniejszej jednostce waluty, np. 10000 = 100,00 zł) na format Fakturowni.
Obsługa wielu walut
Jeśli przyjmujesz płatności w różnych walutach (EUR, USD, GBP), Stripto przekazuje walutę z płatności Stripe na fakturę w Fakturowni. Fakturownia obsługuje faktury wielowalutowe — kwoty na fakturze będą w oryginalnej walucie płatności.
Przeliczenie na PLN do celów VAT odbywa się po stronie Fakturowni. Fakturownia automatycznie pobiera kurs NBP z dnia poprzedzającego datę sprzedaży i przelicza kwotę na PLN — zgodnie z polskimi przepisami podatkowymi. Nie musisz ręcznie wpisywać kursu.
Najczęstsze scenariusze:
- SaaS z klientami z UE — płatności w EUR, faktura w EUR z przeliczeniem na PLN
- Sprzedaż globalna — płatności w USD/GBP, faktura w oryginalnej walucie
- Klienci polscy — płatności w PLN, faktura w PLN (bez przeliczenia)
Fakturownia a KSeF — jak skonfigurować wysyłanie do KSeF
Fakturownia.pl ma pełną, wbudowaną integrację z KSeF. Po wystawieniu faktury Fakturownia automatycznie konwertuje ją do formatu XML FA(2) i wysyła do KSeF. Musisz jednorazowo skonfigurować autoryzację:
- Wejdź na stronę ksef.mf.gov.pl i zaloguj się (profilem zaufanym lub kwalifikowanym podpisem elektronicznym)
- Wygeneruj token autoryzacyjny dla oprogramowania zewnętrznego
- W Fakturowni przejdź do Ustawienia → Integracje → KSeF
- Wklej token z KSeF i aktywuj integrację
- Włącz automatyczne wysyłanie nowych faktur do KSeF
Po aktywacji każda faktura wystawiona w Fakturowni (w tym te tworzone automatycznie przez Stripto) zostanie wysłana do KSeF. Status wysyłki i numer KSeF zobaczysz w panelu Fakturowni przy każdej fakturze.
Szczegóły o KSeF — czym jest, kogo dotyczy i jakie są kary — znajdziesz w kompletnym przewodniku Stripe + KSeF.
Rozwiązywanie problemów
Błąd: "Nieprawidłowy klucz API"
Sprawdź, czy skopiowałeś cały token API z Fakturowni (w tym ukośnik i część po nim, jeśli jest). Upewnij się, że nie ma spacji na początku lub końcu. Wygeneruj nowy token, jeśli stary mógł wygasnąć.
Błąd: "Nie znaleziono konta"
Sprawdź nazwę domeny konta. Jeśli Twój adres to twojafirma.fakturownia.pl, wpisz tylko "twojafirma". Nie dodawaj ".fakturownia.pl".
Faktura nie trafia do KSeF
Faktura jest tworzona w Fakturowni, ale KSeF wymaga osobnej konfiguracji. Sprawdź, czy w Fakturowni masz aktywną integrację z KSeF (Ustawienia → Integracje → KSeF) i czy token KSeF jest ważny. Sprawdź też, czy włączono automatyczne wysyłanie do KSeF.
Brak danych kupującego na fakturze
Stripto pobiera dane kupującego ze Stripe Checkout. Jeśli klient nie podał NIP-u lub adresu, te pola będą puste na fakturze. Włącz zbieranie Tax ID i adresu rozliczeniowego w ustawieniach Stripe Checkout.
Synchronizacja nie powiodła się
W panelu Stripto przy fakturze zobaczysz komunikat o błędzie. Najczęstsze przyczyny: chwilowa niedostępność API Fakturowni, przekroczony limit faktur na planie darmowym, lub brakujące dane na fakturze. Kliknij "Ponów synchronizację", żeby spróbować ponownie.
Podłącz Stripe do Fakturowni w minutę
Automatyczne faktury z każdej płatności. Gotowe na KSeF.
Wolisz inFakt zamiast Fakturowni?
Stripto obsługuje też integrację z inFakt — popularnym programem do fakturowania z wbudowaną księgowością (KPiR, ryczałt). Jeśli używasz inFakt lub rozważasz zmianę, sprawdź integrację Stripe + inFakt.
Najczęściej zadawane pytania
Czy potrzebuję płatnego konta w Fakturowni?
Nie koniecznie. Fakturownia ma darmowy plan z limitem faktur miesięcznie. Do testowania integracji ze Stripto wystarczy plan darmowy. Przy większej liczbie faktur potrzebujesz płatnego planu w Fakturowni.
Gdzie znajdę klucz API w Fakturowni?
W Fakturownia.pl przejdź do Ustawienia → API → Token API. Skopiuj token i wklej go w ustawieniach Stripto w sekcji Fakturownia. Token wygląda jak ciąg losowych znaków.
Co to jest domena konta i gdzie ją znaleźć?
Domena konta to adres Twojego konta w Fakturowni — np. twojafirma.fakturownia.pl. Znajdziesz ją w pasku adresu przeglądarki po zalogowaniu do Fakturowni. W Stripto podajesz samą nazwę (twojafirma), bez .fakturownia.pl.
Czy Stripto tworzy klientów w Fakturowni?
Tak. Przy pierwszej fakturze dla danego kupującego Stripto tworzy klienta w bazie Fakturowni z danymi ze Stripe (NIP, nazwa, adres, e-mail). Przy kolejnych fakturach Stripto przypisuje fakturę do istniejącego klienta.
Jak Fakturownia wysyła faktury do KSeF?
Fakturownia ma wbudowaną integrację z KSeF. Po wystawieniu faktury Fakturownia automatycznie konwertuje ją do formatu XML FA(2) i wysyła do KSeF. Musisz mieć aktywną autoryzację tokenem KSeF w ustawieniach Fakturowni.
Co się stanie, jeśli klucz API jest nieprawidłowy?
Stripto weryfikuje klucz API przy zapisywaniu ustawień. Jeśli klucz jest nieprawidłowy, zobaczysz komunikat o błędzie. Faktura nie zostanie wystawiona, ale płatność w Stripe przejdzie normalnie. Popraw klucz API i zsynchronizuj fakturę ponownie.
Czy mogę zmienić numerację faktur?
Tak, ale nie w Stripto — numeracja faktur jest zarządzana przez Fakturownię. W ustawieniach Fakturowni możesz zmienić format numeru (np. FV 1/03/2026), prefiksy i sposób resetowania numeracji.
Czy integracja obsługuje faktury korygujące?
Stripto automatycznie tworzy faktury sprzedażowe. Faktury korygujące (np. przy zwrocie przez Stripe) musisz na razie wystawić ręcznie w Fakturowni. Automatyczne korekty są w planach.
Ile czasu zajmuje wystawienie faktury po płatności?
Kilka sekund. Stripto odbiera webhook ze Stripe natychmiast po płatności, a Fakturownia tworzy fakturę synchronicznie — odpowiedź z API Fakturowni jest natychmiastowa. Wysyłka do KSeF zajmuje dodatkowe kilka sekund do kilku minut.
Czy mogę używać Fakturowni i inFakt jednocześnie?
Nie. W Stripto możesz mieć aktywną tylko jedną integrację naraz. Podłączenie inFakt automatycznie dezaktywuje Fakturownię i odwrotnie. Dzięki temu nie ma ryzyka podwójnych faktur.
Połącz Stripe z Fakturownią lub inFakt
Konfiguracja w minutę. Automatyczne faktury gotowe na KSeF.