Hướng Dẫn Tích Hợp Stripe Apps

Stripe Apps cho phép bạn nhúng chức năng tùy chỉnh trực tiếp vào Stripe Dashboard, cung cấp cho merchants quyền truy cập vào tích hợp Brevo của Tajo mà không cần rời khỏi quy trình thanh toán. Hướng dẫn này bao gồm mọi thứ bạn cần để xây dựng, kiểm thử và xuất bản Stripe App kết nối Stripe với Brevo thông qua Tajo.

Stripe Apps Là Gì?

Stripe Apps mở rộng Stripe Dashboard với các thành phần UI tùy chỉnh và tích hợp backend. Chúng cho phép các nhà phát triển bên thứ ba:

• Thêm các view tùy chỉnh vào các trang Stripe Dashboard (khách hàng, thanh toán, hóa đơn, v.v.)
• Truy cập dữ liệu Stripe thông qua các quyền được phân phạm vi
• Đồng bộ dữ liệu giữa Stripe và các nền tảng bên ngoài như Brevo
• Cung cấp luồng onboarding và cấu hình trong Dashboard

Mục Tiêu Tích Hợp Tajo + Brevo

Stripe App của Tajo kết nối Stripe với Brevo để cung cấp:

• Customer Intelligence: Đồng bộ hồ sơ khách hàng Stripe, lịch sử thanh toán và giá trị trọn đời vào contacts Brevo
• Event Tracking: Đẩy sự kiện Stripe (thanh toán, đăng ký, hoàn tiền) dưới dạng sự kiện giao dịch Brevo
• Automated Campaigns: Kích hoạt các chiến dịch email, SMS và WhatsApp của Brevo dựa trên hoạt động Stripe
• Loyalty Programs: Xây dựng quy trình giữ chân khách hàng sử dụng dữ liệu mua hàng Stripe được đồng bộ với Brevo

Tổng Quan Kiến Trúc

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe Dashboard │────▶│   Tajo Platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (Middleware)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Customer views          Data sync &              Contacts,
   Payment details         Event routing            Campaigns,
   App settings            Webhook handling         Automations

Nội Dung Hướng Dẫn

Tài liệu này bao gồm toàn bộ vòng đời xây dựng và xuất bản Stripe App:

Bắt Đầu

Cấu Hình & Tham Chiếu

Tính Năng & Tích Hợp

Vận Hành & Tăng Trưởng

Điều Kiện Tiên Quyết

Trước khi xây dựng Stripe App, hãy đảm bảo bạn có:

1. Tài Khoản Stripe: Tài khoản Stripe đã kích hoạt (không bị giới hạn chỉ ở chế độ test)
2. Stripe CLI: Cài đặt Stripe CLI để phát triển local và upload app
3. Node.js: Phiên bản 16 trở lên cho UI extension của app
4. Quyền Truy Cập Tajo Platform: Tài khoản Tajo hoạt động với thông tin đăng nhập Brevo API đã được cấu hình

Bắt Đầu Nhanh

# Cài đặt Stripe CLI
brew install stripe/stripe-cli/stripe

# Đăng nhập vào tài khoản Stripe của bạn
stripe login

# Tạo dự án Stripe App mới
stripe apps create tajo-brevo-integration

# Bắt đầu phát triển local
stripe apps start

Các Khái Niệm Chính

App Manifest

Mỗi Stripe App có file manifest stripe-app.json khai báo quyền, viewports và cấu hình. Xem Tham Chiếu App Manifest để biết schema đầy đủ.

UI Extensions

Stripe Apps có thể render các thành phần UI dựa trên React trong các viewport Dashboard cụ thể. Bộ công cụ UI cung cấp các thành phần dựng sẵn phù hợp với hệ thống thiết kế Stripe Dashboard.

Permissions

Apps phải khai báo các tài nguyên Stripe API cụ thể mà chúng cần quyền truy cập. Người dùng phê duyệt các quyền này trong quá trình cài đặt. Xem Tham Chiếu Permissions.

Signing Secret

Mỗi app nhận được một signing secret để xác minh install signatures và bảo mật giao tiếp giữa backend của bạn và Stripe.

Quy Trình Phát Triển

1. Định Nghĩa manifest với các quyền và viewports cần thiết
2. Xây Dựng UI extension sử dụng thư viện React component của Stripe
3. Triển Khai các endpoint backend để đồng bộ dữ liệu với Brevo qua Tajo
4. Kiểm Thử locally bằng stripe apps start
5. Upload với stripe apps upload
6. Gửi để xem xét thông qua Stripe Dashboard
7. Xuất Bản và theo dõi qua analytics

Các Bước Tiếp Theo

Bắt đầu với Hướng Dẫn Xuất Bản để hiểu đầy đủ các yêu cầu, sau đó làm việc qua các tham chiếu kỹ thuật để cấu hình app manifest và permissions.