# Stripe + Brew

Synchronizuj zákazníky ze Stripe do publika značky, spouštěj automatizace pomocí 22 událostí ze Stripe a nasaď hotové e-maily životního cyklu (uvítání, konec zkušební verze, záchrana neúspěšné platby, znovuzískání zákazníků).

Kanonická URL: https://brew.new/cs/browse/integrations/stripe

- Směr: Příchozí data
- Připojení: OAuth
- Synchronizace zákazníků a spouštěče událostí

## Dostupné funkce

- **Spouštěče událostí**: Spouštěj automatizace v Brew pomocí 22 událostí ze Stripe napříč předplatnými, fakturami, relacemi Checkout, cenovými nabídkami, platbami, refundacemi a platebními záměry.
- **Synchronizace kontaktů**: Synchronizuj zákazníky ze Stripe do publika značky s vlastními poli `stripe_*`, podle kterých můžeš filtrovat.
- **Hromadný import zákazníků**: Doplnění všech zákazníků ze Stripe do aktivní značky jedním kliknutím. Dá se obnovit od místa přerušení a díky Vercel Workflow přežije i výpadky.
- **Šablony e-mailů životního cyklu**: Výchozí šablony pro uvítání, konec zkušební verze, záchranu neúspěšné platby a znovuzískání zákazníků.

## Udělej z fakturačních událostí užitečné e-maily

Připoj Stripe přes OAuth a spouštěj e-maily v duchu značky, když začne předplatné, blíží se konec zkušební verze nebo selže platba faktury. Brew zaregistruje webhook a podporované události zpřístupní jako spouštěče automatizací.

Platby, opakované pokusy, refundace a změny předplatného má dál na starosti Stripe. Brew e-maily vytváří a posílá.


## Co můžeš vytvořit

- Připomínky konce zkušební verze: pomocí události customer.subscription.trial_will_end vysvětli, co bude dál, a odkaž na stránku s tarifem nebo fakturací.
- Upozornění na neúspěšnou platbu: pomocí události invoice.payment_failed včas pošli upozornění s odkazem na vlastní stránku s fakturací. Slaď ho se zákaznickými e-maily, které posílá Stripe, aby stejné upozornění neodešlo dvakrát.
- Uvítací e-maily pro předplatitele: začni událostí customer.subscription.created nebo checkout.session.completed a vyber jen jeden spouštěč, aby uvítání nepřišlo dvakrát.
- E-maily o změně tarifu: událost customer.subscription.updated může dodat pole previousPlan a newPlan, pokud je obsahuje.
- Potvrzení o platbě: událost invoice.paid nastane, když je faktura zaplacená. Jako proměnné použij amount, currency a invoiceNumber.
- Upozornění před prodloužením předplatného: událost invoice.upcoming nastane předtím, než Stripe vytvoří další fakturu za předplatné, a obsahuje pole amount a currency. Její payload neobsahuje datum prodloužení, takže kvůli podrobnostem odkaž na svou stránku s fakturací.
- Navazující e-maily po zrušení: událost customer.subscription.deleted nastane, když je předplatné zrušeno nebo smazáno. Nové předplatné už probíhající běh nezastaví, a proto před každý další e-mail přidej podmínku na contact.stripe_subscription_status.
- Oznámení o pozastavení a obnovení: pomocí událostí customer.subscription.paused a customer.subscription.resumed potvrdíš předplatiteli změnu.
- Výsledky opožděných plateb: události checkout.session.async_payment_succeeded a checkout.session.async_payment_failed hlásí, jak po dokončení relace Checkout dopadla platba metodou s opožděným potvrzením. Jako proměnné jsou k dispozici paymentStatus a sessionMode.
- Připomínky nedokončené objednávky: Brew nemá spouštěč pro relace Checkout, kterým vypršela platnost. Když tvoje aplikace zjistí, že relace vypršela, spusť vlastní událost.
- Potvrzení refundace: událost refund.created obsahuje pro konkrétní refundaci pole refundAmount, refundCurrency, refundReason a refundStatus. Událost charge.refunded obsahuje jen souhrnné údaje za celou platbu, například amountRefunded.
- Navazující e-maily k cenovým nabídkám: události quote.finalized, quote.accepted a quote.canceled obsahují částku, měnu a stav nabídky. Pole s odkazem na nabídku chybí, takže kupujícího nasměruj na vlastní stránku.
- Neúspěšné jednorázové platby: událost payment_intent.payment_failed obsahuje pole failureCode, failureMessage a declineCode, takže e-mail může zohlednit, proč platba selhala.

## Navazující e-mail po neúspěšné platbě, který ověřuje aktuální stav

Začni jedním e-mailem, který spustí událost invoice.payment_failed. Pro pozdější připomínku nech svou aplikaci naplánovat novou kontrolu stavu faktury ve Stripe. Samostatnou vlastní událost Brew spusť, jen pokud faktura zůstává nezaplacená a zákazník má na připomínku stále nárok.

Po kroku Čekání obsahují pole události pořád původní payload události. Podmínka contact.stripe_subscription_status čte aktuální hodnotu pole u kontaktu v Brew ve chvíli, kdy se daný uzel spustí. Nedotazuje se Stripe a neprokazuje, že konkrétní faktura byla zaplacena. Aktualizace kontaktu ani nové platební události dřívější běh automaticky nezruší. Ani aktualizace karty není důkazem platby.

Otestuj obě cesty: zákazník, jehož faktura je stále nezaplacená a který má na připomínku stále nárok, ji dostane; zákazník, který zaplatí před naplánovanou kontrolou, ji nedostane. Opakované pokusy otestuj podle zdokumentovaných pravidel idempotence.


## Nastavení Stripe v Brew

- Otevři Integrace, vyber Stripe a klikni na Připojit. Přístup autorizuj přes Stripe OAuth.
- Brew zřídí webhook a 22 podporovaných typů událostí. Jednotlivé události nejde zapnout ani vypnout.
- Pokud chceš naimportovat stávající zákazníky, otevři kartu Správa a zvol Synchronizovat zákazníky ze Stripe. Samotný záznam zákazníka neznamená souhlas s marketingovými e-maily.
- Vytvoř automatizaci a vyber pro ni událost ze Stripe. Zkontroluj příjemce, pole payloadu, obsah e-mailu a odkazy na fakturaci.
- Brew připojuje ostré účty Stripe a události z testovacího režimu nesynchronizují kontakty ani nespouštějí automatizace. Automatizaci nech jako koncept a před publikováním ji otestuj s příjemci, které máš pod kontrolou. Když dorazí odpovídající událost, spustí se jen aktivní automatizace.
- Agent může vytvářet, testovat a publikovat automatizace přes Brew MCP nebo API, jakmile oprávněná osoba připojí účet Stripe v aplikaci.

## Podporované události Stripe

Brew podporuje těchto 22 typů událostí:

- 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

## Synchronizace zákazníků a personalizace

Události zákazníků a předplatného můžou kontakty v Brew doplnit o kontext fakturace. K dispozici jsou mimo jiné pole kontaktů stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end a stripe_delinquent. Dostupnost závisí na události ze Stripe a přijatých datech.

Pro proměnné vycházej z deklarovaného schématu payloadu vybrané události. Podle události jsou k dispozici mimo jiné pole firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan a failureMessage. Peněžní částky jsou v centech tam, kde to schéma uvádí.

Identifikátory objektů Stripe se z payloadů automatizací odstraňují. Nepočítej s tím, že ID faktur nebo předplatných půjde použít jako proměnné. Brew u kontaktu neukládá ani ID zákazníka ve Stripe.

Nastavení Synchronizovat celé jméno u každé události určuje, jestli Stripe smí aktualizovat jméno kontaktu. Spouštěč tím nezapneš ani nevypneš.


## Dá se připomínka zastavit, když zákazník zaplatí?

Pozdější platební událost automaticky nezruší běh, který spustilo dřívější selhání platby. Před připomínkou naplánuj kontrolu na straně aplikace a novou událost spusť, jen dokud je faktura nezaplacená.


## Proč se událost zobrazí, ale e-mail neodejde?

Přijetí události a odeslání e-mailu jsou samostatné kroky. Ověř, že odpovídající automatizace je aktivní, projdi její filtry a historii běhů a zkontroluj, jestli má příjemce na e-mail nárok a jak je na tom odesílací doména. Nastavení Synchronizovat celé jméno řídí jen aktualizace jména.


## Omezení a řešení potíží

- Brew nemůže vytvářet platby, vystavovat refundace ani měnit předplatná ve Stripe.
- Pokud se událost zobrazí na kartě Události v sekci Správa, ale žádný e-mail nedorazí, zkontroluj, že navázaná automatizace je aktivní, a projdi její filtry a historii běhů, příjemce a připravenost odesílací domény.
- Pokud chyby podpisu webhooku přetrvávají, připoj Stripe znovu a zřídí se nové tajemství webhooku.
- Když e-mail potřebuje pole specifická pro refundace, použij událost refund.created; dostupná pole ověř ve schématu spouštěče.
- U každého e-mailu zkontroluj souhlas a účel. Import fakturačních kontaktů tě neopravňuje k propagačním rozesílkám.

## Zdroje a návody k nastavení

- [Sestav e-maily životního cyklu podle událostí ze Stripe](/cs/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [Porovnej e-mailové integrace se Stripe](/cs/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Návod k nastavení Stripe](https://docs.brew.new/integrations/import/stripe)
- [Vytvoř automatizaci](https://docs.brew.new/create-emails/build-an-automation)
- [Proměnné](https://docs.brew.new/create-emails/merge-tags)
- [Přehled událostí Stripe](https://docs.stripe.com/api/events/types)
- [Nastavení zákaznických e-mailů ve Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Související

- [Všechny integrace](https://brew.new/cs/browse/integrations.md)
- [Registrace](https://brew.new/cs/sign-up.md)
- Web: https://brew.new