# Stripe + Brew

Sinkronkan pelanggan Stripe ke audiens merek, picu otomatisasi dari 22 peristiwa Stripe, dan luncurkan email siklus hidup siap pakai (sambutan, akhir uji coba, pemulihan pembayaran gagal, win-back).

URL kanonis: https://brew.new/id/browse/integrations/stripe

- Arah: Data masuk
- Koneksi: OAuth
- Sinkronisasi pelanggan + pemicu peristiwa

## Kemampuan yang aktif

- **Pemicu peristiwa**: Picu otomatisasi Brew dari 22 peristiwa Stripe untuk langganan, invoice, checkout, penawaran, tagihan, pengembalian dana, dan payment intent.
- **Sinkronkan kontak**: Sinkronkan pelanggan Stripe ke audiens merek, dengan field kustom `stripe_*` yang tersedia sebagai atribut yang dapat difilter.
- **Impor pelanggan massal**: Impor semua pelanggan Stripe yang sudah ada ke merek aktif dengan sekali klik. Dapat dilanjutkan dan tahan gangguan berkat Vercel Workflow.
- **Templat email siklus hidup**: Templat awal untuk sambutan, akhir uji coba, pemulihan pembayaran gagal, dan win-back.

## Ubah peristiwa penagihan menjadi email yang bermanfaat

Hubungkan Stripe lewat OAuth untuk memulai email bermerek saat langganan dimulai, masa uji coba hampir berakhir, atau pembayaran invoice gagal. Brew mendaftarkan webhook dan menyediakan peristiwa yang didukung sebagai pemicu otomatisasi.

Stripe tetap bertanggung jawab atas pembayaran, percobaan ulang, pengembalian dana, dan perubahan langganan. Brew membuat dan mengirim emailnya.


## Yang bisa Anda buat

- Pengingat masa uji coba: gunakan peristiwa customer.subscription.trial_will_end untuk menjelaskan apa yang terjadi selanjutnya dan menautkan ke halaman paket atau penagihan Anda.
- Pemberitahuan pembayaran gagal: gunakan peristiwa invoice.payment_failed untuk mengirim pemberitahuan tepat waktu dengan tautan ke halaman penagihan Anda sendiri. Selaraskan dengan email pelanggan yang dikirim Stripe agar pemberitahuan yang sama tidak terkirim dua kali.
- Email sambutan pelanggan: mulai dari peristiwa customer.subscription.created atau checkout.session.completed, dan pilih salah satu pemicu agar email sambutan tidak terkirim ganda.
- Email perubahan paket: peristiwa customer.subscription.updated dapat menyediakan field previousPlan dan newPlan jika peristiwa tersebut menyertakannya.
- Konfirmasi pembayaran: invoice.paid dipicu saat invoice dibayar. Gunakan amount, currency, dan invoiceNumber sebagai merge tag.
- Pemberitahuan perpanjangan: invoice.upcoming dipicu sebelum Stripe membuat invoice berikutnya untuk sebuah langganan, dan membawa amount serta currency. Payload-nya tidak berisi tanggal perpanjangan, jadi tautkan ke halaman penagihan Anda untuk detailnya.
- Tindak lanjut pembatalan: customer.subscription.deleted dipicu saat langganan dibatalkan atau dihapus. Langganan baru tidak menghentikan eksekusi yang sedang berjalan, jadi tambahkan kondisi pada contact.stripe_subscription_status sebelum setiap email berikutnya.
- Pemberitahuan jeda dan lanjut: customer.subscription.paused dan customer.subscription.resumed mengonfirmasi perubahan tersebut kepada pelanggan.
- Hasil pembayaran tertunda: checkout.session.async_payment_succeeded dan checkout.session.async_payment_failed melaporkan hasil akhir metode pembayaran tertunda setelah checkout. paymentStatus dan sessionMode tersedia sebagai merge tag.
- Pengingat checkout yang ditinggalkan: Brew tidak memiliki pemicu untuk sesi Checkout yang kedaluwarsa. Kirim peristiwa kustom Anda sendiri saat aplikasi Anda mendeteksi sesi yang kedaluwarsa.
- Konfirmasi pengembalian dana: refund.created membawa refundAmount, refundCurrency, refundReason, dan refundStatus untuk pengembalian dana tersebut. charge.refunded hanya membawa total di tingkat tagihan, seperti amountRefunded.
- Tindak lanjut penawaran: quote.finalized, quote.accepted, dan quote.canceled membawa nominal, mata uang, dan status penawaran. Tidak ada field tautan penawaran, jadi arahkan pembeli ke halaman Anda sendiri.
- Kegagalan pembayaran satu kali: payment_intent.payment_failed membawa failureCode, failureMessage, dan declineCode, sehingga email dapat menjelaskan penyebab pembayaran gagal.

## Tindak lanjut pembayaran gagal yang memeriksa status terkini

Mulailah dengan satu email yang dipicu oleh peristiwa invoice.payment_failed. Untuk pengingat berikutnya, minta aplikasi Anda menjadwalkan pemeriksaan ulang status invoice di Stripe. Kirim peristiwa kustom Brew terpisah hanya jika invoice masih belum dibayar dan pelanggan masih memenuhi syarat.

Setelah langkah Tunggu, field peristiwa masih berisi payload peristiwa aslinya. Kondisi contact.stripe_subscription_status membaca nilai field tersebut saat ini pada kontak Brew ketika langkah itu dijalankan. Kondisi ini tidak menanyakan ke Stripe dan tidak membuktikan bahwa invoice tertentu sudah dibayar. Pembaruan kontak dan peristiwa pembayaran baru tidak otomatis membatalkan eksekusi sebelumnya. Memperbarui kartu juga bukan bukti pembayaran.

Uji kedua jalur: pelanggan yang invoice-nya masih belum dibayar dan masih memenuhi syarat menerima pengingat; pelanggan yang membayar sebelum pemeriksaan terjadwal tidak menerimanya. Uji percobaan ulang dengan kontrak idempotensi yang terdokumentasi.


## Siapkan Stripe di Brew

- Buka Integrasi, pilih Stripe, lalu pilih Hubungkan. Berikan otorisasi akses melalui Stripe OAuth.
- Brew menyiapkan webhook dan 22 jenis peristiwa yang didukung. Tidak ada tombol untuk mengaktifkan atau menonaktifkan peristiwa.
- Untuk mengimpor pelanggan yang sudah ada, buka Kelola lalu pilih Sinkronkan pelanggan dari Stripe. Data pelanggan saja tidak membuktikan adanya persetujuan untuk email pemasaran.
- Buat otomatisasi, lalu pilih peristiwa Stripe yang memicunya. Tinjau penerima, field payload, konten email, dan tautan penagihan.
- Brew menghubungkan akun Stripe live, dan peristiwa mode uji tidak menyinkronkan kontak atau memulai otomatisasi. Biarkan otomatisasi tetap berstatus Draf, lalu uji dengan penerima yang Anda kendalikan sebelum memublikasikannya. Hanya otomatisasi berstatus Aktif yang dijalankan saat peristiwa yang cocok masuk.
- Agen dapat membuat, menguji, dan memublikasikan otomatisasi melalui MCP Brew atau API setelah orang yang berwenang menghubungkan akun Stripe di aplikasi.

## Peristiwa Stripe yang didukung

Brew mendukung 22 jenis peristiwa berikut:

- 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

## Sinkronisasi pelanggan dan personalisasi

Peristiwa pelanggan dan langganan dapat memperbarui kontak Brew dengan konteks penagihan. Field kontak yang tersedia mencakup stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end, dan stripe_delinquent. Ketersediaannya bergantung pada peristiwa Stripe dan data yang diterima.

Gunakan skema payload yang dideklarasikan untuk peristiwa terpilih sebagai acuan merge tag. Bergantung pada peristiwanya, field yang tersedia mencakup firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan, dan failureMessage. Nominal uang dinyatakan dalam sen jika skema menyebutkan sen.

Pengenal objek Stripe dihapus dari payload otomatisasi. Jangan berasumsi ID invoice atau langganan dapat dipakai sebagai merge tag. Brew juga tidak menyimpan ID pelanggan Stripe di kontak.

Pengaturan Sinkronkan nama lengkap per peristiwa menentukan apakah Stripe dapat memperbarui nama kontak. Pengaturan ini tidak mengaktifkan atau menonaktifkan pemicu.


## Bisakah saya menghentikan pengingat setelah pelanggan membayar?

Peristiwa pembayaran yang datang belakangan tidak otomatis membatalkan eksekusi yang dimulai oleh kegagalan sebelumnya. Jadwalkan pemeriksaan di sisi aplikasi sebelum pengingat, dan kirim peristiwa baru hanya selama invoice masih belum dibayar.


## Mengapa peristiwa muncul tetapi email tidak terkirim?

Menerima peristiwa dan mengirim email adalah dua langkah terpisah. Pastikan otomatisasi yang cocok berstatus Aktif, periksa filter dan riwayat eksekusinya, serta cek kelayakan penerima dan domain pengirim. Pengaturan Sinkronkan nama lengkap hanya mengatur pembaruan nama.


## Batasan dan pemecahan masalah

- Brew tidak dapat membuat tagihan, menerbitkan pengembalian dana, atau mengubah langganan Stripe.
- Jika peristiwa muncul di tab Peristiwa pada Kelola tetapi tidak ada email yang masuk, periksa apakah otomatisasi yang terhubung berstatus Aktif, filter dan riwayat eksekusinya, penerima, serta kesiapan domain pengirim.
- Jika kesalahan tanda tangan webhook terus terjadi, hubungkan ulang Stripe untuk menyiapkan kunci rahasia webhook yang baru.
- Gunakan peristiwa refund.created jika email memerlukan field khusus pengembalian dana; pastikan field yang tersedia di skema pemicu.
- Tinjau persetujuan dan tujuan setiap email. Mengimpor kontak penagihan tidak memberi izin untuk pengiriman promosi.

## Sumber dan panduan penyiapan

- [Membuat alur kerja email siklus hidup Stripe](/id/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [Perbandingan integrasi email Stripe](/id/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Panduan penyiapan Stripe](https://docs.brew.new/integrations/import/stripe)
- [Membuat otomatisasi](https://docs.brew.new/create-emails/build-an-automation)
- [Merge tag](https://docs.brew.new/create-emails/merge-tags)
- [Referensi peristiwa Stripe](https://docs.stripe.com/api/events/types)
- [Pengaturan email pelanggan Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Terkait

- [Semua integrasi](https://brew.new/id/browse/integrations.md)
- [Daftar](https://brew.new/id/sign-up.md)
- Situs web: https://brew.new