[Fakturownia - Baza wiedzy](https://pomoc.fakturownia.pl.md) / [Automatyzacje i dodatki](https://pomoc.fakturownia.pl/integracje-automatyzacje-i-dodatki.md)

# [Integracja Fakturowni ze Stripe – automatyczne fakturowanie płatności](https://pomoc.fakturownia.pl/integracja-fakturowni-ze-stripe-automatyczne-fakturowanie-platnosci.md)

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**](https://app.fakturownia.pl/goto?after_url=apps/stripe-app).
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](https://docs.stripe.com/tax/checkout/tax-ids?payment-ui=stripe-hosted)

### 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](https://pomoc.fakturownia.pl/integracja-fakturowni-ze-stripe-automatyczne-fakturowanie-platnosci#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**](https://app.fakturownia.pl/goto/helpdesk).

---

## Powiązane

- [[FAQ] Integracja Fakturowni z Allegro](https://pomoc.fakturownia.pl/153252522-faq-integracja-fakturowni-z-allegro.md)
- [Integracja Fakturowni z Allegro](https://pomoc.fakturownia.pl/146621322-integracja-fakturowni-z-allegro.md)
- [Integracja Fakturowni z platformą Shoper](https://pomoc.fakturownia.pl/123460796-integracja-fakturowni-z-platforma-shoper.md)
- [Różne rodzaje dokumentów](https://pomoc.fakturownia.pl/864299-rozne-rodzaje-dokumentow.md)