Connector Stripe
Kết nối tài khoản Stripe của bạn với Tajo để đồng bộ chỉ đọc dữ liệu thanh toán, gồm khách hàng, khoản thanh toán, gói đăng ký và hóa đơn, vào việc phân giải liên hệ, phân khúc và các tự động hóa dựa trên doanh thu (qua Brevo và những nhà cung cấp tương tác khác).
Tổng quan
| Thuộc tính | Giá trị |
|---|---|
| Xác thực | Stripe secret key (sk_live_... / sk_test_...) hoặc restricted key |
| Quyền truy cập | Chỉ đọc, Tajo không bao giờ ghi vào tài khoản Stripe của bạn |
| Base API | https://api.stripe.com/v1 |
| Chiều đồng bộ | Stripe → Tajo |
| Webhook thời gian thực | Chưa có, hiện việc đồng bộ dựa trên polling |
Thiết lập
- Trong Stripe Dashboard, mở Developers → API keys.
- Tạo một restricted key: quyền đọc trên Customers, Charges, Subscriptions và Invoices là đủ. Restricted key được ưu tiên hơn hẳn secret key đầy đủ: Tajo chỉ đọc, nên chỉ cấp quyền đọc.
- Dán khóa vào kết nối Stripe trong Tajo.
Kết nối được kiểm chứng bằng một yêu cầu chỉ đọc trước khi bất kỳ lần đồng bộ nào bắt đầu. Bạn có thể xoay vòng hoặc thu hồi khóa trong Stripe bất cứ lúc nào.
Những gì được đồng bộ
| Dữ liệu | Tajo dùng nó để làm gì |
|---|---|
| Customers | Được phân giải thành liên hệ (email, tên, số điện thoại, địa chỉ) phục vụ định danh và phân khúc. Sự đồng ý không bao giờ được suy ra từ việc một bản ghi khách hàng tồn tại. |
| Charges | Sự kiện doanh thu cho các tự động hóa vòng đời dựa trên mua hàng và phân khúc theo LTV |
| Subscriptions | Trạng thái vòng đời (active, past_due, canceled…) cho các luồng nhắc nợ, kéo khách quay lại và giữ chân |
| Invoices | Trạng thái thanh toán cho những tin nhắn liên quan đến hóa đơn |
Phân trang dùng mô hình con trỏ của Stripe (starting_after), nên các tài khoản lớn vẫn đồng bộ trọn vẹn và có thể tiếp tục sau khi gián đoạn.
Giới hạn hiện tại
Nói thẳng để bạn có thể lên kế hoạch quanh chúng:
- Chưa có webhook thời gian thực. Thay đổi về theo lịch đồng bộ, chứ không phải ngay khoảnh khắc một giao dịch thành công. Việc tiếp nhận webhook nằm trong lộ trình.
- Chỉ đọc. Tajo không tạo hay sửa khách hàng, khoản thanh toán hay gói đăng ký trong Stripe.
- Không có Stripe App. Hiện chưa có app Tajo nào trên Stripe App Marketplace; kết nối được cấu hình trong Tajo, không phải trong Stripe Dashboard.
Xử lý sự cố
| Triệu chứng | Nguyên nhân và cách khắc phục |
|---|---|
| 401 từ Stripe | Khóa đã bị thu hồi hoặc xoay vòng, hãy dán khóa hiện tại vào kết nối |
| Khách hàng đồng bộ được nhưng charges thì không | Restricted key thiếu quyền đọc trên Charges |
| Liên hệ không có email | Khách hàng Stripe không có email sẽ đồng bộ thành bản ghi doanh thu ẩn danh; họ gia nhập đồ thị liên hệ nếu email được bổ sung sau |
Các bước tiếp theo
- Đồng bộ khách hàng: ánh xạ khách hàng Stripe vào hệ thống nguồn sự thật của bạn
- Xây dựng các tự động hóa nhắc nợ và kéo khách quay lại trong Tajo dựa trên thay đổi trạng thái gói đăng ký