Integracja Stripe z Fakturownią
Stripe pobiera opłaty, a faktury ktoś wciąż wystawia w Fakturowni ręcznie albo poprawia po automacie. Po integracji każda płatność sama staje się fakturą, Fakturownia wysyła ją do KSeF, a zwrot w Stripe zamienia się w korektę.
Co będzie działać samo
- klient płaci
- odnowienie subskrypcji
- zwrot lub obniżka
- NIP klienta ze Stripe
- dobiera klienta i stawki VAT
- nie wystawia faktury dwa razy
- wystawia korekty
- pilnuje, żeby nic nie zginęło
- faktura lub korekta
- wysyłka do KSeF
- e-mail do klienta
- status opłacona
Płatność lub odnowienie subskrypcji
Gdy Stripe pobierze opłatę, w Fakturowni powstaje opłacona faktura z pozycjami, rabatami i danymi klienta. Fakturownia wysyła ją do KSeF, a numer faktury i numer KSeF zapisują się przy płatności w Stripe.
Zwrot, rabat lub zmiana planu
Zwrot lub obniżka wystawiona w Stripe tworzy w Fakturowni fakturę korygującą do właściwej faktury, a Fakturownia wysyła ją do KSeF. Częściowy zwrot koryguje tylko zwróconą kwotę lub pozycje.
Coś poszło nie tak
Brak danych nabywcy, odrzucenie przez Fakturownię albo przez KSeF zatrzymuje fakturę i wysyła alert e-mail. Faktura czeka na poprawkę, nic nie ginie i nic nie wystawia się dwa razy.
Jak wygląda wdrożenie
- 1Rozmowa, 30 minut. Jak dziś fakturujesz płatności ze Stripe, kto płaci (firmy z Polski, z UE, konsumenci), w jakich walutach i czego brakuje w obecnym rozwiązaniu.
- 2Ustalenia i konto testowe. Ustalamy, które dane ze Stripe trafiają na fakturę. Pierwsze faktury powstają z testowych płatności Stripe na testowym koncie Fakturowni, z testowym KSeF (tryb DEMO).
- 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 prawdziwe płatności i produkcyjne konto Fakturowni, alert e-mail, gdy faktura utknie, poprawki w cenie przez 30 dni.
Gotowa aplikacja czy integracja?
Fakturownia ma własną integrację ze Stripe, która po każdej udanej płatności (także przy odnowieniu subskrypcji) wystawia fakturę lub paragon. Są też gotowe usługi abonamentowe, na przykład Stripto czy Striptu. Przy prostym cenniku i klientach w Polsce to wystarczy i kosztuje mniej. Integracja szyta na miarę ma sens, gdy
- zwroty i obniżki w Stripe mają same zamieniać się w korekty, bez ręcznej pracy
- używasz kuponów, okresów próbnych lub proporcjonalnych rozliczeń przy zmianie planu
- masz kilka kont Stripe lub Stripe Connect i jedną firmę
- dane nabywcy (NIP, adres) są w Twojej aplikacji, a nie w Stripe
- numer faktury i KSeF ma wracać do Stripe i do Twojej bazy 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.
Fakturownia ma własną integrację ze Stripe. Po co więcej?
Często nie trzeba więcej i na rozmowie to sprawdzimy. Wbudowana integracja dobrze wystawia fakturę lub paragon po płatności. Według dokumentacji Fakturowni nie przenosi kuponów ze Stripe, a o zwrotach i korektach nic nie mówi. Integracja szyta na miarę ma sens, gdy te braki kosztują Cię czas co miesiąc.
Kto wysyła fakturę do KSeF, integracja czy Fakturownia?
Fakturownia. Integracja tworzy fakturę w Fakturowni, a Fakturownia wysyła ją do KSeF sama albo wtedy, gdy integracja o to poprosi. Numer KSeF wraca do Stripe razem ze statusem wysyłki. Dostęp do KSeF ustawiasz w swoim koncie Fakturowni.
Co się dzieje przy zwrocie w Stripe?
Integracja wystawia w Fakturowni fakturę korygującą do faktury pierwotnej, na zwróconą kwotę lub zwrócone pozycje. Korekta idzie do KSeF i wskazuje numer KSeF faktury, którą koryguje. Klient dostaje ją e-mailem.
Czy faktura może powstać dwa razy dla tej samej płatności?
Nie. Każda faktura dostaje identyfikator płatności ze Stripe jako numer zamówienia, a Fakturownia nie przyjmie drugiej faktury z tym samym numerem. Ponowne powiadomienie ze Stripe nie utworzy duplikatu.
Co z płatnościami w euro lub dolarach?
Faktura może być w walucie obcej, ale kwotę VAT trzeba przeliczyć na złote. Kurs i przeliczenie liczy Fakturownia według ustawień Twojego konta, a my sprawdzamy je z księgową przed startem.
Czy muszę wyłączyć faktury w Stripe?
Warto wyłączyć wysyłkę faktur i potwierdzeń ze Stripe do klientów, żeby klient nie dostawał dwóch dokumentów za tę samą płatność. Fakturą dla klienta i dla urzędu jest ta z Fakturowni.
Czy dostęp do Stripe i Fakturowni zostaje po mojej stronie?
Tak. W Stripe tworzysz dostęp, który pozwala integracji tylko na to, czego potrzebuje, a w Fakturowni osobny kod API. 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ę w Fakturowni
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 wysyła do API Fakturowni (POST /invoices.json) gotową fakturę: nabywcę z NIP-em, pozycje z ilością, ceną i stawką VAT, walutę i status opłaconej. Płatności bez faktury w Stripe (na przykład Checkout Sessions bez włączonego tworzenia faktur) obsługujemy osobno, ze zdarzenia o udanej płatności. Do Stripe integracja łączy się kluczem z ograniczonymi uprawnieniami (restricted key), a do Fakturowni kodem API z Twojego konta.
NIP nabywcy pochodzi z pola Tax ID klienta w Stripe albo z Twojej aplikacji, jeśli tam trzymasz dane firm. Jeśli firma jest już w Fakturowni, integracja podaje jej client_id, żeby nie mnożyć kontrahentów. Proporcjonalne rozliczenia 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.
KSeF zostaje w Fakturowni
Nie budujemy własnej wysyłki do KSeF. Fakturownia ma ją wbudowaną: faktura z oznaczeniem, że nabywca jest firmą (buyer_company), idzie do KSeF automatycznie według ustawień konta albo na zlecenie z API (gov_save_and_send). Numer KSeF (gov_id) i status wysyłki (gov_status) przychodzą w webhooku Fakturowni, a integracja zapisuje je w metadanych płatności lub faktury w Stripe razem z numerem faktury i linkiem do PDF.
Zwroty i korekty
Credit note w Stripe (credit_note.created) albo zwrot płatności (charge.refunded) uruchamia w Fakturowni fakturę korygującą powiązaną z fakturą pierwotną (invoice_id). Fakturownia dopisuje do niej numer KSeF faktury korygowanej i wysyła korektę do KSeF. Korekta obejmuje tylko te pozycje i kwoty, które zawiera credit note lub zwrot. Moment wystawienia faktury przy usługach ciągłych ustalamy z księgową przed startem, bo to decyzja podatkowa, a nie techniczna.
Duplikaty i błędy
Identyfikator faktury lub płatności ze Stripe trafia do pola numeru zamówienia (oid) z włączoną unikalnością, więc ponowione zdarzenie ze Stripe nie wystawi drugiej faktury. Każde wywołanie przechodzi przez kolejkę z ponowieniami. Gdy Fakturownia odrzuci dane (np. brak NIP-u albo niepoprawna stawka VAT) lub KSeF zwróci błąd (gov_error_messages), faktura czeka, a Ty dostajesz alert e-mail z opisem błędu.