Stripe中on_session与off_session参数的含义解析

参数层级与作用范围 #

• payment_intent_data.setup_future_usage：作用于全局的Payment Intent（支付意向）层面，对所有支持未来支付的支付方式生效。它标记当前支付完成后，关联的支付方式需要被留存，用于后续指定类型的支付。
• payment_method_options.card.setup_future_usage：仅针对信用卡支付方式的精细化配置，优先级高于全局设置。如果同时配置了两个参数，信用卡会优先遵循这个选项，其他支付方式则沿用全局设置。

on_session与off_session的具体含义 #

on_session #

• 后续支付需要在用户主动参与会话时发起（比如用户登录后手动点击付款按钮）。
• 这类场景风险较低，Stripe一般不会触发额外的验证流程（如3DS验证）。
• 适用场景：用户主动发起的二次购买、订阅续费前用户主动确认付款等。

off_session #

• 后续支付会在用户不在场时自动发起（比如订阅自动续费、周期性账单自动扣款）。
• 这类场景风险相对较高，当卡组织规则要求时，Stripe可能会触发额外的验证流程。
• 适用场景：自动订阅扣费、会员到期自动续费等无需用户手动操作的场景。

内容的提问来源于stack exchange，提问作者Super Kai - Kazuya Ito