Stripe Apps 集成指南

Stripe Apps 让你把自定义功能直接嵌入 Stripe Dashboard。本章是一份构建指南：它记录了面向 Tajo–Brevo 集成的这样一个 app 会如何构建、测试和发布。

Stripe Apps 是什么？

Stripe Apps 用自定义 UI 组件和后端集成扩展 Stripe Dashboard。它让第三方开发者可以：

• 在 Stripe Dashboard 的页面（客户、支付、发票等）中添加自定义视图
• 通过按范围授予的权限访问 Stripe 数据
• 在 Stripe 与 Brevo 等外部平台之间同步数据
• 在 Dashboard 内提供开通引导和配置流程

Tajo + Brevo 集成目标

Tajo 的 Stripe App 把 Stripe 与 Brevo 连接起来，实现：

• 客户洞察：把 Stripe 客户档案、支付历史和终身价值同步到 Brevo 联系人
• 事件跟踪：把 Stripe 事件（支付、订阅、退款）作为 Brevo 事务性事件推送
• 自动化营销活动：基于 Stripe 上的活动触发 Brevo 的邮件、短信和 WhatsApp 营销活动
• 忠诚度计划：用同步到 Brevo 的 Stripe 购买数据搭建留存工作流

架构概览

指南内容

本文档覆盖构建并发布一个 Stripe App 的完整生命周期：

快速上手

配置与参考

功能与集成

运营与增长

前置条件

在开始构建 Stripe App 之前，请确认你已具备：

1. Stripe 账号：已激活的 Stripe 账号（不能仅限于测试模式）
2. Stripe CLI：安装 Stripe CLI，用于本地开发和上传 app
3. Node.js：版本 16 或更高，用于 app 的 UI extension
4. Tajo 平台访问权限：有效的 Tajo 账号，且已配置 Brevo API 凭据

快速开始

# 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

核心概念

App Manifest

每个 Stripe App 都有一个 stripe-app.json manifest，用来声明权限、viewport 和配置。完整 schema 见 App Manifest 参考。

UI Extensions

Stripe Apps 可以在特定的 Dashboard viewport 中渲染基于 React 的 UI 组件。UI 工具包提供与 Stripe Dashboard 设计系统一致的预置组件。

Permissions

App 必须声明它需要访问的具体 Stripe API 资源。用户会在安装过程中批准这些权限。见 Permissions 参考。

签名密钥

每个 app 都会拿到一个 signing secret，用于校验安装签名，并保护你的后端与 Stripe 之间的通信。

开发流程

1. 定义 manifest，写明所需的权限和 viewport
2. 构建 UI extension，使用 Stripe 的 React 组件库
3. 实现 后端端点，通过 Tajo 与 Brevo 同步数据
4. 测试，在本地使用 stripe apps start
5. 上传，使用 stripe apps upload
6. 提交 审核，通过 Stripe Dashboard 完成
7. 发布，并通过数据分析持续观察

后续步骤

先从发布指南开始，弄清全部要求，然后逐一阅读技术参考，配置你的 app manifest 和权限。