讓 Stripe 訂閱與后端服務配合使用可能會很棘手，并且常常會導致開發(fā)人員所說的可怕的“大腦分裂”——同步管理 Stripe 的邏輯和您自己的后端數(shù)據(jù)。

在 Vratix，我們在構建開源 Stripe 訂閱 API 模塊時正面解決了這個問題。以下是我們如何在 Node.js 中處理 Stripe 訂閱計費，以保持事情簡單、可擴展且對開發(fā)人員友好。

核心原則：讓 Stripe 成為真理之源

關鍵是將盡可能多的邏輯轉移到Stripe，同時保持數(shù)據(jù)庫最小化。我們只存儲：

• 客戶 ID
• 訂閱ID
• 計劃

這樣，我們就可以避免：

• 過于復雜的后端邏輯
• 用于同步儀表板更改的容易出錯的 Webhook 實現(xiàn)
• 數(shù)據(jù)冗余

通過這種方法，您仍然擁有功能齊全的訂閱計費系統(tǒng)，同時依賴 Stripe 作為唯一的事實來源。

我們實施的特點

在本指南結束時，您將擁有一個基于訂閱的應用程序，支持：

• 用戶訂閱計劃
• 結帳會議
• 訂閱追加銷售
• 可用計劃列表

技術堆棧

• PostgreSQL
• Node.js Express.js
• 打字稿

第 1 步：數(shù)據(jù)庫設計

我們首先設計一個干凈、最小的數(shù)據(jù)庫表：

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 步：控制器

我們使用工廠函數(shù)來保持業(yè)務邏輯模塊化和可測試。這是我們的 Stripe 訂閱控制器的片段：

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 },  
    };  
  });  
}  

主要亮點：

• 自定義訂閱密鑰：源自產(chǎn)品名稱或用于清理計劃檢查的lookup_key（user.plan === 'pro_plan'）。
• Stripe-first 方法：我們直接從 Stripe 獲取訂閱數(shù)據(jù)，避免了“腦裂”。

第 3 步：簡化 Stripe 結賬

我們的 createCheckout 函數(shù)設置訂閱結賬會話：

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! };  

想跳過這一切嗎？

我們已將所有內容打包到一個現(xiàn)成的開源模塊中。 不到 30 秒，您可以設置：

• 條紋集成
• 身份驗證
• 數(shù)據(jù)庫配置
• 預建路由和 SQL 查詢

運行這個：

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)  
);

查看我們的 Stripe 訂閱模塊文檔以了解更多詳細信息。

完整代碼可在我們的 GitHub 存儲庫中獲取。

在此處觀看演示視頻，了解如何使用工作 UI 完成所有這些操作。

我很想聽聽您的想法 - 這是否會讓構建訂閱 API 變得更容易？讓我們知道您接下來想看到哪些功能！

以上是Node.js 中的 Stripe 訂閱集成 [終極指南]的詳細內容。更多信息請關注PHP中文網(wǎng)其他相關文章！