Integrations

Stripe

配置 Stripe 进行计费、订阅和客户计费门户管理。

前提条件

  • 一个 Stripe 账户
  • 已安装 Stripe CLI：npm install -g stripe

第一步：设置环境变量

STRIPE_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxxxxxx

开发时使用 sk_test_ 密钥。

第二步：在 Stripe 中创建产品

# 创建产品
stripe products create --name="Nebutra PRO"

# 创建价格
stripe prices create \
  --product=prod_xxx \
  --unit-amount=2900 \
  --currency=usd \
  --recurring[interval]=month

第三步：配置 Webhook 端点

在 Stripe 仪表板：开发者 → Webhooks → 添加端点

  • URL：https://api.nebutra.com/api/webhooks/stripe
  • 监听的事件：
    • checkout.session.completed
    • customer.subscription.updated
    • customer.subscription.deleted
    • invoice.paid
    • invoice.payment_failed

本地测试 Webhook

stripe listen --forward-to localhost:3000/api/webhooks/stripe

Stripe 测试卡

卡号场景
4242 4242 4242 4242支付成功
4000 0000 0000 9995余额不足
4000 0025 0000 31553D Secure 认证

使用任意未来到期日和任意 3 位 CVC。

相关文档

计费模型

套餐、配额和计量。

Webhooks 指南

完整的 Webhook 配置和签名验证。

How is this guide?

在 GitHub 上编辑此页面

最后更新于

Slack

向 Slack 发送 Nebutra 通知——新成员、配额预警、计费事件。

Vercel

将 Nebutra 营销入口部署到 Vercel，同时把 app/API/docs 保留在合适的运行边界。

目录

前提条件
第一步：设置环境变量
第二步：在 Stripe 中创建产品
第三步：配置 Webhook 端点
本地测试 Webhook
Stripe 测试卡
相关文档