跳到正文
SaaS Starter
中文

登录

登录或创建账户,继续使用。

使用文档

配置自己的套餐与 Stripe

连接 Stripe 价格与 Webhook,测试结账流程,再准备正式收款。

先在 Stripe 测试环境创建商品与价格,再通过部署环境配置同一环境的密钥、价格编号和 Webhook 签名密钥。让套餐文案与商品一致,配置 Webhook 接收地址和 Customer Portal,修改部署配置后重启后端。网站设置展示配置状态,不展示密钥。

仅在 Stripe 测试环境使用官方测试卡:4242 4242 4242 4242,填写未来有效期和任意三位 CVC;如果表单要求账单信息,补齐相应测试字段。测试模式的购买不会扣取真实银行卡资金。

NEXT_PUBLIC_DEMO_MODE 只控制页面的演示提示。支付处于测试还是正式模式,由后端 Stripe 凭证决定;缺少支付配置时无法发起结账,换成正式凭证后可能产生真实扣款。先完成测试流程,再配置正式商品和密钥。

购买完成后

返回订阅管理,等待支付结果同步,再刷新套餐与账单。如果暂时没有更新,可以稍后重试或联系站点负责人。

测试支付失败

仅在 Stripe 测试模式使用 4000 0000 0000 0002 模拟银行卡拒付,并检查失败的支付没有开通付费权益。

APP_BILLING_ENABLED=true
APP_BILLING_STRIPE_SECRET_KEY=sk_test_...
APP_BILLING_STRIPE_WEBHOOK_SECRET=whsec_...
APP_BILLING_STRIPE_PRICES_PRO_MONTHLY=price_...
APP_BILLING_STRIPE_PRICES_CREDITS=price_...

检查订阅和账单

获取 Stripe API 密钥

Stripe 测试说明