Zdarzenia webhook

Striptu odbiera webhooki Stripe i przy pierwszym zdarzeniu, które domyka płatność, wysyła żądanie wystawienia dokumentu do Twojego systemu księgowego. Jak Striptu współpracuje z Twoim kontem Stripe po połączeniu, przeczytasz w artykule połączenie ze Stripe.

checkout.session.completed

Podstawowe zdarzenie dla płatności przez Stripe Checkout i Payment Links.

invoice.paid

Opłacone faktury Stripe, w tym odnowienia subskrypcji.

charge.succeeded (opcjonalne)

Dla płatności tworzonych bez Checkout i bez faktury Stripe (np. własna integracja PaymentIntents). Zdarzenie włączasz w ustawieniach integracji Stripe (opcja Obsługuj eventy charge.succeeded), bo przy standardowej ścieżce płatności powodowałoby duplikaty.

To zdarzenie niesie mniej danych:

• bez NIP nabywcy (Tax ID nie jest odczytywany, więc firmy są traktowane jak B2C; NIP można przekazać w metadata przez overrider),
• bez stawki Stripe Tax (stosujemy domyślną stawkę z konfiguracji),
• z jedną pozycją utworzoną z opisu płatności.

invoice.finalized (opcjonalne)

Zdarzenie włączasz w ustawieniach integracji Stripe (opcja Obsługuj eventy invoice.finalized). Żądanie wystawienia dokumentu jest wysyłane już w momencie finalizacji faktury Stripe, przed opłaceniem. Po opłaceniu oznaczamy fakturę w systemie księgowym jako opłaconą.

Wykrywanie duplikatów

Duplikaty są wykrywane: jedna transakcja Stripe to jedna faktura, niezależnie od liczby zdarzeń.

Płatności asynchroniczne

Co do zasady dokument powstaje przy zdarzeniu domykającym płatność. Przy asynchronicznych metodach płatności (np. przelew) zdarzenie zakończenia Checkout może jednak przyjść przed zaksięgowaniem środków. Faktura powstaje wtedy już przy tym zdarzeniu.