发布到 Stripe App Marketplace

把你的 Stripe App 发布到应用市场后，所有 Stripe 用户都能使用它。本指南介绍发布要求、准备步骤和提交流程。

前置条件

在把应用发布到 Stripe App Marketplace 之前，必须满足以下要求：

• 已激活的 Stripe 账户：账户不能仅限测试模式
• 每个账户一个应用：每个 Stripe 账户只能向应用市场发布一个公开应用
• 仅限英文：所有应用内容、界面文案和上架信息都必须使用英文
• 完成度：应用必须功能完整并已完成测试

发布步骤

第 1 步：更新 manifest

把 stripe-app.json 中的 distribution_type 设为 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"
    }
  ]
}

第 2 步：准备应用

提交前请确认应用符合全部审核要求：

1. 在 live 和 sandbox 两种模式下充分测试
2. 确认每项权限都确有必要并已写明用途
3. 确认已实现错误处理和加载状态
4. 检查所有界面文案均为英文

第 3 步：上传应用

用 Stripe CLI 上传应用：

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

第 4 步：撰写上架信息

进入 Stripe Dashboard 填写应用的上架信息。提交到应用市场时，所有上架字段都是必填项。

第 5 步：提交审核

填完上架信息后，在 Stripe Dashboard 中提交应用审核。Stripe 团队会依据质量要求评估你的应用。

第 6 步：发布

审核通过后，你就可以发布应用，让它在应用市场上线。

面向公开分发的 manifest 配置

manifest 必须包含 distribution_type: "public"，并声明全部所需权限及清晰的用途说明：

{
  "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"
  }
}

用下面的命令上传配置好的应用：

stripe apps upload

上架信息要求

应用的上架信息必须包含以下全部字段：

名称规范

• 在应用市场中必须唯一
• 应清楚体现应用的用途
• 避免可能让用户困惑的泛化词
• 示例：“Tajo for Brevo”（15 个字符）

图标规范

• 尺寸：正好 300x300 像素
• 格式：PNG 或 SVG
• 不要加圆角，Stripe 会自动处理
• 使用清晰、易辨识的标志或符号
• 确保在小尺寸下依然可读

简介部分

写一段有说服力的描述，涵盖：

• 你的应用解决什么问题
• 核心的集成能力
• 应用面向哪类用户
• 任何前置条件或要求

示例：

Tajo for Brevo connects your Stripe payment data with Brevo’s marketing automation platform. Automatically sync customers, track payment events, and trigger personalized email, SMS, and WhatsApp campaigns based on real-time purchase behavior. Built for ecommerce businesses that want to maximize customer lifetime value through data-driven retention marketing.

（中文参考：Tajo for Brevo 把你的 Stripe 支付数据与 Brevo 的营销自动化平台连接起来。自动同步客户、跟踪支付事件，并基于实时购买行为触发个性化的邮件、短信和 WhatsApp 营销活动。专为希望通过数据驱动的留存营销最大化客户终身价值的电商企业打造。）

核心功能

每条核心功能条目包含：

• 标题：简短的功能名称
• 描述：一到两句话说明该功能
• 图片：截图或示意图（建议 1600x900 像素）

Tajo Brevo 集成推荐的功能条目：

1. 实时客户同步，自动把 Stripe 客户档案同步为 Brevo 联系人，并带上完整购买历史
2. 事件驱动的自动化，用支付成功、订阅变更、退款等 Stripe 事件触发 Brevo 工作流
3. 商品目录同步，让 Brevo 的商品目录与 Stripe 保持同步，用于营销活动内容个性化
4. 多渠道营销活动，用同步来的数据驱动定向的邮件、短信和 WhatsApp 营销活动
5. 仪表板洞察，直接在 Stripe Dashboard 的客户视图中查看 Brevo 互动数据

定价信息

清楚地传达你的定价模式：

• 免费：安装和使用均不收费
• 付费：写明价格和计费周期
• 免费增值：说明哪些功能免费、哪些需要付费
• 按用量计费：说明价格档位或单位费用

测试你的应用

提交之前请充分测试：

在 sandbox 模式下测试

# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate

测试凭据格式

向审核团队提供测试凭据时，请使用以下格式：

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

审核前自查清单

提交前请逐项确认：

• 应用在 live 和 test 两种模式下都能正常工作
• 每项权限都有清晰的用途说明
• 错误状态得到妥善处理
• 异步操作展示了加载状态
• 生产构建中没有硬编码的测试数据
• 隐私政策 URL 可访问且内容准确
• 支持联系方式有效
• 所有上架图片符合尺寸要求
• 应用描述如实反映实际功能

提交之后

Stripe 审核团队通常在 5 到 10 个工作日内回复。可能的结果有：

• 通过，应用获准发布
• 要求修改，并给出具体反馈
• 拒绝，应用不符合要求

如果收到修改要求，请处理全部反馈后重新提交。每次重新提交都会走完整的审核流程。

更新已发布的应用

更新一个已经发布的应用：

1. 在 stripe-app.json 中提升版本号
2. 上传新版本：stripe apps upload
3. 提交更新审核
4. 审核通过后，更新会自动推送给所有用户