如何更新通过SetupIntent保存的Stripe客户信用卡信息

标准更新流程 #

当已绑定卡片的用户需要修改有效期、CVC安全码、账单信息时，按以下流程操作：

• 首先区分修改的信息类型：如果仅修改账单联系人、账单地址这类非卡校验属性的内容，可以直接调用PaymentMethod更新接口修改对应billing_details字段，不需要走额外验证流程。
• 如果修改内容涉及有效期、CVC这类卡组织校验的敏感字段，按照官方要求新建SetupIntent，创建时传入对应用户的customer参数绑定到目标Stripe客户，前端通过Stripe Elements收集用户提交的新卡片信息，完成SetupIntent确认后会生成一张绑定到该客户的全新可复用PaymentMethod。
• 新卡验证通过后，同步更新自有业务库中用户默认支付方式的关联ID，后续自动扣费、手动扣款都指向新生成的PaymentMethod即可。

旧卡片处理方案 #

新建SetupIntent生成新卡后，原有旧卡片不会被系统自动删除，根据业务场景选择对应处理方式即可：

• 如果用户是换卡（旧卡过期、挂失、注销），不再需要保留旧卡，直接调用接口将旧PaymentMethod从客户下detach（分离）即可，分离后旧卡不会出现在用户的已保存卡列表中，也无法用于后续扣款。
• 如果用户是想新增一张卡作为主支付方式，旧卡仍要保留供后续选择使用，不需要对旧卡做任何操作，仅需将新卡设置为客户的invoice_settings.default_payment_method即可，新旧两张卡会同时存在于用户的已保存支付方式列表中。
• 不要尝试直接修改旧PaymentMethod的exp_month、exp_year、cvc这类敏感字段，Stripe本身对这类字段做了编辑限制，直接调用更新接口修改会返回报错。

注意：如果用户是同一张卡仅更新了有效期（比如卡到期换了同号新卡），走新SetupIntent流程验证时，Stripe会自动识别同卡号的卡，不会生成重复的冗余卡记录，验证通过后新的有效期信息会自动关联到对应卡记录上，这种场景下分离旧卡也不会影响正常使用。

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