跳转到内容

Stripe Webhook 集成

Stripe Dashboard 中打开 开发者 → Webhooks,添加端点并将 Endpoint URL 设为 HookNexus 提供的公开地址:

https://api.hooknexus.com/h/{endpoint-id}(将 {endpoint-id} 替换为控制台中的端点 ID)。

选择需要的事件类型后保存,在端点详情中复制 签名密钥(以 whsec_ 开头)。在 HookNexus 或你的应用中使用该密钥校验 Stripe-Signature 头,确保请求来自 Stripe。

常用事件包括 checkout.session.completedcustomer.subscription.updatedinvoice.paid 等,可按业务逐步勾选。开发时可在 Dashboard 中 发送测试事件,或使用 Stripe CLI 将事件转发到你配置的 URL,再在 HookNexus 中查看完整请求体。

本地调试时,可先用 HookNexus 接收 Stripe 投递,确认签名与载荷无误后,再接到自建服务。