Ruby on Rails Pay Gem中会话结账后数据库未创建订阅问题

核心问题根源 #

你用Pay gem结合Stripe Checkout时，订阅、支付方式等数据的入库依赖Stripe Webhook事件触发，而非Checkout Session创建时同步完成。如果Webhook配置或事件接收有问题，就会出现仅Customer创建、后续数据缺失的情况。

排查与修复步骤 #

• 检查Webhook配置与事件接收

  1. 登录Stripe Dashboard，确认你（或连接账户）的Webhook端点已正确配置，并且启用了以下关键事件：
     • checkout.session.completed
     • customer.subscription.created
     • payment_method.attached
  2. 验证Webhook签名密钥与项目中STRIPE_WEBHOOK_SECRET环境变量一致，避免事件被拒绝。
  3. 用Stripe CLI测试：执行stripe listen --forward-to localhost:3000/pay/webhooks/stripe，完成一次Checkout流程后，查看终端和项目日志是否收到对应事件。

• 处理连接账户模式的事件路由
  你的代码使用了stripe_account: blog.stripe_account_id（平台-连接账户模式），此时Stripe会把事件发送到连接账户的Webhook，而非平台账户的：

  • 确保连接账户也配置了指向你项目的Webhook端点，且启用了所需事件。
  • 若需统一通过平台Webhook接收，可在创建Checkout Session时添加connect_webhook_endpoint: "你的平台Webhook URL"参数，但更推荐直接配置连接账户的Webhook。

• 验证Pay gem的挂载与逻辑触发

  1. 确认项目路由中已挂载Pay引擎：mount Pay::Engine, at: "/pay"，确保Webhook请求能被正确路由到Pay::WebhooksController。
  2. 查看项目日志，当Checkout成功后，确认checkout.session.completed事件被接收，且Pay的订阅创建逻辑无报错。

• 检查Metadata与关联数据有效性
  代码中subscription_data.metadata的blog_id和pay_name是Pay关联订阅到对应资源的关键：

  • 确保blog.id不为空，plan.stripe_name是有效字符串。
  • 若Metadata缺失或无效，可能导致Pay无法正确关联订阅，甚至跳过创建。

• 手动触发事件测试
  在Stripe Dashboard找到已完成的Checkout Session，手动发送checkout.session.completed事件到你的Webhook端点，观察数据库pay_subscriptions表是否生成记录，同时查看日志排查错误。

代码小检查 #

• 确认current_user已存在，customer_email与用户邮箱一致，Pay才能正确关联订阅到用户。
• 验证plan.stripe_price_id是有效的Stripe订阅类型价格ID，避免因价格类型错误导致订阅创建失败。

内容的提问来源于stack exchange，提问作者japahen