Dlaczego potrzebujesz integracji Stripe z wFirma
Stripe przetwarza płatności, ale nie wystawia faktur ustrukturyzowanych wymaganych w Polsce od lutego 2026. wFirma.pl to popularny polski program do fakturowania i księgowości online. Obsługuje KSeF, KPiR, ryczałt i automatyczną wysyłkę faktur do rządowego systemu. Problem? Stripe i wFirma nie komunikują się ze sobą natywnie.
Bez integracji musisz ręcznie przepisywać dane z każdej płatności Stripe do wFirma: 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 wFirma automatycznie. Każda płatność w Stripe generuje fakturę w wFirma 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.
Dla kogo jest integracja Stripe + wFirma
Integracja jest dla każdej polskiej firmy, która przyjmuje płatności przez Stripe i korzysta z wFirma do fakturowania i księgowości. Najczęstsze scenariusze:
SaaS i aplikacje webowe
Subskrypcje miesięczne i roczne. Po każdej odnowionej subskrypcji faktura pojawia się automatycznie w wFirma bez ręcznego wystawiania. Działa zarówno przy pierwszej płatności, jak i przy kolejnych odnowieniach.
Kursy online i szkolenia
Jednorazowe płatności za dostęp do kursów, webinarów lub materiałów edukacyjnych. Klient płaci, dostaje dostęp do materiałów, a faktura wystawia się sama w wFirma.
Coaching i konsultacje
Płatności za sesje coachingowe, konsultacje lub pakiety godzin. Wystarczy wysłać klientowi link do płatności. Po zapłacie faktura pojawia się automatycznie w wFirma.
Produkty cyfrowe
E-booki, szablony, grafiki, pluginy. Po każdej sprzedaży faktura trafia do wFirma automatycznie. Klienci, którzy podają NIP, otrzymują fakturę z pełnymi danymi firmowymi.
Agencje i freelancerzy
Rozliczanie projektów i retainerów przez Stripe. Faktura w wFirma pojawia się automatycznie po każdej płatności klienta. Koniec z ręcznym wystawianiem faktur na koniec miesiąca.
Marketplace i platformy
Platformy łączące kupujących ze sprzedającymi. Stripe obsługuje płatności, a wFirma wystawia faktury dla każdej transakcji na platformie. Wszystko dzieje się w tle, bez udziału operatora.
Jeśli Twój biznes przyjmuje płatności przez Stripe i działa na polskiej działalności gospodarczej, integracja z wFirma przez Stripto zaoszczędzi Ci godziny ręcznego fakturowania każdego miesiąca.
Jak działa integracja Stripe → Stripto → wFirma → KSeF
Integracja opiera się na łańcuchu automatycznych akcji. Każde ogniwo działa w ciągu kilku sekund:
- 1
Klient płaci u Ciebie przez Stripe
Płatność kartą, subskrypcja, link płatniczy, dowolna forma płatności obsługiwana przez Stripe. Podczas płatności klient podaje dane do faktury: NIP, nazwę firmy i adres rozliczeniowy.
- 2
Stripto automatycznie przesyła dane do wFirma
Natychmiast po udanej płatności Stripto otrzymuje informację ze Stripe i przesyła do wFirma wszystkie dane potrzebne do wystawienia faktury: kwotę, walutę, NIP kupującego, nazwę firmy, adres, opis produktu lub usługi. Stripto automatycznie przelicza kwoty i dopasowuje format danych do wymagań wFirma.
- 3
wFirma wystawia fakturę
Na podstawie danych od Stripto, wFirma automatycznie tworzy fakturę z danymi sprzedawcy (z Twojego konta), danymi kupującego, pozycjami fakturowymi i właściwą stawką VAT. Faktura pojawia się od razu w Twoim panelu wFirma, gotowa do pobrania i wysyłki.
- 4
Faktura trafia do KSeF
wFirma automatycznie konwertuje fakturę do formatu wymaganego przez KSeF i wysyła ją do rządowego systemu. KSeF nadaje fakturze unikalny numer, który potwierdzasz w panelu wFirma. Nie musisz nic robić ręcznie.
- 5
Faktura trafia do KPiR
wFirma automatycznie księguje fakturę w Twojej Książce Przychodów i Rozchodów lub ewidencji ryczałtu. Nie musisz ręcznie dodawać wpisu. Księgowość prowadzi się sama.
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: Znajdź klucze API w wFirma
- Zaloguj się do swojego konta wFirma.pl
- Przejdź do Ustawienia → Integracje → API
- Skopiuj Access Key i Secret Key
Oba klucze wyglądają jak długie ciągi losowych znaków. Traktuj je jak hasła i nie udostępniaj nikomu. Access Key identyfikuje Twoje konto, a Secret Key służy do uwierzytelnienia.
Krok 2: Skonfiguruj KSeF w wFirma
- W wFirma przejdź do Ustawienia → Integracje → KSeF
- Autoryzuj połączenie tokenem KSeF
- Włącz automatyczne wysyłanie faktur do KSeF
Bez tego kroku wFirma będzie wystawiać faktury, ale nie wyśle ich do KSeF. Autoryzacja wymaga tokenu z systemu KSeF (nie mylić z kluczami API wFirma).
Krok 3: Podłącz wFirma w Stripto
- W panelu Stripto przejdź do Ustawienia → wFirma
- Wklej Access Key i Secret Key z wFirma
- Kliknij „Testuj połączenie". Stripto pobierze listę Twoich firm
- Wybierz firmę z listy rozwijanej
- Kliknij „Zapisz". Stripto zweryfikuje połączenie z wFirma
Jeśli dane są poprawne, zobaczysz potwierdzenie połączenia. Od teraz każda nowa płatność w Stripe automatycznie utworzy fakturę w wFirma.
Co trafia na fakturę
Stripto automatycznie przenosi dane z płatności Stripe na fakturę w wFirma. Nie musisz ręcznie przepisywać niczego. Poniżej znajdziesz pełną listę danych, które trafiają na fakturę, wraz z informacją skąd pochodzą.
| Pole na fakturze | Skąd pochodzi |
|---|---|
| Dane sprzedawcy | Z Twojego konta wFirma (automatycznie) |
| NIP kupującego | Podany przez klienta przy płatności w Stripe |
| Nazwa firmy kupującego | Dane rozliczeniowe ze Stripe |
| Adres kupującego | Adres rozliczeniowy ze Stripe |
| Kwota netto | Kwota płatności ze Stripe (przeliczona automatycznie) |
| Waluta | Waluta płatności (PLN, EUR, USD, GBP itd.) |
| Opis usługi | Nazwa produktu lub usługi ze Stripe |
| Data sprzedaży | Data płatności w Stripe |
| Metoda płatności | Karta płatnicza lub przelew |
Stawka VAT jest ustawiana zgodnie z konfiguracją w Stripto. Domyślnie 23%, ale możesz zmienić stawkę w ustawieniach (np. 8%, 5%, zw., np.). Stawka jest stosowana do wszystkich nowych faktur.
Kwoty są automatycznie przeliczane do formatu wymaganego przez wFirma. Stripe przechowuje kwoty w groszach (np. 10000 = 100,00 zł), a wFirma wymaga kwot w złotych. Stripto zajmuje się tym przeliczeniem za Ciebie.
Dane kupującego są osadzane bezpośrednio w fakturze wFirma jako dane kontrahenta. Jeśli Twój klient podał NIP, nazwę firmy i adres podczas płatności, te dane automatycznie trafią na fakturę. Możesz też nadpisać dane kupującego przez Stripe metadata (klucze z prefiksem wfirma_).
Obsługa wielu walut
Przyjmujesz płatności w EUR, USD czy GBP? Stripto przekazuje walutę z płatności Stripe na fakturę w wFirma. Kwoty na fakturze są w oryginalnej walucie płatności, dokładnie tak, jak zapłacił klient.
Przeliczenie na PLN do celów VAT odbywa się po stronie wFirma. wFirma 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 ani szukać tabel NBP.
Najczęstsze scenariusze:
- Klienci z UE: płatności w EUR, faktura w EUR z automatycznym 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)
wFirma a KSeF, czyli jak skonfigurować wysyłanie do KSeF
wFirma.pl ma pełną, wbudowaną integrację z KSeF. Po wystawieniu faktury wFirma automatycznie konwertuje ją do formatu wymaganego przez KSeF i wysyła. 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 wFirma 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 wFirma (w tym te tworzone automatycznie przez Stripto) zostanie wysłana do KSeF. Status wysyłki i numer KSeF zobaczysz w panelu wFirma przy każdej fakturze.
Szczegóły o KSeF (czym jest, kogo dotyczy i jakie są kary) znajdziesz w kompletnym przewodniku Stripe + KSeF.
Wbudowana księgowość: KPiR i ryczałt
wFirma to nie tylko program do fakturowania, ale pełna platforma księgowa. Faktury wystawione automatycznie przez Stripto są od razu księgowane w wFirma, bez konieczności ręcznego dodawania wpisów.
Książka Przychodów i Rozchodów (KPiR): jeśli rozliczasz się na zasadach ogólnych lub podatkiem liniowym, każda faktura ze Stripe automatycznie pojawia się w Twojej KPiR w wFirma. Kolumna 7 (sprzedaż towarów i usług) wypełnia się sama.
Ryczałt od przychodów ewidencjonowanych: jeśli rozliczasz się ryczałtem, wFirma automatycznie księguje fakturę w ewidencji ryczałtu z odpowiednią stawką. W Stripto możesz ustawić stawkę ryczałtu (np. 8,5%, 12%), która będzie stosowana do faktur ze Stripe.
JPK_V7 i deklaracje VAT: wFirma generuje pliki JPK_V7M i JPK_V7K na podstawie faktur z danego okresu. Faktury ze Stripe są uwzględniane automatycznie. Nie musisz ich ręcznie dopisywać przed wysyłką JPK do urzędu skarbowego.
Dzięki integracji Stripe → Stripto → wFirma cały łańcuch od płatności do wpisu w książce przychodów działa automatycznie. Twój księgowy lub biuro rachunkowe ma dostęp do gotowych danych w wFirma bez dodatkowej pracy.
wFirma vs Fakturownia vs inFakt: porównanie integracji ze Stripe
Stripto obsługuje trzy systemy fakturowe: wFirma, Fakturownię i inFakt. Poniżej znajdziesz porównanie, które pomoże Ci wybrać najlepszą opcję.
| Funkcja | wFirma | Fakturownia | inFakt |
|---|---|---|---|
| Wysyłka do KSeF | Tak | Tak | Tak |
| Wbudowana KPiR | Tak | Nie | Tak |
| Ewidencja ryczałtu | Tak | Nie | Tak |
| Generowanie JPK_V7 | Tak | Nie | Tak |
| Obsługa wielu walut | Tak | Tak | Tak |
| Wiele firm na koncie | Tak | Tak | Nie |
| Sposób autoryzacji API | Access Key + Secret Key | Token API + domena | Klucz API |
| Nadpisywanie danych metadata | Tak (prefiks wfirma_) | Nie | Nie |
wFirma sprawdzi się najlepiej, jeśli prowadzisz JDG i chcesz mieć faktury, KPiR, JPK i KSeF w jednym miejscu. Dobrze nadaje się też do firm z kilkoma działalnościami na jednym koncie.
Fakturownia to dobry wybór, jeśli korzystasz z niej od lat i nie potrzebujesz wbudowanej księgowości. Jest popularniejsza wśród firm, które mają osobnego księgowego.
inFakt jest podobny do wFirma (KPiR + ryczałt + JPK), ale nie obsługuje wielu firm na jednym koncie. Popularny wśród freelancerów i jednoosobowych działalności.
Niezależnie od wyboru, Stripto konfiguruje się tak samo szybko. Możesz też zmienić system w dowolnym momencie. Podłączenie nowego systemu automatycznie dezaktywuje poprzedni.
Nadpisywanie danych przez Stripe metadata
Domyślnie Stripto pobiera dane kupującego z adresu rozliczeniowego w Stripe (billing address). Ale co jeśli Twój flow nie zbiera adresu rozliczeniowego, albo chcesz przekazać dane z własnego systemu?
Przy integracji z wFirma możesz nadpisać dane na fakturze przez Stripe metadata. Wystarczy dodać klucze z prefiksem wfirma_ do obiektu metadata w Stripe (na Invoice, Subscription, Checkout Session lub Payment Link).
| Klucz metadata | Co nadpisuje | Przykład |
|---|---|---|
wfirma_name | Nazwę firmy kupującego | Acme Sp. z o.o. |
wfirma_nip | NIP kupującego | 1234567890 |
wfirma_street | Ulicę i numer | ul. Przykładowa 1/2 |
wfirma_zip | Kod pocztowy | 00-001 |
wfirma_city | Miasto | Warszawa |
wfirma_country | Kraj (kod ISO) | PL |
Metadata z prefiksem wfirma_ mają wyższy priorytet niż dane z billing address. Jeśli ustawisz wfirma_nip, ten NIP trafi na fakturę zamiast NIP-u z adresu rozliczeniowego.
To przydatne, gdy integrujesz Stripe z własnym systemem CRM lub ERP i chcesz przekazywać dane klienta z Twojej bazy danych zamiast polegać na tym, co klient wpisze w formularzu płatności.
Rozwiązywanie problemów
Błąd: "Nieprawidłowe klucze API"
Sprawdź, czy skopiowałeś oba klucze (Access Key i Secret Key) z panelu wFirma. Upewnij się, że nie ma spacji na początku lub końcu. Jeśli klucze mogły wygasnąć, wygeneruj nowe w ustawieniach wFirma.
Błąd: "Nie znaleziono firm"
Klucze API mogą być poprawne, ale Twoje konto wFirma nie ma przypisanych firm. Zaloguj się do wFirma i sprawdź, czy masz co najmniej jedną aktywną firmę. Jeśli dopiero zakładasz konto, dokończ konfigurację firmy w wFirma.
Faktura nie trafia do KSeF
Faktura jest tworzona w wFirma, ale KSeF wymaga osobnej konfiguracji. Sprawdź, czy w wFirma 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. Jeśli klient nie podał NIP-u lub adresu podczas płatności, te pola będą puste na fakturze. Włącz zbieranie NIP-u i adresu rozliczeniowego w ustawieniach płatności Stripe. Alternatywnie, możesz przekazać dane przez Stripe metadata z prefiksem wfirma_.
Wystawienie faktury nie powiodło się
W panelu Stripto przy fakturze zobaczysz komunikat o błędzie. Najczęstsze przyczyny: chwilowa niedostępność wFirma, przekroczony limit faktur na planie, lub brakujące dane na fakturze. Kliknij „Ponów", żeby spróbować ponownie.
Wypróbuj Stripto: 5 pierwszych faktur za darmo
Połącz Stripe z Fakturownią, inFakt lub wFirma w kilka minut. Bez podpinania karty.
Najczęściej zadawane pytania
Czy potrzebuję płatnego konta w wFirma?
wFirma oferuje różne plany, w tym podstawowy z ograniczoną liczbą faktur. Do testów integracji ze Stripto wystarczy plan podstawowy. Przy większej liczbie faktur potrzebujesz wyższego planu w wFirma.
Gdzie znajdę klucze API w wFirma?
Zaloguj się do wFirma.pl, przejdź do Ustawienia → Integracje → API. Znajdziesz tam Access Key i Secret Key. Skopiuj oba klucze i wklej je w ustawieniach Stripto w sekcji wFirma.
Czym się różni Access Key od Secret Key?
Access Key to identyfikator Twojego konta, a Secret Key to klucz uwierzytelniający. Oba są wymagane do połączenia z API wFirma. Traktuj je jak hasła i nie udostępniaj nikomu.
Co to jest wybór firmy po podłączeniu?
Jedno konto wFirma może mieć kilka firm. Po podaniu kluczy API Stripto pobiera listę Twoich firm i pozwala wybrać, do której wystawiać faktury. Możesz to zmienić w ustawieniach.
Jak wFirma wysyła faktury do KSeF?
wFirma ma wbudowaną integrację z KSeF. Po wystawieniu faktury wFirma automatycznie konwertuje ją do wymaganego formatu i wysyła do KSeF. Musisz mieć aktywną autoryzację KSeF w ustawieniach wFirma.
Czy faktury ze Stripto trafiają do KPiR?
Tak. wFirma ma wbudowaną księgowość. Faktury sprzedażowe wystawione przez Stripto są automatycznie księgowane w KPiR lub ewidencji ryczałtu. Nie musisz ręcznie wprowadzać ich do księgi.
Co się stanie, jeśli klucze API są nieprawidłowe?
Stripto weryfikuje klucze API przy zapisywaniu ustawień. Jeśli klucze są nieprawidłowe, zobaczysz komunikat o błędzie. Faktura nie zostanie wystawiona, ale płatność w Stripe przejdzie normalnie. Popraw klucze i ponów wystawienie faktury.
Ile czasu zajmuje wystawienie faktury po płatności?
Kilka sekund. Stripto otrzymuje informację o płatności ze Stripe natychmiast, a wFirma wystawia fakturę od razu. Wysyłka do KSeF trwa dodatkowe kilka sekund do kilku minut.
Czy mogę zmienić z wFirma na Fakturownię lub inFakt?
Tak. W Stripto możesz zmienić program księgowy w dowolnym momencie. Podłączenie Fakturowni lub inFakt automatycznie dezaktywuje wFirma. Nowe faktury będą wystawiane w nowym systemie, a stare pozostaną w wFirma.
Czy integracja obsługuje faktury korygujące?
Stripto automatycznie wystawia faktury sprzedażowe. Faktury korygujące (np. przy zwrocie w Stripe) musisz na razie wystawić ręcznie w wFirma. Automatyczne korekty są w planach.
Jak zintegrować wFirma ze Stripe?
Przez Stripto. Rejestrujesz się w Stripto, podłączasz konto Stripe jednym kliknięciem, wklejasz Access Key i Secret Key z wFirma, wybierasz firmę i gotowe. Cała konfiguracja zajmuje ok. 2 minuty. Od tego momentu każda płatność w Stripe automatycznie generuje fakturę w wFirma.
Czy Stripto obsługuje ryczałt w wFirma?
Tak. W ustawieniach Stripto możesz wybrać stawkę ryczałtu (np. 8,5%, 12%, 15%). Stripto przekaże ją do wFirma, a wFirma automatycznie zaksięguje fakturę w ewidencji ryczałtu zamiast KPiR.
Czy mogę podłączyć kilka kont Stripe do wFirma?
Tak. Stripto obsługuje wiele kont Stripe. Każde konto może mieć własną konfigurację (nazwę usługi, stawkę VAT), ale wszystkie faktury trafiają do tego samego konta wFirma.
Ile kosztuje integracja Stripe z wFirma przez Stripto?
Stripto kosztuje od 19 zł miesięcznie (plan Mini, do 25 faktur). Plan Starter (do 100 faktur) to 39 zł/mies., a Pro (do 1000 faktur) to 99 zł/mies. Pierwsze 5 faktur jest za darmo, bez podpinania karty.
Czy wFirma nadaje się do sprzedaży B2C (bez NIP)?
Tak. Jeśli klient nie podał NIP-u podczas płatności, Stripto wystawi fakturę na osobę fizyczną z imieniem i adresem ze Stripe. W sprzedaży B2C NIP nabywcy nie jest wymagany na fakturze.
Połącz Stripe z Fakturownią, inFakt lub wFirma
Konfiguracja w minutę. Automatyczne faktury gotowe na KSeF.