Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

Trên trang này

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. Phần này là một hướng dẫn xây dựng: nó mô tả một app như vậy cho tích hợp Tajo–Brevo sẽ được xây dựng, kiểm thử và xuất bản ra sao.

Caution

Trạng thái: dự kiến. Hiện chưa có app Tajo nào trên Stripe App Marketplace, và các định danh app, URL cùng thông tin xác thực trong những trang này chỉ là ví dụ minh họa, không phải endpoint đang hoạt động. Để kết nối Stripe với Tajo ngay lúc này, hãy dùng connector Stripe (restricted API key, đồng bộ chỉ đọc).

Tip

Mục tiêu là xuất bản một tích hợp Brevo trên Stripe App Marketplace, cho phép merchant dùng Stripe đồng bộ dữ liệu khách hàng, đơn hàng và sự kiện trực tiếp vào Brevo để tự động hóa marketing và CRM.

Stripe Apps là gì?

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

Thêm các view tùy chỉnh vào những trang của 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 ngay 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 để mang lại:

Thông tin khách hàng: Đồng bộ hồ sơ khách hàng Stripe, lịch sử thanh toán và giá trị trọn đời vào danh bạ Brevo
Theo dõi sự kiện: Đẩy sự kiện Stripe (thanh toán, gói đăng ký, hoàn tiền) thành sự kiện giao dịch của Brevo
Chiến dịch tự động: Kích hoạt chiến dịch email, SMS và WhatsApp của Brevo dựa trên hoạt động trên Stripe
Chương trình khách hàng thân thiết: Xây dựng quy trình giữ chân khách bằng dữ liệu mua hàng Stripe đã đồng bộ sang Brevo

Tổng quan kiến trúc

Stripe Dashboard

UI của Stripe App

Xem khách hàng
Chi tiết thanh toán
Cài đặt app
Tajo

lớp trung gian

Đồng bộ dữ liệu
Định tuyến sự kiện
Xử lý webhook
Brevo

CRM + email

Danh bạ
Chiến dịch
Tự động hóa

Dữ liệu của một Stripe app đi về đâu Stripe Dashboard và Tajo trao đổi dữ liệu khách hàng và thanh toán, còn Tajo đồng bộ danh bạ, chiến dịch và tự động hóa với Brevo.

Nội dung hướng dẫn

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

Bắt đầu

Hướng dẫn	Mô tả
Xuất bản lên Marketplace	Yêu cầu và các bước gửi app đi xét duyệt
Yêu cầu xét duyệt app	Tiêu chuẩn chất lượng, bảo mật và UX để được phê duyệt

Cấu hình và tham chiếu

Hướng dẫn	Mô tả
Tham chiếu App Manifest	Schema đầy đủ cho file manifest `stripe-app.json`
Tham chiếu Permissions	Danh sách đầy đủ các quyền Stripe API và cách yêu cầu chúng
Tham chiếu Viewports	Những vị trí trên Dashboard nơi UI của app có thể xuất hiện

Tính năng và tích hợp

Hướng dẫn	Mô tả
Embedded Stripe Apps	Dùng Connect embedded component cho các tích hợp nền tảng
Install Links và Deep Links	Tạo URL cài đặt và deep link tới từng view cụ thể của app
Hành động sau cài đặt	Cấu hình luồng onboarding sau khi app được cài

Vận hành và tăng trưởng

Hướng dẫn	Mô tả
App Analytics	Theo dõi lượt cài đặt, lượt xem và chỉ số chuyển đổi

Điều kiện tiên quyết

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

Tài khoản Stripe: Một tài khoản Stripe đã kích hoạt (không bị giới hạn ở chế độ test)
Stripe CLI: Cài Stripe CLI để phát triển cục bộ và tải app lên
Node.js: Phiên bản 16 trở lên cho UI extension của app
Quyền truy cập nền tảng Tajo: Tài khoản Tajo đang hoạt động, đã cấu hình thông tin xác thực Brevo API

Bắt đầu nhanh

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Các khái niệm chính

App Manifest

Mỗi Stripe App có một file manifest stripe-app.json khai báo quyền, viewport 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 những viewport cụ thể của Dashboard. Bộ công cụ UI cung cấp sẵn các thành phần khớp với hệ thống thiết kế của Stripe Dashboard.

Permissions

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

Signing Secret

Mỗi app nhận được một signing secret để xác minh chữ ký cài đặt và bảo mật liên lạc giữa backend của bạn với Stripe.

Quy trình phát triển

Định nghĩa manifest với các quyền và viewport cần thiết
Xây dựng UI extension bằng thư viện React component của Stripe
Triển khai các endpoint backend để đồng bộ dữ liệu với Brevo qua Tajo
Kiểm thử cục bộ bằng stripe apps start
Tải lên bằng stripe apps upload
Gửi đi xét duyệt thông qua Stripe Dashboard
Xuất bản và theo dõi qua analytics