Xuất Bản lên Stripe App Marketplace

Xuất bản Stripe App của bạn lên marketplace giúp tất cả người dùng Stripe có thể sử dụng nó. Hướng dẫn này bao gồm các yêu cầu, bước chuẩn bị và quy trình gửi.

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

Trước khi có thể xuất bản app lên Stripe App Marketplace, bạn phải đáp ứng các yêu cầu sau:

• Tài khoản Stripe đã kích hoạt: Tài khoản của bạn không thể bị giới hạn chỉ ở chế độ test
• Một app mỗi tài khoản: Mỗi tài khoản Stripe chỉ có thể xuất bản một app công khai lên marketplace
• Chỉ tiếng Anh: Tất cả nội dung app, văn bản UI và thông tin listing phải bằng tiếng Anh
• App hoàn chỉnh: App của bạn phải hoàn toàn chức năng và đã được kiểm thử

Các Bước Xuất Bản

Bước 1: Cập Nhật Manifest

Đặt distribution_type trong stripe-app.json thành public:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}

Bước 2: Chuẩn Bị App

Đảm bảo app của bạn đáp ứng tất cả yêu cầu đánh giá trước khi gửi:

1. Kiểm thử kỹ lưỡng trong cả chế độ live và sandbox
2. Xác minh tất cả các quyền đều cần thiết và được ghi lại
3. Xác nhận việc xử lý lỗi và trạng thái loading đã được triển khai
4. Kiểm tra tất cả văn bản UI đều bằng tiếng Anh

Bước 3: Upload App

Sử dụng Stripe CLI để upload app:

# Upload app lên Stripe
stripe apps upload

# Xác minh upload
stripe apps versions list

Bước 4: Viết Listing

Điều hướng đến Stripe Dashboard để hoàn thành listing app của bạn. Tất cả các trường listing đều bắt buộc để gửi marketplace.

Bước 5: Gửi Để Xem Xét

Sau khi hoàn thành listing, gửi app để xem xét thông qua Stripe Dashboard. Nhóm Stripe sẽ đánh giá app của bạn dựa trên yêu cầu chất lượng.

Bước 6: Xuất Bản

Sau khi được phê duyệt, bạn có thể xuất bản app để nó có sẵn trên marketplace.

Thiết Lập Manifest Cho Phân Phối Công Khai

Manifest phải bao gồm distribution_type: "public" và khai báo tất cả các quyền cần thiết với mô tả mục đích rõ ràng:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

Upload app đã cấu hình với:

stripe apps upload

Yêu Cầu Listing

Listing app của bạn phải bao gồm tất cả các trường sau:

Hướng Dẫn Tên

• Phải là duy nhất trên marketplace
• Nên xác định rõ mục đích của app
• Tránh các thuật ngữ chung chung có thể gây nhầm lẫn
• Ví dụ: “Tajo for Brevo” (15 ký tự)

Hướng Dẫn Icon

• Kích thước: chính xác 300x300 pixels
• Định dạng: PNG hoặc SVG
• Không bo góc, Stripe tự động áp dụng
• Sử dụng logo hoặc biểu tượng rõ ràng, dễ nhận biết
• Đảm bảo dễ đọc ở kích thước nhỏ

Phần Giới Thiệu

Viết mô tả hấp dẫn bao gồm:

• App giải quyết vấn đề gì
• Khả năng tích hợp chính
• App được thiết kế cho ai
• Bất kỳ điều kiện tiên quyết hoặc yêu cầu nào

Ví dụ:

Tajo for Brevo kết nối dữ liệu thanh toán Stripe của bạn với nền tảng tự động hóa marketing của Brevo. Tự động đồng bộ khách hàng, theo dõi sự kiện thanh toán và kích hoạt các chiến dịch email, SMS và WhatsApp cá nhân hóa dựa trên hành vi mua hàng thời gian thực. Được xây dựng cho các doanh nghiệp thương mại điện tử muốn tối đa hóa customer lifetime value thông qua marketing giữ chân dựa trên dữ liệu.

Tính Năng Chính

Mỗi mục tính năng chính bao gồm:

• Tiêu đề: Tên tính năng ngắn gọn
• Mô tả: Một đến hai câu giải thích tính năng
• Hình ảnh: Ảnh chụp màn hình hoặc sơ đồ (khuyến nghị 1600x900 pixels)

Các tính năng được khuyến nghị cho tích hợp Tajo Brevo:

1. Real-time Customer Sync, Tự động đồng bộ hồ sơ khách hàng Stripe sang contacts Brevo với toàn bộ lịch sử mua hàng
2. Event-Driven Automation, Kích hoạt quy trình Brevo từ các sự kiện Stripe như thanh toán thành công, thay đổi đăng ký và hoàn tiền
3. Product Catalog Sync, Giữ danh mục sản phẩm Brevo đồng bộ với Stripe để nội dung chiến dịch cá nhân hóa
4. Multi-Channel Campaigns, Sử dụng dữ liệu đồng bộ để thúc đẩy các chiến dịch email, SMS và WhatsApp có mục tiêu
5. Dashboard Insights, Xem số liệu mức độ tương tác Brevo trực tiếp trong chế độ xem khách hàng Stripe Dashboard

Kiểm Thử App

Trước khi gửi, hãy kiểm thử kỹ lưỡng app:

Kiểm Thử Trong Sandbox Mode

# Khởi động app ở chế độ test
stripe apps start --mode test

# Xác minh tương thích sandbox
stripe apps validate

Định Dạng Thông Tin Đăng Nhập Test

Khi cung cấp thông tin đăng nhập test cho nhóm đánh giá, hãy sử dụng định dạng này:

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo

Danh Sách Kiểm Tra Đánh Giá

Trước khi gửi, xác minh:

• App hoạt động trong cả chế độ live và test
• Tất cả các quyền đều có mô tả mục đích rõ ràng
• Các trạng thái lỗi được xử lý nhẹ nhàng
• Trạng thái loading được hiển thị cho các hoạt động bất đồng bộ
• Không có dữ liệu test hardcoded trong bản build production
• URL chính sách bảo mật có thể truy cập và chính xác
• Thông tin liên hệ hỗ trợ hợp lệ
• Tất cả hình ảnh listing đáp ứng yêu cầu kích thước
• Mô tả app phản ánh chính xác chức năng

Sau Khi Gửi

Nhóm đánh giá Stripe thường phản hồi trong vòng 5-10 ngày làm việc. Họ có thể:

• Phê duyệt app của bạn để xuất bản
• Yêu cầu thay đổi với phản hồi cụ thể
• Từ chối app nếu không đáp ứng yêu cầu

Nếu yêu cầu thay đổi, hãy giải quyết tất cả phản hồi và gửi lại. Mỗi lần gửi lại đều trải qua toàn bộ chu kỳ đánh giá.

Cập Nhật App Đã Xuất Bản

Để cập nhật app đã xuất bản:

1. Tăng phiên bản trong stripe-app.json
2. Upload phiên bản mới: stripe apps upload
3. Gửi bản cập nhật để xem xét
4. Sau khi được phê duyệt, bản cập nhật tự động được triển khai đến tất cả người dùng