---
title: "Hướng dẫn tích hợp Stripe Apps | Tajo"
description: "Trạng thái: dự kiến, chưa được xây dựng. Phần này là một hướng dẫn xây dựng. Tajo không có Stripe App, và hiện chưa thể cài đặt nội dung nào ở đây."
url: https://tajo.io/vi/docs/stripe-apps/
markdown: https://tajo.io/vi/docs/stripe-apps.md
lang: vi-VN
author: "Set Noa"
author_url: https://tajo.io/vi/set-noa/
robots: noindex
---

Đă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.

# Hướng dẫn tích hợp Stripe Apps

[Set Noa](https://tajo.io/vi/set-noa/)

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, chưa được xây dựng.** Tajo không có Stripe App, vì vậy hiện chưa thể cài đặt bất kỳ nội dung nào trong phần này, 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](https://tajo.io/docs/connectors/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

*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](https://tajo.io/vi/docs/stripe-apps/publish-app) | 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](https://tajo.io/vi/docs/stripe-apps/review-requirements) | 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](https://tajo.io/vi/docs/stripe-apps/app-manifest) | Schema đầy đủ cho file manifest `stripe-app.json` |
| [Tham chiếu Permissions](https://tajo.io/vi/docs/stripe-apps/permissions) | Danh sách đầy đủ các quyền Stripe API và cách yêu cầu chúng |
| [Tham chiếu Viewports](https://tajo.io/vi/docs/stripe-apps/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](https://tajo.io/vi/docs/stripe-apps/embedded-apps) | Dùng Connect embedded component cho các tích hợp nền tảng |
| [Install Links và Deep Links](https://tajo.io/vi/docs/stripe-apps/install-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](https://tajo.io/vi/docs/stripe-apps/post-install) | 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](https://tajo.io/vi/docs/stripe-apps/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ó:

1. **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)
2. **Stripe CLI**: Cài Stripe CLI để phát triển cục bộ và tải app lên
3. **Node.js**: Phiên bản 16 trở lên cho UI extension của app
4. **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

```bash
# 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](https://tajo.io/vi/docs/stripe-apps/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](https://tajo.io/vi/docs/stripe-apps/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

1. **Định nghĩa** manifest với các quyền và viewport cần thiết
2. **Xây dựng** UI extension bằ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ử** cục bộ bằng `stripe apps start`
5. **Tải lên** bằng `stripe apps upload`
6. **Gửi** đi xét duyệt thông qua Stripe Dashboard
7. **Xuất bản** và theo dõi qua analytics

Caution

Stripe yêu cầu app phải được viết bằng tiếng Anh để phân phối trên marketplace. Trang giới thiệu app, văn bản UI và tài liệu của bạn đều phải bằng tiếng Anh.

## Các bước tiếp theo

Hãy bắt đầu với [Hướng dẫn xuất bản](https://tajo.io/vi/docs/stripe-apps/publish-app) để nắm đầy đủ các yêu cầu, sau đó đi qua những tài liệu tham chiếu kỹ thuật để cấu hình app manifest và quyền.