STPSetupIntentConfirmParams

@interface STPSetupIntentConfirmParams : NSObject <NSCopying, STPFormEncodable>

An object representing parameters to confirm a SetupIntent object.

For example, you would confirm a SetupIntent when a customer hits the “Save” button on a payment method management view in your app.

If the selected payment method does not require any additional steps from the customer, the SetupIntent’s status will transition to STPSetupIntentStatusSucceeded. Otherwise, it will transition to STPSetupIntentStatusRequiresAction, and suggest additional actions via nextAction. Instead of passing this to [STPAPIClient confirmSetupIntent...] directly, we recommend using STPPaymentHandler to handle any additional steps for you.

See

https://stripe.com/docs/api/setup_intents/confirm

  • Initialize this STPSetupIntentConfirmParams with a clientSecret.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithClientSecret:(nonnull NSString *)clientSecret;

    Swift

    init(clientSecret: String)

    Parameters

    clientSecret

    the client secret for this SetupIntent
    Show on GitHub

  • The client secret of the SetupIntent. Required.

    Declaration

    Objective-C

    @property (readwrite, copy, nonatomic) NSString *_Nonnull clientSecret;

    Swift

    var clientSecret: String { get set }
    Show on GitHub

  • Provide a supported STPPaymentMethodParams object, and Stripe will create a PaymentMethod during PaymentIntent confirmation.

    Note

    alternative to paymentMethodId

    Declaration

    Objective-C

    @property (readwrite, strong, nonatomic, nullable)
    STPPaymentMethodParams *paymentMethodParams;

    Swift

    var paymentMethodParams: STPPaymentMethodParams? { get set }
    Show on GitHub

  • Provide an already created PaymentMethod’s id, and it will be used to confirm the SetupIntent.

    Note

    alternative to paymentMethodParams

    Declaration

    Objective-C

    @property (readwrite, copy, nonatomic, nullable) NSString *paymentMethodID;

    Swift

    var paymentMethodID: String? { get set }
    Show on GitHub

  • The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method’s app or site.

    This should probably be a URL that opens your iOS app.

    Declaration

    Objective-C

    @property (readwrite, copy, nonatomic, nullable) NSString *returnURL;

    Swift

    var returnURL: String? { get set }
    Show on GitHub

  • A boolean number to indicate whether you intend to use the Stripe SDK’s functionality to handle any SetupIntent next actions. If set to false, STPSetupIntent.nextAction will only ever contain a redirect url that can be opened in a webview or mobile browser. When set to true, the nextAction may contain information that the Stripe SDK can use to perform native authentication within your app.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic, nullable) NSNumber *useStripeSDK;

    Swift

    var useStripeSDK: NSNumber? { get set }
    Show on GitHub

  • Details about the Mandate to create.

    Note

    If this value is null and the self.paymentMethod.type == STPPaymentMethodTypeSEPADebit && self.mandate == nil, the SDK will set this to an internal value indicating that the mandate data should be inferred from the current context.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic, nullable)
    STPMandateDataParams *mandateData;

    Swift

    var mandateData: STPMandateDataParams? { get set }
    Show on GitHub

  • The ID of the Mandate to be used for this payment.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic, nullable) NSString *mandate;

    Swift

    var mandate: String? { get set }
    Show on GitHub

Utilities

  • Verifies whether the provided client secret matches the expected format. Does NOT validate that the client secret represents an actual object in an account.

    Declaration

    Objective-C

    + (BOOL)isClientSecretValid:(nonnull NSString *)clientSecret;

    Swift

    class func isClientSecretValid(_ clientSecret: String) -> Bool
    Show on GitHub