让 stripe 订阅与后端服务配合使用可能会很棘手，并且常常会导致开发人员所谓的可怕的“大脑分裂”——同步管理 stripe 的逻辑和您自己的后端数据。

在 vratix，我们在构建开源 stripe 订阅 api 模块时正面解决了这个问题。以下是我们如何在 node.js 中处理 stripe 订阅计费，以保持事情简单、可扩展且对开发人员友好。

核心原则：让 stripe 成为真理之源

关键是将尽可能多的逻辑转移到stripe，同时保持数据库最小化。我们只存储：

• 客户 id
• 订阅id
• 计划

这样，我们就可以避免：

• 过于复杂的后端逻辑
• 用于同步仪表板更改的容易出错的 webhook 实现
• 数据冗余

通过这种方法，您仍然拥有功能齐全的订阅计费系统，同时依赖 stripe 作为唯一的事实来源。

我们实施的特点

在本指南结束时，您将拥有一个基于订阅的应用程序，支持：

• 用户订阅计划
• 结帐会议
• 订阅追加销售
• 可用计划列表

技术堆栈

• postgresql
• node.js express.js
• 打字稿

第1步：数据库设计

我们首先设计一个干净、最小的数据库表：

create table user_subscriptions (  
    "id" serial primary key,  
    "plan" varchar not null,  
    "user_id" integer not null references users(id) on delete cascade,  
    "customer_id" varchar,  
    "subscription_id" varchar not null,  
    "is_owner" boolean not null default true,  
    "created_at" timestamp not null default now(),  
    unique (user_id, subscription_id)  
);

要点：

• user_id：引用您的内部用户表
• plan：跟踪订阅计划
• subscription_id：stripe 订阅 id
• is_owner：标记主要订阅持有者

第 2 步：控制器

我们使用工厂函数来保持业务逻辑模块化和可测试。以下是我们的 stripe 订阅控制器的片段：

Digital IP Agent

将公开的创作者、博主、播客主持人、YouTuber 或 X/Twitter 账号人物转化为可部署的 OpenClaw 代理。当用户提供 YouTube 链接、X（推特）链接等时使用。

下载

async getsubscriptions() {  
  const stripeprices = await stripe.prices.list({  
    active: true,  
    type: "recurring",  
    expand: ["data.product"],  
  });  

  return stripeprices.data.map((price) => {  
    const product = price.product as stripe.product;  
    return {  
      plan: price.lookup_key || product.name.tolowercase().replaceall(" ", "_"),  
      name: product.name,  
      priceid: price.id,  
      interval: price.recurring!.interval,  
      price: { currency: price.currency, amount: price.unit_amount },  
    };  
  });  
}  

主要亮点：

• 自定义订阅密钥：源自产品名称或用于清理计划检查的lookup_key（user.plan === 'pro_plan'）。
• stripe-first 方法：我们直接从 stripe 获取订阅数据，避免了“脑裂”。

第 3 步：简化 stripe 结账

我们的 createcheckout 函数设置订阅结账会话：

const checkout = await stripe.checkout.sessions.create({  
  line_items: [  
    {  
      price: priceid,  
      adjustable_quantity: { enabled: true },  
      quantity: seats || 1,  
    },  
  ],  
  mode: "subscription",  
  subscription_data: { metadata: { userid } },  
  success_url: checkout_success_url,  
  cancel_url: checkout_cancel_url,  
});  

return { url: checkout.url! };  

想跳过这一切吗？

我们已将所有内容打包到一个现成的开源模块中。 不到 30 秒，您可以设置：

• 条纹集成
• 身份验证
• 数据库配置
• 预建路由和 sql 查询

运行这个：

npx vratix init  

查看我们的 stripe 订阅模块文档以了解更多详细信息。

完整代码可在我们的 github 存储库中获取。

在此处观看演示视频，了解如何使用工作 ui 完成所有这些操作。

我很想听听您的想法 - 这是否会让构建订阅 api 变得更容易？让我们知道您接下来想看到哪些功能！