配置环境
Stripe
如何配置 Stripe 相关环境变量。
Mkdirs 使用 Stripe 作为支付服务商，用于收款。
配置
创建 Stripe 账户
如果您没有 Stripe 账户，请按照他们的步骤 注册。
获取 Stripe API 密钥
- 进入 Stripe 仪表盘。
- 点击右上角的
Developers。 - 点击
Developers菜单下的API keys。 - 点击
Reveal live key（如果您在测试模式下，请点击Reveal test key）。 - 复制密钥并将其设置到
.env文件中。
- 确保您复制的是 secret key 而不是 public key。
- 线上和测试模式的密钥不同，请确保您为线上和测试模式分别设置不同的密钥。
# .env
# [only required if you want to support paid submissions]
STRIPE_API_KEY=your_stripe_api_key
获取产品价格 ID
- 进入 Stripe 仪表盘。
- 点击左侧栏的
Product Catalog。 - 点击
+ Create Product按钮。 - 给产品一个清晰的名字，并设置用户提交的费用。
- 点击
Add Product按钮创建它。 - 进入产品详情页面，点击
...按钮在定价部分。 - 复制 price id 并将其设置到
.env文件中。
- 确保您复制的是 price id 而不是 product id。
- 确保您为线上和测试模式分别设置不同的 price id。
- 确保您为付费提交和赞助广告分别设置不同的 price id。
NEXT_PUBLIC_STRIPE_PRO_PRICE_ID是付费提交的 price id。NEXT_PUBLIC_STRIPE_SPONSOR_PRICE_ID是赞助广告的 price id。
# .env
# [only required if you want to support paid submissions and sponsor ads]
NEXT_PUBLIC_STRIPE_PRO_PRICE_ID=your_price_id
NEXT_PUBLIC_STRIPE_SPONSOR_PRICE_ID=your_sponsor_price_id
获取 Webhook 密钥
- 进入 Stripe 仪表盘。
- 点击右上角的
Developers。 - 点击
Developers菜单下的Webhooks。 - 点击
Add an endpoint按钮。 - 输入 Stripe 发送事件的端点 URL，例如
https://your-domain.com/api/webhook。 - 选择您想要接收通知的事件，常见事件包括
checkout.session.completed。 - 复制 Webhook 密钥并将其设置到
.env文件中。
在测试模式下，您不能将 Webhook URL 设置为 http://localhost:3000/api/webhook，因为您需要使用本地代理来测试它。
您可以使用 ngrok 或者 localtunnel 为本地服务器创建一个可公开访问的 URL，例如 https://mkdirs.loca.lt/api/webhook。
# .env
# [only required if you want to support paid submissions and sponsor ads]
STRIPE_WEBHOOK_SECRET=your_webhook_secret
视频教程
视频教程有2个版本，一个是开发者教程，一个是初学者教程，请根据自己的实际情况选择观看。
配置 Stripe 环境变量 - 开发者教程
配置 Stripe 环境变量 - 初学者教程
延伸阅读
最后更新于