Stripe API（Node.js+React）：SetupIntent成功后如何更新支付凭证

为什么不能修改已成功的SetupIntent #

SetupIntent是一次性资源，状态变为success后就无法修改或重复使用，它仅用于完成首次支付方式的绑定流程，后续的支付方式管理需要基于Customer和PaymentMethod资源操作。

更新支付凭证的实现步骤 #

1. 后端处理：
   • 无需复用旧的SetupIntent，直接为该用户对应的Stripe Customer创建新的SetupIntent（调用stripe.setupIntents.create，传入customer字段为原客户ID）。
   • 将新SetupIntent的client_secret返回给前端。
2. 前端处理：
   • 使用新的client_secret重新初始化Elements组件。
   • 用户填写新的支付信息后，调用stripe.confirmSetup完成新支付方式的绑定。
3. 后续关联：
   • 绑定成功后，后端可通过stripe.setupIntents.retrieve获取新的payment_method ID，调用stripe.customers.update将其设置为该客户的默认支付方式（可选）。
   • 若需要替换旧支付方式，可调用stripe.paymentMethods.del删除旧的PaymentMethod。

删除支付凭证的实现步骤 #

1. 前提：数据库中需存储用户绑定的PaymentMethod ID（首次绑定成功后，可从SetupIntent的payment_method字段获取）。
2. 后端操作：
   • 调用stripe.paymentMethods.del方法，传入要删除的PaymentMethod ID，完成删除。
   • 如果要删除的是客户的默认支付方式，需先调用stripe.customers.update，将invoice_settings.default_payment_method设置为其他PaymentMethod ID或置空。

前端展示现有支付方式的补充 #

• 后端可调用stripe.customers.listPaymentMethods，获取该客户下所有已绑定的支付方式（包含卡品牌、后四位等信息），返回给前端展示。
• 用户选择更新时触发新SetupIntent的创建流程；选择删除时触发后端的删除接口。

Stripe官方核心指引（翻译） #

当需要保存并复用支付方式时，SetupIntent仅用于初始绑定流程。后续更新需创建新的SetupIntent绑定新支付方式，删除操作直接针对已保存的PaymentMethod执行。Customer资源用于管理所有关联的支付方式，可通过客户ID查询、添加或移除其下的支付方式。

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