Open SaaS 项目中 Stripe 支付集成配置指南

在 Open SaaS 项目中集成 Stripe 支付功能时，许多开发者会遇到配置错误的问题。本文将详细介绍正确的 Stripe 产品与价格 ID 配置方法，帮助开发者避免常见陷阱。

Stripe 产品与价格 ID 的区别

Stripe 平台会为每个产品生成两种不同类型的标识符：

• 产品 ID (prod_xxx)：代表产品本身的唯一标识
• 价格 ID (price_yyy)：代表该产品具体定价方案

开发者经常混淆这两种 ID，导致集成失败。实际上，在 Open SaaS 项目中，我们需要使用的是价格 ID 而非产品 ID。

正确获取价格 ID 的步骤

1. 登录 Stripe 测试环境仪表盘
2. 导航至产品管理页面
3. 创建或选择目标产品
4. 在产品详情页中找到"定价"部分
5. 点击对应定价方案右侧的"..."菜单
6. 选择"复制价格 ID"选项

环境变量配置示例

在 Open SaaS 项目中，正确的 Stripe 配置应使用价格 ID 而非产品 ID：

STRIPE_HOBBY_SUBSCRIPTION_PRICE_ID=price_1Oa2b...
STRIPE_PRO_SUBSCRIPTION_PRICE_ID=price_1Oa2c...
STRIPE_CREDITS_PRICE_ID=price_1Oa2d...

常见错误排查

当出现"No such price"错误时，请检查：

1. 是否错误使用了产品 ID 而非价格 ID
2. 价格 ID 是否完整复制，没有遗漏字符
3. 该价格 ID 是否存在于正确的 Stripe 环境（测试/生产）
4. 价格方案是否处于激活状态

最佳实践建议

1. 在 Stripe 测试环境中先行验证配置
2. 为不同环境（开发/测试/生产）使用独立的 Stripe 账户
3. 定期检查价格 ID 是否有效，特别是产品更新后
4. 在代码中添加错误处理逻辑，捕获并记录 Stripe API 返回的详细错误信息

通过遵循以上指南，开发者可以顺利完成 Open SaaS 项目与 Stripe 的支付集成，避免常见的配置错误。