Subscriptions
更新支付方式
更新现有订阅的支付方式。您可以添加新的支付方式或使用客户保存的支付方式中的现有方式。
POST
JavaScript
更新订阅的支付方式。此端点支持活动订阅和在
on_hold状态下的订阅。
对于处于
on_hold状态的订阅,更新付款方式会自动为剩余欠款创建一笔费用、生成发票,并在付款成功后将订阅重新激活至active状态。用例
- 活跃订阅:当卡片过期或客户想使用不同的支付方式时更新支付方式
- 暂停订阅:通过更新支付方式重新激活因付款失败而暂停的订阅
- 支付方式管理:在保存的支付方式之间切换或添加新方式
要列出客户的现有付款方式,请使用列出付款方式 API。这有助于在使用
type: "existing"更新订阅的付款方式时检索可用的付款方式 ID。活跃订阅的行为
更新活跃订阅的支付方式时:- 支付方式立即更新
- 不会创建收费
- 订阅保持活跃
- 未来的续订将使用新的支付方式
暂停订阅的行为
当为处于on_hold状态的订阅更新付款方式时:
- 自动为剩余欠款创建费用
- 为该费用生成发票
- 使用新的付款方式处理付款
- 付款成功后,订阅会重新激活至
active状态 - 您会收到以下 Webhook 事件:
payment.succeeded随后是subscription.active
Webhook 事件
在为处于on_hold状态的订阅更新付款方式时,您会收到以下 Webhook 事件:
payment.succeeded- 剩余欠款的费用已成功subscription.active- 订阅已重新激活
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
路径参数
Subscription Id
Last modified on April 1, 2026
JavaScript