Stripe中无法获取客户支付方式，配置setup_future_usage仍无效

可能的原因及排查步骤 #

1. 确认支付方法是否真正关联到客户 #

• 登录Stripe控制台，找到对应的支付意图，检查其状态是否为succeeded
• 点击支付意图详情中的payment_methodID，进入支付方法页面，查看customer字段是否与你查询的客户ID一致
  • 如果该字段为空，说明支付方法未成功关联到客户，需要检查支付流程的设置

2. 检查支付意图的创建/确认参数 #

• 确保创建支付意图时，同时传递了customer和setup_future_usage: 'off_session'两个参数
• 如果是手动调用confirmPayment（前端）或stripe.paymentIntents.confirm（后端），需确认在确认环节也传递了setup_future_usage: 'off_session'
• 若支付需要3DS等额外验证，必须确保验证流程完整完成，否则支付方法不会被保存

3. 验证API调用的正确性 #

• 暂时移除type: "card"参数，调用以下代码测试：

  // 尝试不带类型过滤
  const paymentMethods = await stripe.paymentMethods.list({
    customer: customerId,
  });
  // 或
  const paymentMethods = await stripe.customers.listPaymentMethods(
    customerId
  );
  

  若返回结果包含支付方法，说明原过滤条件可能存在问题（比如支付方法类型不是card）
• 确认使用的Stripe API版本是否支持customers.listPaymentMethods（建议使用最新稳定版）
• 检查调用API的密钥是否拥有读取支付方法的权限（需使用后端秘钥，而非前端受限密钥）

4. 检查Stripe控制台的事件日志 #

• 查看Stripe的payment_method.attached事件，确认是否有该支付方法关联到客户的记录
• 如果没有该事件，说明支付流程中未触发支付方法的保存逻辑，需重新梳理支付集成步骤

补充说明 #

当设置setup_future_usage: 'off_session'后，Stripe仅在支付成功且满足条件时自动关联支付方法到客户。若支付过程中出现中断（如验证未完成），或参数传递不全，都会导致支付方法无法保存。

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