使用文档
配置自己的套餐与 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_...