Stripe 集成

Stripe 是目前最稳定也是最热门的全球支付处理平台，它简化了全球业务的支付流程，让 SaaS 产品能够轻松接受各种支付方式。

本章我们将介绍如何集成 Stripe 到模板代码。

注册与基础配置

访问 Stripe，注册账号

提示：

对于中国大陆的用户，现在 Stripe 支持使用中国大陆护照 + 香港银行卡注册个人账号。个人账号与企业账号的功能几乎没有差异，在没有注册海外企业的阶段，使用个人账号是很好的选择。

注册 Stripe 教程请参考无港卡注册香港地区Stripe ，该教程使用万里汇虚拟卡注册 Stripe 账号，可以先这样注册，等办完香港卡后，换绑到香港卡。

如果你需要香港银行卡的办理指南，请参考教程1 和教程2

进入 Dashboard 页面，从左上角开始创建账户，然后根据页面指引完成前置步骤。

获取 API Key 和创建 Webhook

注册完成后，在开发阶段应该进入 Sandbox 模式，直到所有流程调试完成后，再把产品等信息复制到 Live 模式。

stripe-sandbox

进入 Developer - API Keys 页面，把 Secret key 和 Publishable key 分别复制到环境变量的 STRIPE_SECRET_KEY 和 STRIPE_PUBLISHABLE_KEY 中。

stripe-api-keys

进入 Developer - Webhooks 页面，创建 Webhook 端点。

stripe-webhook

在 Cursor 或者 VSCode 中，设置一个 Forward Port，并且设置为 Public，然后复制生成的 Forwarded Address。

stripe-webhook

提示：

有时候长时间没有使用，Forward Port 虽然还是打开的，但实际上已经失效，这时候重新设置一下即可，这样不会改变 Forwarded Address。

把 Forwarded Address 复制到 Webhook Endpoint URL，然后点击 Select events 选择需要的事件。

stripe-webhook

勾选以下7种事件：

charge.refunded
checkout.session.completed
customer.subscription.created
customer.subscription.updated
customer.subscription.deleted
invoice.paid
invoice.payment_failed

有了这些事件就足够完成一套稳健的一次性支付和周期订阅的支付流程，并且这些事件在 Nexty.dev 模板都有对应的处理逻辑。

stripe-webhook

Webhook 创建完成后，获取 Secret，并复制到环境变量的 STRIPE_WEBHOOK_SECRET 中。

stripe-webhook

创建产品

现在来到 Product Catelog 页面，创建一个产品。

add-product

以下是 Nexty.dev 产品填写的内容，可以参考。

product-preview

创建完成后，点击产品，进入详情页

product-details

可以看到 Product ID 和 Price ID。后续步骤，我们会在管理员后台定价卡片中用到这两个 ID。

product-id

你可以按照同样的步骤创建订阅产品。

打开 Radar

Stripe 有一个 Radar 功能，这个功能可以自定义规则，来识别和拦截高风险的支付，以保障你的账号安全。

block-rules

不过这是一个收费功能，在 Sandbox 里可以免费使用。

如果你的 Live 模式购买了 Radar 功能，那么可以添加以下 rules：

一周内创建的新用户使用超过5张卡
:card_count_for_customer_weekly: > 5 and :hours_since_customer_was_created: <= 168
 
一周内同一客户使用超过4张信用卡
:card_count_for_customer_weekly: > 4 and :card_funding: = 'credit'
 
一周尝试高风险卡数量大于3
:card_count_for_customer_weekly: > 3 and :risk_score: > 50
 
一天同一IP地址进行大量高风险尝试
:total_charges_per_ip_address_daily: > 10 and :risk_score: > 40