# Stripe + Brew

Synchronizuj klientów Stripe z odbiorcami marki, uruchamiaj automatyzacje dowolnym z 22 zdarzeń Stripe i korzystaj z gotowych e-maili cyklu życia (powitanie, koniec okresu próbnego, odzyskiwanie nieudanych płatności, reaktywacja).

Kanoniczny adres URL: https://brew.new/pl/browse/integrations/stripe

- Kierunek danych: Import danych
- Połączenie: OAuth
- Synchronizacja klientów + wyzwalacze zdarzeń

## Dostępne funkcje

- **Wyzwalacze zdarzeń**: Uruchamiaj automatyzacje Brew dowolnym z 22 zdarzeń Stripe z kategorii: subskrypcje, faktury, sesje Checkout, oferty, obciążenia, zwroty i intencje płatności.
- **Synchronizacja kontaktów**: Synchronizuj klientów Stripe z odbiorcami marki – pola własne `stripe_*` są dostępne jako atrybuty, według których możesz filtrować.
- **Zbiorczy import klientów**: Jednym kliknięciem zaimportuj wszystkich klientów Stripe do aktywnej marki. Import można wznowić, a dzięki Vercel Workflow jest odporny na przerwy.
- **Szablony e-maili cyklu życia**: Szablony startowe: powitanie, koniec okresu próbnego, odzyskiwanie nieudanych płatności i reaktywacja.

## Zamień zdarzenia płatności w przydatne e-maile

Połącz Stripe przez OAuth, aby wysyłać e-maile spójne z marką, gdy zaczyna się subskrypcja, zbliża się koniec okresu próbnego lub płatność za fakturę się nie powiedzie. Brew rejestruje webhook i udostępnia obsługiwane zdarzenia jako wyzwalacze automatyzacji.

Za płatności, ponowne próby obciążenia, zwroty i zmiany subskrypcji nadal odpowiada Stripe. Brew tworzy i wysyła e-maile.


## Co możesz zbudować

- Przypomnienia o końcu okresu próbnego: użyj zdarzenia customer.subscription.trial_will_end, aby wyjaśnić, co stanie się dalej, i dodać link do strony planu lub płatności.
- Powiadomienia o nieudanej płatności: użyj zdarzenia invoice.payment_failed, aby szybko wysłać powiadomienie z linkiem do własnej strony płatności. Skoordynuj je z e-mailami, które Stripe wysyła klientom, aby to samo powiadomienie nie wyszło dwa razy.
- E-maile powitalne dla subskrybentów: zacznij od zdarzenia customer.subscription.created lub checkout.session.completed i wybierz jeden wyzwalacz, aby uniknąć podwójnych powitań.
- E-maile o zmianie planu: zdarzenie customer.subscription.updated może dostarczyć pola previousPlan i newPlan, jeśli zdarzenie je zawiera.
- Potwierdzenia płatności: Stripe wysyła zdarzenie invoice.paid, gdy faktura zostanie opłacona. Jako tagów personalizacji użyj pól amount, currency i invoiceNumber.
- Powiadomienia o zbliżającym się odnowieniu: Stripe wysyła zdarzenie invoice.upcoming z polami amount i currency, zanim utworzy kolejną fakturę za subskrypcję. Dane zdarzenia nie zawierają daty odnowienia, więc dodaj link do swojej strony płatności ze szczegółami.
- E-maile po anulowaniu subskrypcji: Stripe wysyła zdarzenie customer.subscription.deleted, gdy subskrypcja zostanie anulowana lub usunięta. Nowa subskrypcja nie zatrzymuje uruchomienia, które już trwa, dlatego przed każdym kolejnym e-mailem dodaj warunek sprawdzający contact.stripe_subscription_status.
- Powiadomienia o wstrzymaniu i wznowieniu: dzięki zdarzeniom customer.subscription.paused i customer.subscription.resumed potwierdzisz subskrybentowi zmianę.
- Wyniki opóźnionych płatności: zdarzenia checkout.session.async_payment_succeeded i checkout.session.async_payment_failed informują, jak po finalizacji zakupu zakończyła się płatność metodą, która rozlicza się z opóźnieniem. Pola paymentStatus i sessionMode są dostępne jako tagi personalizacji.
- Przypomnienia o porzuconym koszyku: Brew nie ma wyzwalacza dla wygasłych sesji Checkout. Gdy Twoja aplikacja wykryje wygaśnięcie sesji, wywołaj własne zdarzenie.
- Potwierdzenia zwrotów: zdarzenie refund.created zawiera pola refundAmount, refundCurrency, refundReason i refundStatus dla konkretnego zwrotu. Zdarzenie charge.refunded zawiera tylko łączne kwoty dla całego obciążenia, np. amountRefunded.
- E-maile w sprawie ofert: zdarzenia quote.finalized, quote.accepted i quote.canceled zawierają kwotę, walutę i status oferty. Nie ma pola z linkiem do oferty, więc odeślij kupującego na własną stronę.
- Nieudane płatności jednorazowe: zdarzenie payment_intent.payment_failed zawiera pola failureCode, failureMessage i declineCode, więc w e-mailu możesz podać przyczynę niepowodzenia płatności.

## Przypomnienie o nieudanej płatności, które sprawdza bieżący stan

Zacznij od jednego e-maila uruchamianego zdarzeniem invoice.payment_failed. Na potrzeby późniejszego przypomnienia niech Twoja aplikacja zaplanuje ponowne sprawdzenie statusu faktury w Stripe. Osobne własne zdarzenie Brew wywołaj tylko wtedy, gdy faktura nadal jest nieopłacona, a klient nadal spełnia warunki.

Po kroku „Czekaj” pola zdarzenia nadal zawierają pierwotne dane zdarzenia. Warunek contact.stripe_subscription_status odczytuje bieżącą wartość pola w kontakcie Brew w chwili wykonania tego kroku. Nie odpytuje Stripe i nie dowodzi, że konkretna faktura została opłacona. Aktualizacje kontaktu i nowe zdarzenia płatności nie anulują automatycznie wcześniejszego uruchomienia. Aktualizacja karty również nie jest dowodem płatności.

Przetestuj obie ścieżki: klient, którego faktura jest nadal nieopłacona i który nadal spełnia warunki, dostaje przypomnienie; klient, który zapłaci przed zaplanowanym sprawdzeniem, go nie dostaje. Ponowienia testuj zgodnie z udokumentowanym kontraktem idempotentności.


## Skonfiguruj Stripe w Brew

- Otwórz Integracje, wybierz Stripe i kliknij Połącz. Autoryzuj dostęp przez Stripe OAuth.
- Brew konfiguruje webhook i 22 obsługiwane typy zdarzeń. Nie ma przełącznika do włączania lub wyłączania zdarzeń.
- Aby zaimportować istniejących klientów, otwórz kartę Zarządzanie i wybierz „Synchronizuj klientów ze Stripe”. Sam rekord klienta nie oznacza zgody na e-maile marketingowe.
- Utwórz automatyzację i wybierz dla niej zdarzenie Stripe. Sprawdź odbiorcę, pola danych zdarzenia, treść e-maila i linki do płatności.
- Brew łączy się z kontami Stripe w trybie produkcyjnym, a zdarzenia z trybu testowego Stripe nie synchronizują kontaktów ani nie uruchamiają automatyzacji. Przed publikacją zostaw automatyzację jako wersję roboczą i przetestuj ją na kontrolowanej grupie odbiorców. Po nadejściu pasującego zdarzenia uruchamiają się tylko aktywne automatyzacje.
- Agent może tworzyć, testować i publikować automatyzacje przez MCP Brew lub API, gdy uprawniona osoba połączy konto Stripe w aplikacji.

## Obsługiwane zdarzenia Stripe

Brew obsługuje 22 typy zdarzeń:

- checkout.session.async_payment_succeeded
- checkout.session.async_payment_failed
- checkout.session.completed
- customer.created
- customer.updated
- customer.deleted
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.paused
- customer.subscription.resumed
- customer.subscription.trial_will_end
- customer.subscription.deleted
- invoice.created
- invoice.paid
- invoice.payment_failed
- invoice.upcoming
- quote.finalized
- quote.accepted
- quote.canceled
- charge.refunded
- refund.created
- payment_intent.payment_failed

## Synchronizacja klientów i personalizacja

Zdarzenia klientów i subskrypcji mogą uzupełniać kontakty w Brew o informacje o płatnościach. Dostępne pola kontaktu to m.in. stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end i stripe_delinquent. Ich dostępność zależy od zdarzenia Stripe i otrzymanych danych.

W tagach personalizacji korzystaj ze schematu danych zadeklarowanego dla wybranego zdarzenia. Zależnie od zdarzenia dostępne pola to m.in. firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan i failureMessage. Kwoty są podawane w centach tam, gdzie schemat określa centy.

Identyfikatory obiektów Stripe są usuwane z danych zdarzeń w automatyzacjach. Nie zakładaj, że identyfikatorów faktur lub subskrypcji da się użyć jako tagów personalizacji. Brew nie zapisuje też w kontakcie identyfikatora klienta Stripe.

Ustawienie „Synchronizuj imię i nazwisko”, określane osobno dla każdego zdarzenia, decyduje, czy Stripe może aktualizować imię i nazwisko kontaktu. Nie włącza ani nie wyłącza wyzwalacza.


## Czy mogę zatrzymać przypomnienie, gdy klient zapłaci?

Późniejsze zdarzenie płatności nie anuluje automatycznie uruchomienia, które rozpoczęła wcześniejsza nieudana płatność. Przed przypomnieniem zaplanuj sprawdzenie po stronie aplikacji i wywołuj nowe zdarzenie tylko wtedy, gdy faktura jest nadal nieopłacona.


## Dlaczego zdarzenie jest widoczne, a e-mail nie został wysłany?

Odebranie zdarzenia i wysłanie e-maila to osobne kroki. Upewnij się, że pasująca automatyzacja jest aktywna, przejrzyj jej filtry i historię uruchomień, sprawdź, czy odbiorca może otrzymać wiadomość, i skontroluj domenę wysyłkową. Ustawienie „Synchronizuj imię i nazwisko” decyduje tylko o aktualizacji imienia i nazwiska.


## Ograniczenia i rozwiązywanie problemów

- Brew nie może tworzyć obciążeń, zlecać zwrotów ani zmieniać subskrypcji w Stripe.
- Jeśli zdarzenie widać na karcie Zdarzenia w sekcji Zarządzanie, ale e-mail nie dociera, sprawdź, czy powiązana automatyzacja jest aktywna, a także jej filtry i historię uruchomień, odbiorcę oraz gotowość domeny wysyłkowej.
- Jeśli błędy podpisu webhooka się powtarzają, połącz Stripe ponownie, aby wygenerować nowy sekret webhooka.
- Użyj zdarzenia refund.created, gdy e-mail potrzebuje pól dotyczących zwrotu; dostępne pola sprawdź w schemacie wyzwalacza.
- Sprawdź zgody i cel każdego e-maila. Import kontaktów z danych płatności nie upoważnia do wysyłek promocyjnych.

## Źródła i instrukcje konfiguracji

- [Zbuduj automatyzację e-maili cyklu życia ze Stripe](/pl/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [Porównaj integracje narzędzi e-mailowych ze Stripe](/pl/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Instrukcja konfiguracji Stripe](https://docs.brew.new/integrations/import/stripe)
- [Zbuduj automatyzację](https://docs.brew.new/create-emails/build-an-automation)
- [Tagi personalizacji](https://docs.brew.new/create-emails/merge-tags)
- [Dokumentacja zdarzeń Stripe](https://docs.stripe.com/api/events/types)
- [Ustawienia e-maili do klientów w Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Powiązane

- [Wszystkie integracje](https://brew.new/pl/browse/integrations.md)
- [Rejestracja](https://brew.new/pl/sign-up.md)
- Strona internetowa: https://brew.new