Użytkownicy Fakturowni, którzy przyjmują płatności online za pośrednictwem platformy Stripe, mogą skorzystać z integracji tych dwóch narzędzi. Jak to działa? Po każdej udanej płatności w Stripe, system automatycznie wystawia dokument sprzedaży (fakturę VAT, paragon lub proformę) w Fakturowni. Dodatkowo płatność trafia do zakładki Płatności w Fakturowni z oznaczeniem dostawcy: Stripe. Cały proces odbywa się automatycznie i nie wymaga dodatkowych ingerencji.

Jak zacząć korzystać z integracji?

Aby móc korzystać z integracji, musisz posiadać aktywne konto w Fakturowni oraz konto w Stripe. Następnie wykonaj kilka prostych kroków:

1. Zaloguj się do swojego konta w Fakturowni i przejdź do zakładki Ustawienia > Integracje i dodatki > Automatyzacje > Stripe.
2. Kliknij przycisk Aktywuj, aby rozpocząć proces łączenia Stripe z Fakturownią.
3. Uzupełnij dane autoryzacyjne z panelu Stripe: Gdzie znaleźć klucze? Zaloguj się do panelu Stripe (dashboard.stripe.com), przejdź do zakładki Developers > API keys. Skopiuj oba klucze i wklej je w odpowiednie pola w Fakturowni.
   • Publishable key – klucz publiczny z Dashboardu Stripe
   • Secret key – klucz prywatny z Dashboardu Stripe
4. Wybierz, czy chcesz pracować w trybie testowym (test mode) czy produkcyjnym (live mode). Tryb testowy pozwala przetestować integrację bez realnych płatności.
5. Kliknij Instaluj. Po poprawnym połączeniu, Fakturownia automatycznie utworzy webhook w Stripe, dzięki któremu będzie otrzymywać informacje o nowych płatnościach.

Konfiguracja i ustawienia

Po poprawnym połączeniu kont zostaniesz przekierowany do formularza konfiguracji. Możesz do niego wrócić później: Ustawienia > Integracje i dodatki > E-commerce > Stripe > Ustawienia.

Wybierz dział

Wskaż, w ramach którego działu Fakturowni mają generować się dokumenty sprzedaży. Jeśli zostawisz to pole puste, dokumenty będą tworzone w dziale oznaczonym jako Główny.

Wybierz rodzaj dokumentu

Zdecyduj, jaki rodzaj dokumentu powinien generować się po płatności ze Stripe. Dostępne opcje:

• Faktura VAT – wystawiana do każdej płatności, niezależnie od tego, czy kupujący podał NIP.
• Proforma – wystawiana jako dokument nieksięgowy.
• Paragon – wystawiana do każdej płatności jako paragon.
• Faktura VAT dla firm, paragon dla osób prywatnych – system automatycznie rozpoznaje, czy kupujący podał NIP. Jeśli tak – wystawia Fakturę VAT. Jeśli nie – wystawia paragon.

Wybierz domyślną stawkę VAT na dokumentach

Ustaw domyślną stawkę VAT, która będzie stosowana na wystawianych dokumentach (np. 23%, 8%, 5% itd.).

Ważne: Jeśli w Stripe masz skonfigurowane automatyczne naliczanie podatków (Stripe Tax), stawka VAT zostanie pobrana bezpośrednio ze Stripe. Upewnij się, że stawka ustawiona w integracji jest spójna ze stawką w Stripe, aby uniknąć rozbieżności na dokumentach.

Sprawdzanie poprawności NIP polskich firm

Możesz włączyć walidację NIP-ów polskich firm. Gdy ta opcja jest aktywna, system nie wystawi dokumentu, jeśli podany NIP nie przejdzie weryfikacji. Dotyczy to wyłącznie polskich numerów NIP.

Uwaga: Jeśli kupujący poda zagraniczny numer NIP (np. belgijski z przedrostkiem BE), dokument zawsze zostanie wygenerowany. W takim przypadku system automatycznie przypisze rodzaj identyfikacji podatkowej na NIP UE.

Dodatkowe opcje

• Automatycznie wyślij wystawione dokumenty do Klientów – po wystawieniu dokumentu, Fakturownia automatycznie wyśle go e-mailem na adres podany przez kupującego w procesie płatności Stripe.

Przygotowanie Stripe do zbierania danych do faktury

Domyślnie Stripe zbiera od kupujących jedynie adres e-mail i dane karty płatniczej. Do prawidłowego wystawienia faktury VAT potrzebne są dodatkowe dane: NIP nabywcy, nazwa firmy, adres rozliczeniowy oraz imię i nazwisko.
Musisz jawnie włączyć zbieranie tych danych w Stripe. Sposób konfiguracji zależy od tego, czy korzystasz z Stripe Checkout / Embedded Page (API), czy z Payment Links (Dashboard).

Konfiguracja przez API (Stripe Checkout / Embedded Page)

Przy tworzeniu sesji Checkout lub Embedded Page dodaj następujące parametry:

• tax_id_collection: { enabled: true }– włącza zbieranie NIP. Kupujący zobaczy checkbox „kupuję jako firma”, a po jego zaznaczeniu pojawią się pola na NIP i nazwę firmy. Opcjonalnie możesz wymusić podanie NIP: required: ‘if_supported’.
• billing_address_collection: ‘required’ – wymusza zbieranie pełnego adresu rozliczeniowego przy każdej płatności.
• name_collection – dodaje osobne pola na nazwę firmy i imię/nazwisko. Konfiguracja: name_collection: { business: { enabled: true }, individual: { enabled: true } }.
  Więcej informacji: Dokumentacja Stripe – Collect tax IDs

Konfiguracja w Payment Links (Dashboard Stripe)

Jeśli korzystasz z Payment Links tworzonych w Dashboardzie Stripe, włącz zbieranie danych przy tworzeniu lub edycji linku płatniczego:

1. NIP / Tax ID – włącz opcję zbierania Tax ID. Stripe automatycznie pokaże kupującym z obsługiwanych krajów (w tym z Polski) checkbox „kupuję jako firma”.
2. Adres rozliczeniowy – w sekcji zbierania adresów wybierz opcję „Collect billing address”.
3. Imiona i nazwy – włącz opcję „Collect customer names”. Skonfiguruj, czy zbierasz nazwę firmy, imię i nazwisko, czy oba.

Jak to działa w praktyce?

Po prawidłowej konfiguracji cały proces przebiega automatycznie:

1. Klient dokonuje płatności w Stripe (np. przez Checkout, Payment Link lub formularz na Twojej stronie).
2. Stripe przetwarza płatność i wysyła powiadomienie (webhook) do Fakturowni.
3. Fakturownia odbiera webhook i pobiera szczegóły płatności z API Stripe.
4. W zakładce Płatności w Fakturowni tworzona jest nowa płatność z oznaczeniem:
   • Dostawca: Stripe
   • Opis: „Płatność Stripe. Numer transakcji: [ID transakcji]”
5. Na podstawie płatności automatycznie wystawiany jest dokument sprzedaży (zgodnie z konfiguracją w ustawieniach integracji).
6. Dokument jest powiązany z płatnością w zakładce Płatności.
7. Jeśli włączono opcję automatycznej wysyłki – dokument jest wysyłany e-mailem do kupującego.

Ważne informacje i ograniczenia

Stawki VAT – spójność ustawień

Jeśli w Stripe masz ustawioną stawkę VAT (np. 23% przez Stripe Tax), a w integracji ustawiłeś inną domyślną stawkę (np. 8%), na fakturze mogą pojawić się rozbieżności. Upewnij się, że stawka VAT w ustawieniach integracji odpowiada stawce stosowanej w Stripe.

Faktura a brak NIP

Przy wyborze opcji „Faktura VAT dla firm, paragon dla osób prywatnych” system rozpoznaje typ dokumentu na podstawie obecności NIP:

• Kupujący podał NIP → wystawiana jest Faktura VAT
• Kupujący nie podał NIP → wystawiany jest Paragon

Opcja „After Payment > Create an invoice PDF” w Stripe

W ustawieniach Stripe dostępna jest opcja automatycznego generowania PDF faktury po płatności. Ta opcja nie jest obsługiwana przez naszą integrację – faktura generowana przez Stripe i faktura z Fakturowni to dwa niezależne dokumenty. Aby uniknąć podwójnego fakturowania, zalecamy wyłączenie tej opcji w Stripe, jeśli korzystasz z integracji z Fakturownią.

Kupony i rabaty Stripe

Kupony obniżające cenę utworzone w Stripe nie są obecnie uwzględniane na dokumentach wystawianych w Fakturowni.

Historia dokumentów

W ustawieniach integracji znajdziesz zakładkę Zobacz historię zamówień, w której możesz przeglądać listę wystawionych dokumentów powiązanych z płatnościami Stripe. W przypadku błędu zobaczysz informację o przyczynie i będziesz mógł ponowić wystawienie dokumentu.

Najczęściej zadawane pytania (FAQ)

1. Czy mogę przetestować integrację przed wdrożeniem produkcyjnym? Tak. Podczas konfiguracji możesz wybrać tryb testowy (test mode). W tym trybie integracja działa z testowymi kluczami API Stripe, dzięki czemu możesz przetestować cały proces bez realnych płatności.
2. Co się stanie, jeśli kupujący nie poda żadnych danych poza e-mailem? Dokument zostanie wystawiony z danymi, które były dostępne. Jeśli brakuje adresu lub nazwy kupującego, na fakturze mogą pojawić się niekompletne dane nabywcy. Dlatego zalecamy włączenie zbierania pełnych danych w Stripe (patrz: Przygotowanie Stripe do zbierania danych do faktury).
3. Czy webhook jest tworzony automatycznie? Tak. Po zainstalowaniu integracji Fakturownia automatycznie tworzy webhook w Stripe. Nie musisz konfigurować go ręcznie.
4. Mam pytanie lub problem z integracją – gdzie szukać pomocy? W razie pytań lub trudności, prosimy o przesłanie zgłoszenia tym linkiem.