SCPSetupIntentUsage

Objective-C

enum SCPSetupIntentUsage : NSUInteger {}

Swift

enum SetupIntentUsage : UInt, @unchecked Sendable

The SetupIntent usage options tell Stripe how the payment method is intended to be used in the future. Stripe will use the chosen option to pick the most frictionless flow for the customer.

See

https://stripe.com/docs/payments/setup-intents#increasing-success-rate-by-specifying-usage

  • An off-session usage indicates to Stripe that future payments will take place without the direct involvement of the customer. Creating an off-session SetupIntent might incur some initial friction from additional authentication steps, but can reduce customer intervention in later off-session payments.

    Declaration

    Objective-C

    SCPSetupIntentUsageOffSession

    Swift

    case offSession = 0

  • An on-session usage indicates to Stripe that future payments will take place while the customer is actively in your checkout flow and able to authenticate the payment method. With the on-session option, you can postpone authenticating the card details until a future checkout to avoid upfront friction.

    Declaration

    Objective-C

    SCPSetupIntentUsageOnSession

    Swift

    case onSession = 1