# Stripe + Brew

Đồng bộ khách hàng Stripe vào đối tượng của thương hiệu, kích hoạt tự động hóa từ 22 sự kiện Stripe và triển khai email vòng đời dựng sẵn (chào mừng, hết hạn dùng thử, khôi phục thanh toán thất bại, giành lại khách hàng).

URL chính tắc: https://brew.new/vi/browse/integrations/stripe

- Chiều dữ liệu: Dữ liệu vào
- Kết nối: OAuth
- Đồng bộ khách hàng + trình kích hoạt sự kiện

## Tính năng đang hoạt động

- **Trình kích hoạt sự kiện**: Kích hoạt tự động hóa trong Brew từ 22 sự kiện Stripe về gói đăng ký, hóa đơn, checkout, báo giá, giao dịch thanh toán, hoàn tiền và payment intent.
- **Đồng bộ liên hệ**: Đồng bộ khách hàng Stripe vào đối tượng của thương hiệu, kèm các trường tùy chỉnh `stripe_*` có thể dùng làm thuộc tính để lọc.
- **Nhập khách hàng hàng loạt**: Đưa toàn bộ khách hàng Stripe hiện có vào thương hiệu đang chọn chỉ với một cú nhấp. Có thể tiếp tục khi bị gián đoạn và chạy bền vững nhờ Vercel Workflow.
- **Mẫu email vòng đời**: Mẫu khởi đầu cho email chào mừng, hết hạn dùng thử, khôi phục thanh toán thất bại và giành lại khách hàng.

## Biến sự kiện thanh toán thành email hữu ích

Kết nối Stripe qua OAuth để bắt đầu gửi email chuẩn thương hiệu khi một gói đăng ký bắt đầu, thời gian dùng thử sắp kết thúc hoặc thanh toán hóa đơn thất bại. Brew đăng ký webhook và đưa các sự kiện được hỗ trợ vào danh sách trình kích hoạt cho tự động hóa.

Stripe vẫn chịu trách nhiệm về thanh toán, thử lại thanh toán, hoàn tiền và thay đổi gói đăng ký. Brew tạo và gửi email.


## Bạn có thể xây dựng gì

- Nhắc hết hạn dùng thử: dùng sự kiện customer.subscription.trial_will_end để giải thích điều gì sẽ diễn ra tiếp theo và dẫn liên kết tới trang gói hoặc trang thanh toán của bạn.
- Thông báo thanh toán thất bại: dùng sự kiện invoice.payment_failed để gửi thông báo kịp thời kèm liên kết tới trang thanh toán của riêng bạn. Hãy phối hợp với các email khách hàng mà Stripe gửi, để cùng một thông báo không bị gửi hai lần.
- Email chào mừng người đăng ký: bắt đầu từ sự kiện customer.subscription.created hoặc checkout.session.completed, và chỉ chọn một trình kích hoạt để tránh gửi email chào mừng trùng lặp.
- Email thay đổi gói: sự kiện customer.subscription.updated có thể cung cấp trường previousPlan và newPlan khi sự kiện có chứa các trường này.
- Xác nhận thanh toán: sự kiện invoice.paid xảy ra khi một hóa đơn được thanh toán. Dùng amount, currency và invoiceNumber làm thẻ cá nhân hóa.
- Báo trước kỳ gia hạn: sự kiện invoice.upcoming xảy ra trước khi Stripe tạo hóa đơn tiếp theo cho một gói đăng ký, kèm theo amount và currency. Payload của sự kiện này không có ngày gia hạn, vì vậy hãy dẫn liên kết tới trang thanh toán của bạn để người nhận xem chi tiết.
- Email tiếp nối khi hủy gói: sự kiện customer.subscription.deleted xảy ra khi một gói đăng ký bị hủy hoặc bị xóa. Một gói đăng ký mới không dừng lượt chạy đang diễn ra, vì vậy hãy thêm điều kiện theo contact.stripe_subscription_status trước mỗi email gửi sau đó.
- Thông báo tạm dừng và tiếp tục: customer.subscription.paused và customer.subscription.resumed giúp bạn xác nhận thay đổi với người đăng ký.
- Kết quả thanh toán chậm: checkout.session.async_payment_succeeded và checkout.session.async_payment_failed cho biết khoản thanh toán qua phương thức xử lý chậm đã có kết quả thế nào sau checkout. Có thể dùng paymentStatus và sessionMode làm thẻ cá nhân hóa.
- Nhắc checkout bị bỏ dở: Brew không có trình kích hoạt cho phiên Checkout đã hết hạn. Hãy tự kích hoạt sự kiện tùy chỉnh khi ứng dụng của bạn phát hiện một phiên hết hạn.
- Xác nhận hoàn tiền: sự kiện refund.created mang theo refundAmount, refundCurrency, refundReason và refundStatus của khoản hoàn tiền cụ thể. Sự kiện charge.refunded chỉ mang theo tổng số ở cấp giao dịch thanh toán, chẳng hạn amountRefunded.
- Email tiếp nối báo giá: các sự kiện quote.finalized, quote.accepted và quote.canceled mang theo số tiền, đơn vị tiền tệ và trạng thái của báo giá. Không có trường liên kết tới báo giá, vì vậy hãy dẫn người mua tới trang của riêng bạn.
- Thanh toán một lần thất bại: sự kiện payment_intent.payment_failed mang theo failureCode, failureMessage và declineCode, để email có thể nêu lý do thanh toán thất bại.

## Email tiếp nối khi thanh toán thất bại, có kiểm tra trạng thái hiện tại

Bắt đầu với một email được kích hoạt bởi sự kiện invoice.payment_failed. Với lời nhắc sau đó, hãy để ứng dụng của bạn lên lịch kiểm tra lại trạng thái hóa đơn trong Stripe. Chỉ kích hoạt một sự kiện tùy chỉnh riêng trong Brew nếu hóa đơn vẫn chưa được thanh toán và khách hàng vẫn đủ điều kiện.

Sau một bước Chờ, các trường sự kiện vẫn chứa payload gốc của sự kiện. Điều kiện contact.stripe_subscription_status đọc giá trị hiện tại của trường này trên liên hệ trong Brew tại thời điểm nút đó chạy. Điều kiện này không truy vấn Stripe và không chứng minh rằng một hóa đơn cụ thể đã được thanh toán. Việc cập nhật liên hệ và các sự kiện thanh toán mới không tự động hủy một lượt chạy trước đó. Việc cập nhật thẻ cũng không phải là bằng chứng đã thanh toán.

Hãy thử nghiệm cả hai trường hợp: khách hàng có hóa đơn vẫn chưa thanh toán và vẫn đủ điều kiện sẽ nhận được lời nhắc; khách hàng đã thanh toán trước lần kiểm tra theo lịch thì không. Hãy thử nghiệm các lần thử lại theo quy ước về tính lũy đẳng đã được mô tả trong tài liệu.


## Thiết lập Stripe trong Brew

- Mở mục Tích hợp, chọn Stripe rồi chọn Kết nối. Cấp quyền truy cập qua Stripe OAuth.
- Brew tự khởi tạo webhook và 22 loại sự kiện được hỗ trợ. Không có công tắc bật/tắt cho từng sự kiện.
- Để nhập khách hàng hiện có, hãy mở thẻ Quản lý và chọn Đồng bộ khách hàng từ Stripe. Riêng hồ sơ khách hàng không đồng nghĩa với việc họ đã đồng ý nhận email tiếp thị.
- Tạo một tự động hóa và chọn sự kiện Stripe cho tự động hóa đó. Kiểm tra lại người nhận, các trường payload, nội dung email và liên kết thanh toán.
- Brew kết nối tài khoản Stripe thực tế; sự kiện ở chế độ thử nghiệm không đồng bộ liên hệ và không khởi chạy tự động hóa. Hãy giữ tự động hóa ở trạng thái Bản nháp và chạy thử với những người nhận do bạn kiểm soát trước khi xuất bản. Chỉ những tự động hóa ở trạng thái Đang hoạt động mới chạy khi có sự kiện khớp được gửi đến.
- Agent có thể tạo, chạy thử và xuất bản tự động hóa qua Brew MCP hoặc API, sau khi người có thẩm quyền kết nối tài khoản Stripe trong ứng dụng.

## Các sự kiện Stripe được hỗ trợ

Brew hỗ trợ 22 loại sự kiện sau:

- 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

## Đồng bộ khách hàng và cá nhân hóa

Các sự kiện về khách hàng và gói đăng ký có thể cập nhật thông tin thanh toán cho liên hệ trong Brew. Các trường liên hệ khả dụng gồm stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end và stripe_delinquent. Việc có những trường nào phụ thuộc vào sự kiện Stripe và dữ liệu nhận được.

Dùng lược đồ payload đã khai báo của sự kiện được chọn cho thẻ cá nhân hóa. Tùy theo sự kiện, các trường gồm firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan và failureMessage. Số tiền được tính bằng cent ở những chỗ lược đồ quy định đơn vị cent.

Mã định danh đối tượng Stripe bị loại khỏi payload của tự động hóa. Đừng mặc định rằng có thể dùng ID hóa đơn hoặc ID gói đăng ký làm thẻ cá nhân hóa. Brew cũng không lưu ID khách hàng Stripe trên liên hệ.

Cài đặt Đồng bộ họ và tên của từng sự kiện quyết định việc Stripe có được cập nhật tên của liên hệ hay không. Cài đặt này không bật hay tắt trình kích hoạt.


## Có dừng được email nhắc nhở sau khi khách hàng đã thanh toán không?

Sự kiện thanh toán đến sau không tự động hủy lượt chạy đã bắt đầu từ lần thanh toán thất bại trước đó. Hãy lên lịch một bước kiểm tra phía ứng dụng trước lời nhắc, và chỉ kích hoạt sự kiện mới khi hóa đơn vẫn chưa được thanh toán.


## Vì sao sự kiện đã xuất hiện nhưng không có email nào được gửi?

Nhận sự kiện và gửi email là hai bước riêng biệt. Hãy xác nhận có một tự động hóa khớp đang ở trạng thái Đang hoạt động, kiểm tra bộ lọc và lịch sử thực thi của tự động hóa đó, đồng thời kiểm tra điều kiện của người nhận và tên miền gửi. Cài đặt Đồng bộ họ và tên chỉ kiểm soát việc cập nhật tên.


## Giới hạn và khắc phục sự cố

- Brew không thể tạo giao dịch thanh toán, hoàn tiền hay sửa đổi gói đăng ký Stripe.
- Nếu sự kiện xuất hiện trong thẻ Sự kiện ở mục Quản lý nhưng không có email nào đến, hãy kiểm tra xem tự động hóa được gắn có đang ở trạng thái Đang hoạt động không, cùng bộ lọc, lịch sử thực thi, người nhận và mức độ sẵn sàng của tên miền gửi.
- Nếu lỗi chữ ký webhook kéo dài, hãy kết nối lại Stripe để khởi tạo webhook secret mới.
- Dùng sự kiện refund.created khi email cần các trường riêng về hoàn tiền; xác nhận các trường khả dụng trong lược đồ của trình kích hoạt.
- Xem lại sự đồng ý và mục đích của từng email. Việc nhập liên hệ thanh toán không có nghĩa là bạn được phép gửi email quảng cáo.

## Nguồn và hướng dẫn thiết lập

- [Xây dựng quy trình email vòng đời với Stripe](/vi/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [So sánh các tích hợp email với Stripe](/vi/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Hướng dẫn thiết lập Stripe](https://docs.brew.new/integrations/import/stripe)
- [Tạo một tự động hóa](https://docs.brew.new/create-emails/build-an-automation)
- [Thẻ cá nhân hóa](https://docs.brew.new/create-emails/merge-tags)
- [Tài liệu tham khảo sự kiện Stripe](https://docs.stripe.com/api/events/types)
- [Cài đặt email khách hàng của Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Liên quan

- [Tất cả tích hợp](https://brew.new/vi/browse/integrations.md)
- [Đăng ký](https://brew.new/vi/sign-up.md)
- Website: https://brew.new