Stripe 集成

🚀 Stripe 设置

按照以下步骤将 Stripe 与 NEXTDEVKIT 集成：

1. 创建 Stripe 账户

在 stripe.com 创建 Stripe 账户
转到 Stripe 仪表板

2. 获取 API 密钥

转到 开发者 → API 密钥
复制您的密钥（测试模式以 sk_test_ 开头）

添加到您的 .env 文件：

STRIPE_SECRET_KEY="sk_test_your_secret_key"

3. 设置 Webhooks

转到 开发者 → Webhooks
点击 "添加端点"
输入您的 webhook URL：https://your-domain.com/api/webhooks/stripe
选择这些事件：
- checkout.session.completed
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.deleted
复制 Webhook 签名密钥（以 whsec_ 开头）

添加到您的 .env 文件：

STRIPE_WEBHOOK_SECRET="whsec_your_webhook_secret"

4. 创建产品和价格

专业版订阅产品

转到产品 → 添加产品
名称："专业版计划"
添加 月付价格：
- 价格：您的月付价格
- 计费周期：月付
- 重复：是
- 复制 价格 ID（以 price_ 开头）
添加 年付价格：
- 价格：您的年付价格
- 计费周期：年付
- 重复：是
- 复制 价格 ID（以 price_ 开头）

终身产品

转到产品 → 添加产品
名称："终身计划"
添加 一次性价格：
- 价格：您的终身价格
- 计费周期：一次性
- 重复：否
- 复制 价格 ID（以 price_ 开头）

5. 配置环境变量

# Stripe 配置
STRIPE_SECRET_KEY="sk_test_your_secret_key" 
STRIPE_WEBHOOK_SECRET="whsec_your_webhook_secret"

# 价格 ID
NEXT_PUBLIC_PRICE_ID_PRO_MONTHLY="price_your_monthly_price_id"
NEXT_PUBLIC_PRICE_ID_PRO_YEARLY="price_your_yearly_price_id"
NEXT_PUBLIC_PRICE_ID_LIFETIME="price_your_lifetime_price_id"

6. 更新支付提供商配置

在 src/config/index.ts 中，将提供商设置为 Stripe：

payment: {
  provider: "stripe",
  currency: "USD",
  // ... 配置的其余部分
  plans: {
    pro: {
      prices: [
					{
						amount: 9.99, // 您的月付价格
						interval: PlanInterval.MONTH,
						trialPeriodDays: 7, // 您的试用期天数
					},
					{
						amount: 99, // 您的年付价格
						interval: PlanInterval.YEAR,
						trialPeriodDays: 30, // 您的试用期天数
					},
      ],
    },
  },
}

🧪 使用 Stripe 测试

测试信用卡

使用这些测试卡与 Stripe：

卡号	描述
`4242 4242 4242 4242`	成功支付
`4000 0000 0000 3220`	3D 安全认证
`4000 0000 0000 9995`	余额不足
`4000 0000 0000 0069`	卡已过期

本地开发

# 安装 Stripe CLI
brew install stripe/stripe-cli/stripe

# 登录 Stripe
stripe login

# 转发事件到本地服务器
stripe listen --forward-to localhost:3000/api/webhooks/stripe

# 测试 webhooks
stripe trigger checkout.session.completed
stripe trigger customer.subscription.created