LogoLaunchSaaS

支付

在 LaunchSaaS 中集成 Stripe 或 Creem 支付。处理一次性购买、订阅、Webhook 和客户账单，统一 API 接口。

支付

LaunchSaaS 支持多个支付提供商，具有统一、可扩展的架构。你可以轻松切换提供商、添加自定义实现或完全禁用支付功能。

支持的提供商

  • Stripe - 行业标准的支付处理器
  • Creem - 替代支付提供商
  • Custom - 使用你自己的支付提供商扩展

架构概览

支付系统包含：

  • Order（订单） - 代表已确认的货币交易（已支付/不可逆）
  • Entitlement（权益） - 代表用户对产品的访问权限
  • Payment Hooks（支付钩子） - 用于支付后操作的可扩展钩子
  • Provider Factory（提供商工厂） - 管理支付提供商实例

配置

启用支付提供商

在 src/configuration/features.ts 中配置你的支付提供商：

export const features: Features = {
  payment: {
    provider: "stripe", // "stripe" | "creem" | "disabled"
    hooks: {
      github: true, // 启用 GitHub 集成
      email: true, // 启用支付完成邮件
    },
  },
  // ... 其他功能
};

设置 Stripe

1. 创建 Stripe 账户

  1. 在 stripe.com 注册
  2. 完成账户验证（生产环境需要）
  3. 你可以立即在测试模式下开始开发

2. 获取 API 密钥

  1. 前往 Stripe Dashboard → Developers → API keys
  2. 复制你的密钥（测试模式下以 sk_test_ 开头）
  3. 添加到你的 .env 文件：
STRIPE_SECRET_KEY="sk_test_..."

开发环境使用测试密钥（sk_test_...），生产环境使用实时密钥（sk_live_...）。

3. 创建产品和价格

  1. 前往 Stripe Dashboard → Product Catalog
  2. 点击 Add product
  3. 填写产品详情：
    • 名称：例如"终身访问"
    • 描述：你的产品描述
    • 价格：设置价格（一次性或定期）
  4. 点击 "Save product"
  5. 复制 Price ID（以 price_ 开头）

4. 配置产品

在 src/configuration/product.ts 中更新产品配置：

const prod: ProviderProductConfiguration = {
  stripe: {
    onetime: [
      {
        id: "price_1SWtddRwnUQyjRPerb8ge9xD",
        name: "终身访问",
        hooks: ["github-integration", "payment-completed-email"],
      },
    ],
    subscription: [
      {
        id: "price_1SOwEE2Kn68A5jDtD9vcpirC",
        name: "专业版月付",
        hooks: ["payment-completed-email"],
      },
    ],
    pricingPageProduct: {
      type: "onetime",
      id: "price_1SWtddRwnUQyjRPerb8ge9xD",
    },
  },
};

5. 设置 Webhooks

Webhooks 实时通知你的应用程序支付事件。

开发环境（本地测试）

使用 Stripe CLI 将 webhooks 转发到本地服务器：

  1. 安装 Stripe CLI：
# macOS
brew install stripe/stripe-cli/stripe

# 其他平台：https://stripe.com/docs/stripe-cli
  1. 登录 Stripe：
stripe login
  1. 转发 webhooks：
stripe listen --forward-to localhost:3000/api/payment/stripe/webhook
  1. 复制 webhook secret（以 whsec_ 开头）并添加到你的 .env 文件：
STRIPE_WEBHOOK_SECRET="whsec_..."
在开发时保持 stripe listen 命令运行。

生产环境

  1. 前往 Stripe Dashboard → Developers → Webhooks
  2. 点击 Add endpoint
  3. 设置端点 URL：https://yourdomain.com/api/payment/stripe/webhook
  4. 选择要监听的事件：
    • checkout.session.completed
    • customer.subscription.created
    • customer.subscription.updated
    • customer.subscription.deleted
    • invoice.payment_succeeded
    • invoice.payment_failed
  5. 点击 Add endpoint
  6. 复制 Signing secret 并添加到生产环境

测试卡

用于测试 Stripe 集成的测试信用卡：

卡号描述
4242 4242 4242 4242成功支付
4000 0000 0000 3220需要 3D 验证
4000 0000 0000 9995余额不足

使用任何未来的过期日期和任何 3 位 CVC。

设置 Creem

1. 创建 Creem 账户

  1. 在 creem.io 注册
  2. 完成账户验证
  3. 创建你的产品

2. 获取 API 密钥

  1. 前往 Creem Dashboard → Settings → API Keys
  2. 复制你的 API key 和 webhook secret
  3. 添加到你的 .env 文件：
CREEM_API_KEY="your-api-key"
CREEM_WEBHOOK_SECRET="your-webhook-secret"

3. 配置产品

在 src/configuration/product.ts 中更新产品配置：

const prod: ProviderProductConfiguration = {
  creem: {
    onetime: [
      {
        id: "prod_3h218lKmpAIM9xTv97Mdy7",
        name: "终身访问",
        hooks: ["github-integration", "payment-completed-email"],
      },
    ],
    pricingPageProduct: {
      type: "onetime",
      id: "prod_3h218lKmpAIM9xTv97Mdy7",
    },
  },
};

4. 设置 Webhooks

在 Creem Dashboard 中配置 webhook 端点：

  • URL: https://yourdomain.com/api/payment/creem/webhook
  • Events: 所有支付相关事件

如果你正在设置环境，现在可以返回环境设置指南继续。

支付钩子

LaunchSaaS 提供可扩展的钩子系统用于支付后操作。钩子在 src/configuration/features.ts 中配置。

内置钩子

GitHub 集成

支付后自动将客户添加为 GitHub 协作者。

在 features.ts 中启用：

payment: {
  hooks: {
    github: true,
  },
}

配置环境变量：

GITHUB_TOKEN="your-personal-access-token"
GITHUB_REPO="owner/repo"

在 GitHub Settings 生成具有 admin:org 和 repo 权限的 GitHub Personal Access Token

支付完成邮件

成功支付后发送确认邮件。

在 features.ts 中启用：

payment: {
  hooks: {
    email: true,
  },
}

自定义钩子

通过在 src/lib/payment/hooks/ 中实现 PaymentHook 接口来创建自定义支付钩子：

import { PaymentHook, AfterHookContext } from "@/lib/payment/hook";

export class CustomHook implements PaymentHook {
  name = "custom-hook";

  async onCheckoutComplete(context: AfterHookContext): Promise<void> {
    // 你的自定义逻辑
    console.log(`产品 ${context.productId} 的支付已完成`);
  }
}

在 src/lib/payment/hook-register.ts 中注册你的钩子：

if (features.payment.hooks.custom) {
  hooks.push(new CustomHook());
}

数据库架构

Order 表

代表已确认的货币交易：

  • 支付确认时创建
  • 一次性产品在结账完成时创建订单
  • 订阅产品在每次成功支付时创建订单

Entitlement 表

代表用户对产品的访问权限：

  • 订单支付时授予/延长
  • 一次性产品创建状态为 "active" 的权益
  • 订阅产品创建状态为 "pending" 的权益，首次支付后变为 "active"
  • 包含订阅的周期信息

自定义支付提供商

要添加自定义支付提供商：

  1. 在 src/lib/payment/providers/ 中实现 PaymentProvider 接口
  2. 在 src/lib/payment/factory.ts 中注册
  3. 添加到 src/schemas/site-configuration.ts 中的 Features 类型

示例：

export class CustomProvider implements PaymentProvider {
  readonly name = "custom";

  async createCheckout(options: CheckoutOptions): Promise<CheckoutResult> {
    // 实现结账创建
  }

  async handleWebhook(request: Request): Promise<Response> {
    // 实现 webhook 处理
  }

  // ... 其他必需方法
}

参考资料

下一步

功能配置

了解功能配置

部署

部署到生产环境

自定义

自定义你的站点

身份验证

在 LaunchSaaS 中配置 Better Auth，支持社交登录（Google、GitHub）、魔术链接、角色权限控制和安全会话管理。

电子邮件

配置邮件提供商用于事务性邮件

On this page

支付支持的提供商架构概览配置启用支付提供商设置 Stripe1. 创建 Stripe 账户2. 获取 API 密钥3. 创建产品和价格4. 配置产品5. 设置 Webhooks开发环境（本地测试）生产环境测试卡设置 Creem1. 创建 Creem 账户2. 获取 API 密钥3. 配置产品4. 设置 Webhooks支付钩子内置钩子GitHub 集成支付完成邮件自定义钩子数据库架构Order 表Entitlement 表自定义支付提供商参考资料下一步