The next release's version bump will so far be: PATCH
- [Fixed] Fixed an issue introduced in 25.8.0 where manually closing a webview 3ds2 challenge after failing the challenge and before it's automatically dismissed could result in a succeeded result.
- [Fixed] Fixed a crash when loading PaymentSheet, FlowController, and EmbeddedPaymentElement when compiling with XCode 26.4 / Swift 6.3 due to a compiler bug
- [Fixed] Improved loading times for integrations that set
configuration.customer.
- [Added] Adds support for payments orchestration (private preview) by allowing
processingas a PaymentIntent state for cards.
- [Improved] Improved selfie capture best-frame selection by ranking samples with face score, centering, coverage, and stability (focus/motion blur).
- [Added] Added support for Wero payments (private preview).
- [Fixed] Fixed a visual bug in PaymentSheet when the Link sign-in modal appears first where the Apple Pay button was not full width on > iOS 26.2
- [Changed] Card brand choice selector UI from a dropdown to a segmented selector following Mastercard requirements.
- [Fixed] #6098 Fixed an issue with App Store submissions in which StripeIssuing.xcframework contained copies of other StripePayments frameworks.
- [Changed] Breaking change for
PaymentMethodMessagingElement.Appearance. The info icon has been removed and replaced with a CTA to see available plans. TheinfoIconColorconfiguration has been removed, and the new link text color is customizable throughlinkTextColor.
- [Changed] Rebranded iDEAL to iDEAL | Wero
- [Changed] Removed bank selector from iDEAL | Wero form
- [Changed] Reverted an undocumented public API change for PaymentMethodMessagingElement
- [Changed] Afterpay/Clearpay no longer requires billing address by default. Set
billingDetailsCollectionConfiguration.address = .fullif you need to collect billing address for Afterpay.
- [Fixed] Fixed a view controller lifecycle issue that could cause keyboard avoidance and layout problems on the Add Card screen.
- [Added] Added a best frame detector to document capture.
- [Fixed] Fixed build for visionOS 26.2 SDK.
- [Fixed] Fixed an issue where the SwiftUI
isPresentedbinding for CustomerSheet would not reset tofalsewhen dismissing during loading, preventing the sheet from being presented again. - [Fixed] Fixed a Swift 6 actor isolation issue in the SwiftUI integration that could cause a crash when presenting PaymentSheet or CustomerSheet.
- [Fixed] Fixed a Swift 6 actor isolation issue in the SwiftUI integration for
paymentConfirmationSheetandsetupIntentConfirmationSheet.
- [Added] More live feedback during document capture.
- [Added] Added API bindings support for TWINT payment methods.
- [Fixed] Fixed an issue with EmbeddedPaymentElement where calling
updatewould cause customers to not stay logged in to their Link account.
- [Added] StripeIssuing is now available as a separate module, enabling support for Apple Pay Wallet Extensions. If you use the legacy Stripe framework with Carthage or by manually embedding the .xcframeworks, you must also embed StripeIssuing.xcframework in your app. No action is required for Cocoapods and Swift Package Manager users, or users of the individual
StripePayments,StripePaymentsUI, andStripePaymentSheetmodules.
- [Fixed] Fixed an issue where confirming fails when setting
setupFutureUsageValueson theIntentConfiguration.paymentMethodOptionsparameter for Cash App Pay, Satispay, PayPal, Amazon Pay, Revolut Pay, or Klarna due to missingmandate_data.
- [Fixed] Improved telemetry used for advanced fraud signals.
- [Fixed] Fixed an issue where confirming Cash App Pay, Satispay, or PayPal could fail when setup_future_usage =
on_session. - [Changed] Custom Payment Methods is now generally available, learn more by visiting the docs.
- [Fixed] The native Instant Bank Payments flow is now available to more merchants.
- [Added] Support for PayPay with PaymentIntents.
- [Added] Support for PayPay bindings.
- [Added]
PaymentMethodMessagingElementis now in public preview
- [Fixed] Fixes Instant Bank Payments when used in a webview flow.
- [Added] Added
cardproperty toSTPPaymentMethodPreviewto expose card details (brand, country, exp_month, exp_year, funding, last4, display_brand) from ConfirmationTokens.
- [Added]
StripeFinancialConnectionsSDK is now localized!
- [Fixed] Fixed an issue where async APIs did not run on the main thread.
- [Fixed] Fixed a crash when presenting PaymentSheet with liquid glass navigation bar style from a view controller not embedded in a UINavigationController.
This major version introduces many small breaking changes. Please see MIGRATING.md to help you migrate.
- [Added] You can now access the HTTP status code of failed API requests by inspecting
userInfo[STPError.httpStatusCodeKey]on the error. - [Added] You can now access the Stripe request ID of failed API requests by inspecting
userInfo[STPError.stripeRequestIDKey]on the error. - [Changed] Most delegate protocols are now marked as
@MainActor @preconcurrencyto improve support for Swift strict concurrency. This includes:STPApplePayContextDelegate,STPAuthenticationContext,STPPaymentCardTextFieldDelegate,STPCardFormViewDelegate,AddressViewControllerDelegate, andSTPAUBECSDebitFormViewDelegate.
- [Fixed] PaymentSheet, PaymentSheet.FlowController, and EmbeddedPaymentElement return errors when loading with invalid configuration instead of loading in a degraded state.
- [Added] Added async versions of all completion-block-based PaymentSheet and PaymentSheet.FlowController methods.
- [Added] CustomerSessions is now generally available.
- [Added] ConfirmationTokens is now generally available.
- [Changed] Replaced
ExternalPaymentMethodConfirmHandlerwith an async equivalent. - [Changed] Replaced
IntentConfiguration.ConfirmHandlerwith an async equivalent. - [Changed] Replaced
PaymentSheet.ApplePayConfiguration.Handlerscompletion-block basedauthorizationResultHandlerwith an async equivalent. - [Removed] Removed
PaymentSheet.reset()in favor ofPaymentSheet.resetCustomer(). - [Removed] Removed
PaymentSheet.CustomerConfiguration.ephemeralKeySecret.
- [Added] Added async versions of
present(from:)andpresentForToken(from:).
- [Added] Added an async version of
present(from:). - [Added] CustomerSessions is now generally available.
- [Added] Added async delegate methods.
- [Changed] Replaces the
ApplePayContextDelegate.didCreatePaymentMethodmethod with an async version.
- [Added]
STPPaymentHandlerandSTPAPIClientmethods with completion blocks now have async equivalents. - [Changed]
STPPaymentIntent.paymentMethodTypesandSTPSetupIntent.paymentMethodTypesnow return[STPPaymentMethodType]instead of[NSNumber]in Swift for better ergonomics. - [Changed]
STPSetupIntentConfirmParams.useStripeSDK,STPPaymentIntentConfirmParams.useStripeSDK,STPConnectAccountCompanyParams.directorsProvided,STPConnectAccountCompanyParams.ownersProvided, andSTPConnectAccountParams.tosShownAndAcceptednow usesBool?instead ofNSNumber?in Swift for better ergonomics. - [Changed] Renamed STPPaymentHandler's
confirmandhandleNextActionmethods and added async versions. - [Changed] Renamed STPPaymentIntentParams to STPPaymentIntentConfirmParams
- [Changed]
linkedAccountonSTPPaymentMethodUSBankAccounthas been renamed tofinancialConnectionsAccount. - [Changed] Changed
STPPaymentMethodType.descriptionto be more consistent. - [Removed] Removed
requiresSourceandrequiresSourceActionstatuses fromSTPPaymentIntentStatus. Also removedSTPPaymentIntentSourceActionType. - [Removed] Removed deprecated
STPPaymentIntentParams.saveSourceToCustomerproperty. UsesavePaymentMethodinstead. - [Removed] Removed
singleUsePaymentMethodSTPPaymentMethodParams initializer. - [Removed] Removed STPPaymentMethod
metadata. - [Removed] Sources are no longer supported for non-card payment methods or cards that require 3DS authentication. Please migrate to the Payment Methods API.
- [Removed] Removed Sofort. Migrate to SEPA Debit or other EU payment methods. See this page for more information.
- [Removed] Removed Giropay. Use alternative payment methods instead. See this page for more information.
- [Fixed] Blocked emoji input in text fields.
- [Added] Added support for
onBehalfOfto CustomerSheet.IntentConfiguration. This parameter makes CustomerSheet use a connected account to determine the payment method that users see and whether CardBrandChoice is enabled. For more information, see the SetupIntent docs.
- [Fixed] Fixed a bug with
FlowControllerandEmbeddedPaymentElementin dark mode wherepaymentOption.imagecould be a blank icon for Alma, Billie, Multibanco, Paynow, Promptpay, Satispay, and Sunbit
- [Fixed] Fixed a bug where the keyboard done button was not tappable on devices < iOS 26 when compiled with Xcode 26.
- [Fixed] Fixed minor styling issues with Link UI on < iOS 26 when compiled with Xcode 26.
- [Improved] Improved CVC recollection UI in Link
- [Improved] Added automatic retry on network errors when fetching payment intents for improved resilience
- [Fixed] Renamed
PrivateBetaConnecttoPreviewConnect.
- [Fixed] Fixed a navigation bar shadow bug when
appearance.navigationBarStyleisglass(iOS 26.1 fixed the underlying API).
- [Added] Payments and Payouts embedded components are available to use in public preview.
- [Added] Added
Appearance.applyLiquidGlass(), a convenience method that changes the values of various properties on theAppearanceobject used by PaymentSheet, PaymentSheet.FlowController, EmbeddedPaymentElement, CustomerSheet, and AddressViewController to match Liquid Glass when building with Xcode 26 or later and running on iOS 26. This includesappearance.cornerRadius,appearance.borderWidth,appearance.navigationBarStyle,colors.background,navigationBarStyle, and others. This feature is in public preview while we gather feedback and is subject to change. Please use https://github.com/stripe/stripe-ios/issues to file feedback!
![]() |
![]() |
|---|
- [Added] Appearance.navigationBarStyle. Setting to
.glasswill change the sheet navigation bar to a glassy appearance when building with Xcode 26 or later and running on iOS 26. CallingAppearance.applyLiquidGlass()will set this value to.glass. - [Changed]
appearance.cornerRadiusis now nullable. Below iOS 26, Whennil, the corner radius is 6.0 (ie unchanged from the current default). On iOS 26+, multiple rounder corner configurations are used to match Liquid Glass design. - [Fixed] Improved the cancellation UX when paying with Amazon Pay, Revolut Pay, P24, Twint, Swish, and 3DS2 card.
- [Added] Additional APIs and improvements to support the development of the React Native StripeCryptoOnramp SDK.
- [Fixed] Fixed an issue with the Liquid Glass keyboard toolbar where tapping on the sheet immediately above the keyboard didn't have an effect.
- [Added] Additional APIs and improvements to support the development of the React Native StripeCryptoOnramp SDK.
- [Added]
opensCardScannerAutomaticallyconfiguration
- [Added]
opensCardScannerAutomaticallyconfiguration - [Fixed] Setting
appearance.borderWidth = 0previously caused the thickness of divider lines between input fields to also be 0, causing them to disappear. They now have a minimum thickness of 0.5.
- [Added]
opensCardScannerAutomaticallyconfiguration
- [Added] Additional APIs and improvements to support the development of the React Native StripeCryptoOnramp SDK.
- [Changed] Updated translations for Link signup opt-in copy
- [Changed] Updated copy for Link signup opt-in UI
- [Fixed] Fixed Dynamic Actor Isolation crash in SwiftUI when using completion handlers with Swift 6 or Dynamic Actor Isolation feature flag enabled. Thanks @BrentMifsud! (#5269)
- [Added] Added new
presentPaymentOptionsAPIs for UIKit and SwiftUI with adidCancelbool in the completion handler, making it possible to differentiate between a user closing FlowController and selecting a payment option. (#5202) - [Added] Added a new
allowedCountriesAPI to PaymentSheetConfiguration, enabling users to only allow billing addresses in certain countries. - [Fixed] Fixed Dynamic Actor Isolation crash in SwiftUI when using completion handlers with Swift 6 or Dynamic Actor Isolation feature flag enabled. Thanks @BrentMifsud! (#5269)
- [Changed] The form will now highlight incomplete fields when the user taps a disabled "Confirm" button.
- [Added]
STPError.localizedUserMessage(forErrorCode:)will translates common Stripe API error codes to localized strings.
- [Fixed] Issue when deserializing intent when line1 is null
- [Fixed] Fixed an issue that caused EmbeddedPaymentElement to log broken layout constraints.
- [Fixed] The Apple Pay logo in
PaymentOptionDisplayDatano longer contains additional padding, bringing it in line with other payment method logos. - [Changed] When phone number or email address collection is enabled, these fields will now appear in the billing details section instead of appearing above the card field.
- [Added] Added
termsDisplayin PaymentSheet.Configuration to control when legal agreements are displayed
- [Changed] When using
EmbeddedPaymentElement.Configuration.FormSheetAction.confirm, the completion block is now called with acanceledresult if the user closes the form sheet without completing the transaction. - [Added] You no longer need to set the backend PaymentIntent setup_future_usage or payment_method_options setup_future_usage values to match the client's IntentConfiguration; the client will automatically configure this for you.
- [Fixed] Updated default spacing of form elements in PaymentSheet.
- [Added] EmbeddedPaymentElement now shows mandates in a form sheet when
rowSelectionBehaviorisimmediateActionandembeddedViewDisplaysMandateTextistrue. Previously, this configuration was an error.
- [Fixed] Improved Klarna payments when using Universal Links.
- [Added] Postal code validation for Canada and UK addresses
- [Added] Added
Appearance.EmbeddedPaymentElement.Row.subtitleFontto customize the font of EmbeddedPaymentElement payment method row subtitles.
- [Fixed] EmbeddedPaymentElement now errors when
configuration.rowSelectionBehavioris.immediateActionandconfiguration.embeddedViewDisplaysMandateTextistrueto ensure integrations display legal mandate text to the customer. - [Deprecated] Carthage is no longer officially supported. We will continue to publish binaries to the GitHub releases page for Carthage, but we will no longer test using the Carthage CLI tool.
- [Added] Added
Appearance.EmbeddedPaymentElement.Row.paymentMethodIconLayoutMarginsto customize the spacing around payment method icons in EmbeddedPaymentElement payment method rows. - [Added] Added
Appearance.EmbeddedPaymentElement.Row.titleFontto customize the font of EmbeddedPaymentElement payment method row titles. - [Changed] Renamed
PaymentSheet.Appearance.EmbeddedPaymentElement.Row.Style.flatWithChevrontoPaymentSheet.Appearance.EmbeddedPaymentElement.Row.Style.flatWithDisclosureand added an experimentaldisclosureImageproperty to customize the chevron icon displayed in EmbeddedPaymentElement payment method rows when the row style is flatWithDisclosure. - [Fixed]
EmbeddedPaymentElementDelegatedidUpdateHeightnow accommodates cases where the embedded view can't change height until afterdidUpdateHeightis called, like inside a UITableViewCell. - [Fixed] Apple Pay now properly collects phone number and email address when marked as required in
PaymentSheet.Configuration.billingDetailsCollectionConfiguration.
- [Added] SwiftUI support for AddressElement.
- [Changed]
AddressViewControllernow notifies its delegate when the sheet is dismissed, whether by tapping the Close button or swiping down, soAddressElementalways returns the current address.
- [Removed] Removed nn-NO (Norwegian Nynorsk) localization. Norwegian users can continue using nb (Norwegian Bokmål) localization.
- [Added] Address autocomplete functionality when collecting full billing details in payment method forms.
- [Fixed] Form error text not respecting Appearance API font settings
- [Fixed] A race condition when updating the
paymentOptiononPaymentSheet.FlowController.
- [Fixed] A bug where the EmbeddedPaymentElement failed to display forms when tapped in SwiftUI.
- [Changed]
paymentOptiononPaymentSheet.FlowControlleris now annotated with@Publishedfor better ergonomics in SwiftUI. - [Added] A new
flatWithChevronEmbedded Payment Element row style.
- [CHANGED] Removed
PrivateBetaConnectannotation and all usages. Connect SDK is now GA.
- [Added] The ability to customize the height of the primary button with
PaymentSheetAppearance.primaryButton.height. - [Added] The ability to customize form insets with
PaymentSheetAppearance.formInsets.
- [Added] Support for payment method options setup future usage in public preview.
- [Fixed] Updated the "TEST MODE" badge to say "TEST", due to the upcoming release of Sandboxes.
- [Added] Added support for Thai language.
- [Added] Embedded Payment Element is now generally available. Learn more by visiting the docs.
- [Fixed] Fixed an issue where identity verification may fail due to stale model cache.
- [Added] Bank payments are now available in the PaymentSheet without requiring a dependency on
StripeFinancialConnections. - [Added] Ability to update saved cards when using CustomerSessions (private preview)
- [Added] Added payment method options setup future usage to deferred API.
- [Added] Added support for PayNow and PromptPay to Embedded Payment Element (private preview).
- [Fixed] Fixed theming issues in the native Link experience (private preview).
- [Added] Added
rowSelectionBehaviorAPI to Embedded Payment Element (private preview). - [Changed] The native Link experience (private preview) is now available as a payment method even if you collect billing details via
billingDetailsCollectionConfiguration. - [Changed] Updated Afterpay branding in the US to be Cash App Afterpay.
- [Added] Added
LinkConfigurationto allow control over Link in PaymentSheet. - [Fixed] Improved reliability of expiration date detection when scanning cards.
- [Fixed] Fixed an issue where Account Onboarding exit events were not being properly emitted.
- [Fixed] Embedded Payment Element (private beta) possibly showing empty forms after calling
update().
- [Added] Support for default payment methods in private beta.
- [Changed] The SDK now manages the onboarding component's presentation.
- [Changed] The payouts component is no longer available.
- [Fixed] Fixed an issue in Embedded Payment Element (private preview) where the row could be selected even though there's no valid payment option.
- [Added] Support for Crypto in PaymentSheet
- [Added] Added card brand filtering to specify allowed or blocked card brands. Learn more by visiting the docs.
- [Fixed] Fixed an issue that caused
STPPaymentMethodUSBankAccount.linkedAccountto benilfor some merchants.
- [Fixed] The SDK and example apps now compile in Xcode 16.2
- [Added] The
StripeFinancialConnectionsSDK now supports dark mode, and will automatically adapt to the device's theme. Learn more about configuring appearance settings.
- [Added]
sepa_debitPaymentMethod is now available in CustomerSheet
- [Fixed] Fixed an issue where the UI layout was incorrect after Camera permissions were denied. (#4487) (Thanks @matheusbc!)
- [Added] Added a
dismissmethod toSTPApplePayContext.
- [Fixed] Embedded Payment Element (private beta) layout margins default to zero.
- [Fixed] Fixed a bug in Embedded Payment Element (private beta) where it could attempt to present a view controller while already presenting.
- [Fixed] PaymentSheet using vertical payment method layout now defaults to Apple Pay when the customer doesn't have a default saved payment method.
- [Added] Updates example app to allow reusing VerificationSessions.
- [Added] Embedded Payment Element is now in private beta.
- [Fixed] Fixed a bug where saved payment methods could appear out of order if you have multiple types (e.g. card and bank).
- [Fixed] Fixed a bug where deferred PaymentIntents would fail to validate when capture_method = automatic_async (#4329)
- [Added]
StripeConnectSDK to add connected account dashboard functionality to your app using Connect embedded components.
- [Changed] Changed the edit and remove saved payment method flow so that tapping 'Edit' displays an icon that leads to a new update payment method screen that displays payment method details for card (last 4 digits of card number, cvc and expiry date fields), US Bank account (name, email, last 4 digits of bank acocunt), and SEPA debit (name, email, last 4 digits of IBAN).
- [Fixed] Fixes an error with selfie verification.
- [Fixed] Fixed an issue where FlowController returned incorrect
PaymentOptionDisplayDatafor Link card brand transactions.
- [Fixed] Fixed an animation glitch when dismissing PaymentSheet in React Native.
- [Fixed] Fixed an issue in Instant Bank Payments that occurred when using a connected account.
- [Added] Support for Crypto bindings.
- [Fixed] US Bank Account now shows the correct mandate when using the
instant_or_skipverification method.
- [Fixed] A bug where PaymentSheet would cause layout issues when nested within certain navigation stacks.
- [Added] Instant Bank Payments are now available when using deferred intents.
- [Fixed] Fixed an issue with the vertical list with 3 or more saved payment methods where tapping outside the screen sometimes drops changes that were made (e.g. removal or update of PMs).
- [Fixed] Fixed an issue where the dialog when removing a co-branded card may show the incorrect card brand.
- [Fixed] Fixed issue preventing users to enter in 4 digit account numbers for AU Becs.
- [Changed] The default value of
PaymentSheet.Configuration.paymentMethodLayouthas changed from.horizontalto.automatic. See MIGRATING.md for more details. - [Fixed] Fixed an animation glitch when dismissing PaymentSheet in React Native.
- [Fixed] Fixed an issue with FlowController in vertical layout where the payment method could incorrectly be preserved across a call to
updatewhen it's no longer valid. - [Fixed] Fixed a potential deadlock when
paymentOptionis accessed from Swift concurrency. - [Fixed] Fixed deferred intent validation to handle cloned payment methods (#4195
- [Removed] Basic Integration has been removed. Please use Mobile Payment Element instead.
- [Added] Added
PaymentSheet.Configuration.paymentMethodLayout. Configure the layout of payment methods in the sheet usingpaymentMethodLayoutto display them either horizontally, vertically, or let Stripe optimize the layout automatically.
- [Fixed] Fixed an issue where ISK was not correctly formatted as a zero-decimal currency when using PaymentSheet or Apple Pay. (Thanks @Thithip!)
- [Fixed] Fixed an issue where US Bank Account forms would drop form field input when
FlowController.updateis called.
- [Added] The ability to customize the disabled colors of the primary button with
PaymentSheetAppearance.primaryButton.disabledBackgroundColorandPaymentSheetAppearance.primaryButton.disabledTextColor. - [Added] CVC Recollection is now in GA. For more information see our docs for here for intent first integrations or here for deferred intent integrations.
- [Fixed] Fixed an issue where checkboxes were not visible when
appearance.colors.componentBorderwas transparent.
- [Fixed] The 0.5x lens is now used when scanning cards, if available. (Thanks @akhmedovgg!)
- [Added] CustomerSessions is now in private beta.
- [Fixed] PaymentSheet now uses a border width of 1.5 instead of 0 when `PaymentSheet.Appearance.borderWidth' is 0.
- [Fixed] The 0.5x lens is now used when scanning cards, if available. (Thanks @akhmedovgg!)
- [Fixed] Avoid multiple calls to CVC Recollection callback for deferred intent integrations
- [Fixed] Fixed an issue in SwiftUI where setting
isPresented=falsewouldn't dismiss the sheet.
- [Fixed] Fixed an issue where signing up with Link and paying would vend an empty
STPPaymentMethodobject to anIntentConfigurationconfirmHandler callback. - [Fixed] Fixed PaymentSheet.FlowController returning unlocalized labels for certain payment methods e.g. "AfterPay ClearPay" instead of "Afterpay" or "Clearpay" depending on locale.
- [Added]
PaymentSheet.IntentConfigurationnow validates that itsamountis non-zero.
- [Fixed] Fixed an issue where STPPaymentCardTextField wouldn't call its delegate
paymentCardTextFieldDidChangemethod when the preferred card network changed.
- [Fixed] Fixed a scroll issue with native 3DS2 authentication screen when the keyboard appears.
- [Added] When a card is saved (ie you're using a PaymentIntent + setup_future_usage or SetupIntent), legal disclaimer text now appears below the form indicating the card can be charged for future payments.
- [Fixed] iOS 18 Compatibility with removing multiple saved payment methods
- [Fixed] Fixed an issue where the keyboard could focus on a hidden phone number field.
- [Added] Support for Sunbit (Private Beta) with PaymentIntents.
- [Added] Support for Billie (Private Beta) with PaymentIntents.
- [Fixed] Fixed an issue where saved payment method UI wouldn't respect
PaymentSheet.Configuration.stylewhen selected. - [Added] Support for Satispay (Private Beta) with PaymentIntents.
- [Added] Support for Sunbit (Private Beta) bindings.
- [Added] Support for Billie (Private Beta) bindings.
- [Added] Support for Satispay (Private Beta) bindings.
This release was made in error, and contains changes from 23.29.0, 23.29.1, and 23.29.2.
- [Fixed] Improved reliability when paying or setting up with Cash App Pay.
- [Fixed] Pass stripeAccount context when presenting PayWithLinkWebController for connected accounts
- [Fixed] An issue where the correct card brand was not being displayed for card brand choice in STPPaymentOptionsViewController and STPPaymentContext.
- [Added] Adds coupon support to STPApplePayContext with a new
didChangeCouponCodedelegate method (h/t @JoeyLeeMEA). - [Fixed] Fixed an issue where successful TWINT payments were sometimes incorrectly considered 'canceled'.
- [Fixed] Fixed an issue where certain cobranded cards showed a generic card icon instead of using the other card brand.
- [Fixed] Fixed an issue where amounts with currency=IDR were displayed as-is, instead of dropping the last two digits.
- [Fixed] Fixed an issue where some payment method images in the horizontal scrollview could briefly flash.
- [Fixed] Improved reliability when paying with Swish.
- [Fixed] An issue that was preventing users from completing checkout with SetupIntents and PaymentIntents using
setup_future_usagefor the following payment method types: Amazon Pay, Cash App Pay, PayPal, and Revolut Pay.
- [Fixed] Fixed an issue where when displaying an LPM with no input fields, the sheet would take up the entire height of the screen.
- [Fixed] Fixed an issue where changing the country of a phone number would not update the UI when the phone number's validity changed.
- [Changed] The "save this card" checkbox is now unchecked by default. To change this behavior, set your PaymentSheet.Configuration.savePaymentMethodOptInBehavior to
.requiresOptOut. - [Fixed] Fixed an issue where PaymentSheet would not present in the iOS 18 beta when using SwiftUI.
- [Fixed] Fixed an issue in PaymentSheet.FlowController that could lead to the CVC recollection form being shown on presentPaymentOptions()
- [Fixed] Fixed an issue where CustomerSheet would not present in the iOS 18 beta when using SwiftUI.
- [Added] Updated support for MobilePay bindings.
- [Changed] Some Payment Methods (including Klarna and PayPal) may now authenticate using ASWebAuthenticationSession, enabling these payment methods to share session storage across apps.
- [Fixed] Fixed printing spurious STPAssertionFailure warnings.
- [Changed] ScannedCard to allow access for expiryMonth, expiryYear and name.
- [Added] Support for Multibanco with PaymentIntents.
- [Fixed] Fixed an issue where STPPaymentHandler sometimes reported errors using
unexpectedErrorCodeinstead of a more specific error when customers fail a next action. - [Changed] PaymentSheet displays Apple Pay as a button when there are saved payment methods and Link isn't available instead of within the list of saved payment methods.
- [Fixed] Expiration dates more than 50 years in the past (e.g.
95) are now blocked.
- [Added] Support for Multibanco bindings.
- [Fixed] Expiration dates more than 50 years in the past (e.g.
95) are now blocked.
- [Fixed] An issue where the PrivacyInfo.xcprivacy was not bundled with StripePayments when installing with Cocoapods.
- [Changed] Apple Pay additionalEnabledApplePayNetworks are now in front of the supported network list.
- [Added] Added support for
onBehalfOfto STPPaymentCardTextField and STPCardFormView. This parameter may be required when setting a connected account as the merchant of record for a payment. For more information, see the Connect docs.
- [Added] Support for Alma bindings.
- [Fixed] STPBankAccountCollector errors now use "STPBankAccountCollectorErrorDomain" instead of "STPPaymentHandlerErrorDomain".
- [Fixed] Fixed an issue with generating App Privacy reports.
- [Fixed] When confirming a SetupIntent with Link, "Set up" will be shown as the confirm button text instead of "Pay".
- [Fixed] Fixed an issue dismissing the sheet when Link is the default payment method.
- [Fixed] Improved the UX of an edge case in Financial Connections authentication flow.
- Added a Privacy Manifest.
- Xcode 14 is no longer supported by Apple. Please upgrade to Xcode 15 or later.
- [Fixed] A bug where
PaymentSheet.FlowControllerwas not respectingPaymentSheet.Configuration.primaryButtonLabel. - [Added] Support for Klarna with SetupIntents and PaymentIntents with
setup_future_usage.
- [Changed] Updated the design of Financial Connections authentication flow.
- [Added] Added
paymentMethodTypesinCustomerAdapterto control what payment methods are displayed.
- [Fixed] The rotating card brand view is now shown when card brand choice is enabled if the card number is empty.
- [Fixed] Fixed an assertionFailure that happens when using FlowController and switching between saved payment methods
- [Added] Added support for Link in PaymentSheet. Enabling Link in your payment method settings will enable Link in PaymentSheet. To choose different Link availability settings on web and mobile, use a custom payment method configuration.
- [Fixed] Fixed an issue where some 3DS2 payments may fail to complete successfully.
- [Added] Support for Amazon Pay bindings.
- [Added] Added support for payment method configurations when using the deferred intent integration path.
- [Fixed] Fixed a bug where if an exception is thrown in detachPaymentMethod(), the payment method was removed in the UI #3309
-
[Changed] The separator text under the Apple Pay button from "Or pay with a card" to "Or use a card" when using a SetupIntent.
-
[Fixed] Fixed a bug where deleting the last saved payment method in PaymentSheet wouldn't automatically transition to the "Add a payment method" screen.
-
[Added] Support for CVC recollection in PaymentSheet and PaymentSheet.FlowController (client-side confirmation)
-
[Changed] Make STPPinManagementService still usable from Swift.
- [Changed] We now auto append
mandate_datawhen using Klarna with a SetupIntent. If you are interested in using Klarna with SetupIntents you sign up for the beta here.
- [Changed] Increased the maximum number of status update retries when waiting for an intent to update to a terminal state. This impacts Cash App Pay and 3DS2.
- [Fixed] Fixed a few design issues on visionOS.
- [Added] Added billing details and type properties to
PaymentSheet.FlowController.PaymentOptionDisplayData.
- [Added] Support for card brand choice. To set default preferred networks, use the new configuration option
PaymentSheet.Configuration.preferredNetworks. - [Fixed] Fixed visionOS support in Swift Package Manager and Cocoapods.
- [Added] Support for card brand choice. To set default preferred networks, use the new configuration option
PaymentSheet.Configuration.preferredNetworks.
-
[Added] Adds support for card brand choice to STPPaymentCardTextField and STPCardFormView. To set a default preferred network for these UI elements, use the new
preferredNetworksparameter. -
[Changed] Mark STPPinManagementService deprecated & suggest alternative.
- [Fixed] STPApplePayContext initializer returns nil in more cases where the request is invalid.
- [Fixed] STPApplePayContext now allows Apple Pay when the customer doesn’t have saved cards but can set them up in the Apple Pay sheet (iOS 15+).
- [Fixed] PaymentSheet sets newly saved payment methods as the default so that they're pre-selected the next time the customer pays.
- [Added] PaymentSheet now supports external payment methods. See https://stripe.com/docs/payments/external-payment-methods?platform=ios
- [Added] Saved SEPA payment methods are now displayed to the customer for reuse, similar to saved cards.
- [Fixed] Visual bug where re-presenting PaymentSheet wouldn't show a spinner while it reloads.
- [Added] If PaymentSheet fails to load a deferred intent configuration, we fall back to displaying cards (or the intent configuration payment method types) instead of failing.
- [Fixed] Fixed an issue where PaymentSheet wouldn't accept valid Mexican phone numbers.
- [Added] The ability to customize the success colors of the primary button with
PaymentSheetAppearance.primaryButton.successBackgroundColorandPaymentSheetAppearance.primaryButton.successTextColor.
- [Fixed] CustomerSheet no longer displays saved cards that originated from Apple Pay or Google Pay.
- [Fixed] Added a public initializer for
PaymentSheet.BillingDetails. - [Fixed] Fixed some payment method icons not updating to use the latest assets.
- [Fixed] PaymentSheet no longer displays saved cards that originated from Apple Pay or Google Pay.
- [Fixed] Fixed an issue with
STPPaymentCardTextFieldwhere thepaymentCardTextFieldDidEndEditingdelegate method was not called.
- [Fixed] Fixed some payment method icons not updating to use the latest assets.
- [Added] Saved SEPA payment methods are now displayed to the customer for reuse, similar to saved cards.
- [Fixed] Fixed an issue where the unknown card icon would sometimes pick up the view's tint color.
- [Fixed] An issue with
STPPaymentCardTextField, where the card params were not updated after deleting an empty sub field. - [Fixed] Switched to Asset Catalogs and updated to the latest card brand logos.
- [Added] Support for MobilePay bindings.
- [Fixed] Fixed an issue when advancing from the country dropdown that prevented user's' from typing in their postal code. (#2936)
- [Fixed] An issue with
STPPaymentCardTextField, where thepaymentCardTextFieldDidChangedelegate method wasn't being called after deleting an empty sub field.
- [Fixed] Fixed an issue with selecting from lists on macOS Catalyst. Note that only macOS 11 or later is supported: We do not recommend releasing a Catalyst app targeting macOS 10.15.
- [Fixed] Fixed an issue with scanning card expiration dates.
- [Fixed] Fixed an issue where billing address collection configuration was not passed to Apple Pay.
- [Added] Support for Swish with PaymentIntents.
- [Added] Support for Bacs Direct Debit with PaymentIntents.
- [Fixed] Fixed an issue with scanning card expiration dates.
- [Fixed] Fixed an issue where amounts in Serbian Dinar were displayed incorrectly.
- [Fixed] Fixed an issue where the SDK could hang in macOS Catalyst.
- [Added] Support for Swish bindings.
- [Added] Properties of STPConnectAccountParams are now mutable.
- [Fixed] Fixed STPConnectAccountCompanyParams.address being force unwrapped. It's now optional.
- [Added] Support for RevolutPay bindings
- [Added] Support for Alipay with PaymentIntents.
- [Added] Support for Cash App Pay with SetupIntents and PaymentIntents with
setup_future_usage. - [Added] Support for AU BECS Debit with SetupIntents.
- [Added] Support for OXXO with PaymentIntents.
- [Added] Support for Konbini with PaymentIntents.
- [Added] Support for PayNow with PaymentIntents.
- [Added] Support for PromptPay with PaymentIntents.
- [Added] Support for Boleto with PaymentIntents and SetupIntets.
- [Added] Support for External Payment Method as an invite-only private beta.
- [Added] Support for RevolutPay with SetupIntents and PaymentIntents with setup_future_usage (private beta). Note: PaymentSheet doesn't display this as a saved payment method yet.
- [Added] Support for Alma (Private Beta) with PaymentIntents.
- [Added] Support for AmazonPay (private beta), BLIK, and FPX with PaymentIntents.
- [Fixed] A bug where payment amounts were not displayed correctly for LAK currency.
- Fixed a compile-time issue with using StripeApplePay in an App Extension. (#2853)
- [Added]
CustomerSheet(https://stripe.com/docs/elements/customer-sheet?platform=ios) API, a prebuilt UI component that lets your customers manage their saved payment methods.
- Improved redirect UX when using Cash App Pay.
- [Added] Support for GrabPay with PaymentIntents.
- [Added] You can now create an STPConnectAccountParams without specifying a business type.
- [Added] Adds
applePayLaterAvailabilitytoSTPPaymentContext, a property that mirrorsPKPaymentRequest.applePayLaterAvailability. This is useful if you need to disable Apple Pay Later. Note: iOS 17+.
- [Fixed] Fixed compatibility with Xcode 15 beta 3. visionOS is now supported in iPadOS compatibility mode.
- [Added] Enable bancontact and sofort for SetupIntents and PaymentIntents with setup_future_usage. Note: PaymentSheet doesn't display saved SEPA Debit payment methods yet.
- [Added]
us_bank_accountPaymentMethod is now available in CustomerSheet
- [Added] Enable SEPA Debit and iDEAL for SetupIntents and PaymentIntents with setup_future_usage. Note: PaymentSheet doesn't display saved SEPA Debit payment methods yet.
- [Added] Add removeSavedPaymentMethodMessage to PaymentSheet.Configuration and CustomerSheet.Configuration.
- [Added] Supports phone verification in Identity mobile SDK.
- [Fixed] Update stp_icon_add@3x.png to 8bit color depth (Thanks @jszumski)
- [Fixed] Ability to removing payment method immediately after adding it.
- [Fixed] Re-init addPaymentMethodViewController after adding payment method to allow for adding another payment method
- [Fixed] Fixed various bugs in Link private beta.
- [Changed] Breaking interface change for
CustomerSheetResult.CustomerSheetResult.cancelednow has a nullable associated value signifying that there is no selected payment method. Please use both.canceled(StripeOptionSelection?)and.selected(PaymentOptionSelection?)to update your UI to show the latest selected payment method.
- [Fixed] A bug where
mandate_datawas not being properly attached to PayPal SetupIntent's.
- [Added] You can now collect payment details before creating a PaymentIntent or SetupIntent. See our docs for more info. This integration also allows you to confirm the Intent on the server.
- [Added] US bank accounts are now supported when initializing with an IntentConfiguration.
- [Fixed] Affirm no longer requires shipping details.
- [Added] Added
billingDetailsCollectionConfigurationto configure how you want to collect billing details (private beta).
- [Fixed] Fixed a bug causing Cash App Pay SetupIntents to incorrectly state they were canceled when they succeeded.
- [Fixed] A bug that was causing
addressViewControllerDidFinishto return a non-nilAddressDetailswhen the user cancels out of the AddressElement when default values are provided. - [Fixed] A bug that prevented the auto complete view from being presented when the AddressElement was created with default values.
- [Fixed] Fixed validating the IntentConfiguration matches the PaymentIntent/SetupIntent when it was already confirmed on the server. Note: server-side confirmation is in private beta.
- [Fixed] Fixed bug with removing multiple saved payment methods
- [Changed] The private beta API for https://stripe.com/docs/payments/finalize-payments-on-the-server has changed:
- If you use
IntentConfiguration(..., confirmHandler:), the confirm handler now has an additionalshouldSavePaymentMethod: Boolparameter that you should ignore. - If you use
IntentConfiguration(..., confirmHandlerForServerSideConfirmation:), useIntentConfiguration(..., confirmHandler:)instead. Additionally, the confirm handler's first parameter is now anSTPPaymentMethodobject instead of a String id. UsepaymentMethod.stripeIdto get its id and send it to your server.
- If you use
- [Fixed] Fixed PKR currency formatting.
- [Added] CustomerSheet is now available (private beta)
- [Added] Added test mode M1 for the SDK.
- [Fixed] STPPaymentHandler.handleNextAction allows payment methods that are delayed or require further customer action like like SEPA Debit or OXXO.
- [Fixed] Fixed disabled text color, using a lower opacity version of the original color instead of the previous
.tertiaryLabel.
- [Added] Added test mode for the SDK.
- [Fixed] Fixed UnionPay cards appearing as invalid in some cases.
- [Fixed] Fixed a bug that prevents users from using SEPA Debit w/ PaymentIntents or SetupIntents and Paypal in PaymentIntent+setup_future_usage or SetupIntent.
- Xcode 13 is no longer supported by Apple. Please upgrade to Xcode 14.1 or later.
- [Fixed] Visual bug of the delete icon when deleting saved payment methods reported in #2461.
- [Added] Added
billingDetailsCollectionConfigurationto configure how you want to collect billing details. See the docs here.
- [Fixed] Fixed amounts in COP being formatted incorrectly.
- [Fixed] Fixed BLIK payment bindings not handling next actions correctly.
- [Changed] Removed usage of
UIDevice.currentDevice.name.
- [Added] Added a retake photo button on selfie scanning screen.
- [Added] API bindings support for Cash App Pay. See the docs here.
- [Added] Added
STPCardValidator.possibleBrands(forCard:completion:), which returns the list of available networks for a card.
- [Added] Support for Cash App Pay in PaymentSheet.
- [Added] ID/Address verification.
- [Added] Debug logging to help identify why specific payment methods are not showing up in PaymentSheet.
- [Fixed] Race condition reported in #2302
- [Added] Adds support for setting up PayPal using a SetupIntent or a PaymentIntent w/ setup_future_usage=off_session. Note: PayPal is in beta.
- [Changed] Polished Financial Connections UI.
- [Changed] Updated image asset for AFFIN bank.
- [Fixed] Double encoding of GET parameters.
- [Changed] Using Tuist to generate Xcode projects. From now on, only release versions of the SDK will include Xcode project files, in case you want to build a non release revision from source, you can follow these instructions to generate the project files. For Carthage users, this also means that you will only be able to depend on release versions.
- [Added]
PaymentSheetErrornow conforms toCustomDebugStringConvertibleand has a more useful description when no payment method types are available. - [Changed] Customers can now re-enter the autocomplete flow of
AddressViewControllerby tapping an icon in the line 1 text field.
- [Fixed] Fixed a bug where 3 decimal place currencies were not being formatted properly.
- [Fixed] Fixed an issue that caused animations of the card logos in the Card input field to glitch.
- [Fixed] Fixed a layout issue in the "Save my info" checkbox.
- [Added] Added logos of accepted card brands on Card input field.
- [Fixed] Fixed erroneously displaying the card scan button when card scanning is not available.
- [Changed] FinancialConnectionsSheet methods now require to be called from non-extensions.
- [Changed] BankAccountToken.bankAccount was changed to an optional.
- [Added] Added
AddressViewController, a customizable view controller that collects local and international addresses for your customers. See https://stripe.com/docs/elements/address-element?platform=ios. - [Added] Added
PaymentSheet.Configuration.allowsPaymentMethodsRequiringShippingAddress. Previously, to allow payment methods that require a shipping address (e.g. Afterpay and Affirm) in PaymentSheet, you attached a shipping address to the PaymentIntent before initializing PaymentSheet. Now, you can instead set this property totrueand setPaymentSheet.Configuration.shippingDetailsto a closure that returns your customers' shipping address. The shipping address will be attached to the PaymentIntent when the customer completes the checkout. - [Fixed] Fixed user facing error messages for card related errors.
- [Fixed] Fixed
setup_future_usagevalue being set when there's no customer.
- [Fixed] Fixed an issue with linking the StripePayments SDK in certain configurations.
- [Added] Added a README.md for the
CardScanSheetintegration.
- [Added] Added parameters to customize the primary button and Apple Pay button labels. They can be found under
PaymentSheet.Configuration.primaryButtonLabelandPaymentSheet.ApplePayConfiguration.buttonTyperespectively.
- [Changed] Reduced the size of the SDK by splitting the
Stripemodule intoStripePaymentSheet,StripePayments, andStripePaymentsUI. Some manual changes may be required. Migration instructions are available at https://stripe.com/docs/mobile/ios/sdk-23-migration.
| Module | Description | Compressed | Uncompressed |
|---|---|---|---|
| StripePaymentSheet | Stripe's prebuilt payment UI. | 2.7MB | 6.3MB |
| Stripe | Contains all the below frameworks, plus Issuing and Basic Integration. | 2.3MB | 5.1MB |
| StripeApplePay | Apple Pay support, including STPApplePayContext. |
0.4MB | 1.0MB |
| StripePayments | Bindings for the Stripe Payments API. | 1.0MB | 2.6MB |
| StripePaymentsUI | Bindings for the Stripe Payments API, STPPaymentCardTextField, STPCardFormView, and other UI elements. | 1.7MB | 3.9MB |
- [Changed] The minimum iOS version is now 13.0. If you'd like to deploy for iOS 12.0, please use Stripe SDK 22.8.4.
- [Changed] STPPaymentCardTextField's
cardParamsparameter has been deprecated in favor ofpaymentMethodParams, making it easier to include the postal code from the card field. If you need to access theSTPPaymentMethodCardParams, use.paymentMethodParams.card.
- [Fixed] Fixed a validation issue where cards expiring at the end of the current month were incorrectly treated as expired.
- [Fixed] Fixed a visual bug in iOS 16 where advancing between text fields would momentarily dismiss the keyboard.
- [Fixed] Use
.formSheetmodal presentation in Mac Catalyst. #2023 (Thanks sergiocampama!)
- [Changed] Support uploading single side documents.
- [Fixed] Fixed Xcode 14 support.
- [Fixed] Fixes an issue of returning canceled result from FinancialConnections if user taps cancel on the manual entry success screen.
- [Added] Added a new parameter to CardScanSheet.present() to specify if the presentation should be done animated or not. Defaults to true.
- [Changed] Changed card scan ML model loading to be async.
- [Changed] Changed minimum deployment target for card scan to iOS 13.
- [Fixed] Fixed potential crash when using Link in Mac Catalyst.
- [Fixed] Fixed Right-to-Left (RTL) layout issues.
- [Fixed] Fixed an issue where
applePayContext:willCompleteWithResult:authorizationResult:handler:may not be called in Objective-C implementations ofSTPApplePayContextDelegate.
- [Changed] Renamed
PaymentSheet.reset()toPaymentSheet.resetCustomer(). SeeMIGRATING.mdfor more info. - [Added] You can now set closures in
PaymentSheet.ApplePayConfiguration.customHandlersto configure the PKPaymentRequest and PKPaymentAuthorizationResult during a transaction. This enables you to build support for Merchant Tokens and Order Tracking in iOS 16.
- [Added] You can now implement the
applePayContext(_:willCompleteWithResult:handler:)function in yourApplePayContextDelegateto configure the PKPaymentAuthorizationResult during a transaction. This enables you to build support for Order Tracking in iOS 16.
- [Fixed] Fixed Mac Catalyst support in Xcode 14. #2001
- [Fixed] PaymentSheet now uses configuration.apiClient for Apple Pay instead of always using STPAPIClient.shared.
- [Fixed] Fixed a layout issue with PaymentSheet in landscape.
- [Fixed] Fixed a layout issue on iPad.
- [Changed] Improved Link support in custom flow (
PaymentSheet.FlowController).
- [Added] PaymentSheet now supports Link payment method.
- [Changed] Change behavior of Afterpay/Clearpay: Charge in 3 for GB, FR, and ES
- [Changed] Postal code is no longer collected for billing addresses in Japan.
- [Added] The ability to capture Selfie images in the native component flow.
- [Fixed] Fixed an issue where the welcome and confirmation screens were not correctly decoding non-ascii characters.
- [Fixed] Fixed an issue where, if a manually uploaded document could not be decoded on the server, there was no way to select a new image to upload.
- [Fixed] Fixed an issue where the IdentityVerificationSheet completion block was called early when manually uploading a document image instead of using auto-capture.
- [Fixed] Fixed an issue with
STPPaymentHandlerwhere returning an app redirect could cause a crash.
- [Added] You can now use
PaymentSheet.ApplePayConfiguration.paymentSummaryItemsto directly configure the payment summary items displayed in the Apple Pay sheet. This is useful for recurring payments.
- [Added] The ability to customize the appearance of the PaymentSheet using
PaymentSheet.Appearance. - [Added] Support for collecting payments from customers in 54 additional countries within PaymentSheet. Most of these countries are located in Africa and the Middle East.
- [Added]
affirmandAUBECSDebitpayment methods are now available in PaymentSheet
- [Added] Added privacy text to the CardImageVerification Sheet UI
- [Fixed] Fixed an issue where ApplePayContext failed to parse an API response if the funding source was unknown.
- [Fixed] Fixed an issue where PaymentIntent confirmation could fail when the user closes the challenge window immediately after successfully completing a challenge
- [Fixed] Fixed an issue where the verification flow would get stuck in a document upload loop when verifying with a passport and uploading an image manually.
- [Added]
us_bank_accountPaymentMethod is now available in payment sheet
- [Changed]
StripeConnectionsSDK has been renamed toStripeFinancialConnections. SeeMIGRATING.mdfor more info.
- [Fixed] Fixed an issue where
source_cancelAPI requests were being made for non-3DS payment method types. - [Fixed] Fixed an issue where certain error messages were not being localized.
- [Added]
us_bank_accountPaymentMethod is now available in PaymentSheet.
- [Fixed] Minor UI fixes when using
IdentityVerificationSheetwith native components - [Changed] Improvements to native component
IdentityVerificationSheetdocument detection
- [Fixed] Fixes VerificationClientSecret (Thanks Masataka-n!)
- [Changed] Localization improvements.
- [Added]
IdentityVerificationSheetcan now be used with native iOS components.
- [Changed] The minimum iOS version is now 12.0. If you'd like to deploy for iOS 11.0, please use Stripe SDK 21.12.0.
- [Added]
us_bank_accountPaymentMethod is now available for ACH Direct Debit payments, including APIs to collect customer bank information (requiresStripeConnections) and verify microdeposits. - [Added]
StripeConnectionsSDK can be optionally included to support ACH Direct Debit payments.
- [Changed] PaymentSheet now uses light and dark mode agnostic icons for payment method types.
- [Changed] Link payment method (private beta) UX improvements.
- [Changed]
IdentityVerificationSheetnow has an availability requirement of iOS 14.3 on its initializer instead of thepresentmethod.
- [Changed] Binary framework distribution now requires Xcode 13. Carthage users using Xcode 12 need to add the
--no-use-binariesflag.
- [Fixed] Fixed potential crash when using PaymentSheet custom flow with SwiftUI.
- [Fixed] Fixed being unable to cancel native 3DS2 in PaymentSheet.
- [Fixed] The payment method icons will now use the correct colors when PaymentSheet is configured with
alwaysLightoralwaysDark. - [Fixed] A race condition when setting the
primaryButtonColoronPaymentSheet.Configuration. - [Added] PaymentSheet now supports Link (private beta).
- [Added] The
CardImageVerificationSheetinitializer can now take an additionalConfigurationobject.
- [Added] We now offer a 1MB Apple Pay SDK module intended for use in an App Clip. Visit our App Clips docs for details.
Stripenow requiresStripeApplePay. SeeMIGRATING.mdfor more info.- [Added] Added a convenience initializer to create an STPCardParams from an STPPaymentMethodParams.
- [Changed] The "save this card" checkbox in PaymentSheet is now unchecked by default in non-US countries.
- [Fixed] Fixes issue that could cause symbol name collisions when using Objective-C
- [Fixed] Fixes potential crash when using PaymentSheet with SwiftUI
- Fixes a build warning in SPM caused by an invalid Package.swift file.
- [Changed] The maximum
identity_documentfile upload size has been increased, improving the quality of compressed images. See https://stripe.com/docs/file-upload - [Fixed] The maximum
dispute_evidencefile upload size has been decreased to match server requirements, preventing the server from rejecting uploads that exceeded 5MB. See https://stripe.com/docs/file-upload - [Added] PaymentSheet now supports Afterpay / Clearpay, EPS, Giropay, Klarna, Paypal (private beta), and P24.
- Added API bindings for Klarna
StripeIdentitynow requiresStripeCameraCore. SeeMIGRATING.mdfor more info.- Releasing
StripeCardScanBeta iOS SDK - Fixes a bug where the text field would cause a crash when typing a space (U+0020) followed by pressing the backspace key on iPad. #1907 (Thanks buhikon!)
- Fixes a build warning caused by a duplicate NSURLComponents+Stripe.swift file.
This release adds several new features to PaymentSheet, our drop-in UI integration:
The list of supported payment methods depends on your integration. If you’re using a PaymentIntent, we support:
- Card
- SEPA Debit, bancontact, iDEAL, sofort
If you’re using a PaymentIntent with setup_future_usage or a SetupIntent, we support:
- Card
- Apple/GooglePay
Note: To enable SEPA Debit and sofort, set PaymentSheet.configuration.allowsDelayedPaymentMethods to true on the client.
These payment methods can't guarantee you will receive funds from your customer at the end of the checkout because they take time to settle. Don't enable these if your business requires immediate payment (e.g., an on-demand service). See https://stripe.com/payments/payment-methods-guide
PaymentSheet collects billing details like name and email for certain payment methods. Pre-fill these fields to save customers time by setting PaymentSheet.Configuration.defaultBillingDetails.
This is currently only available for cards + Apple/Google Pay.
PaymentSheet supports PaymentIntents with setup_future_usage set. This property tells us to save the payment method for future use (e.g., taking initial payment of a recurring subscription).
When set, PaymentSheet hides the 'Save this card for future use' checkbox and always saves.
This is currently only available for cards + Apple/Google Pay.
Initialize PaymentSheet with a SetupIntent to set up cards for future use without charging.
When a customer is adding a new payment method, PaymentSheet uses information like the customers region to show the most relevant payment methods first.
- Postal code collection for cards is now limited to US, CA, UK
- Fixed SwiftUI memory leaks Issue #1881
- Added "hint" for error messages
- Adds many new localizations. The SDK now localizes in the following languages: bg-BG,ca-ES,cs-CZ,da,de,el-GR,en-GB,es-419,es,et-EE,fi,fil,fr-CA,fr,hr,hu,id,it,ja,ko,lt-LT,lv-LV,ms-MY,mt,nb,nl,nn-NO,pl-PL,pt-BR,pt-PT,ro-RO,ru,sk-SK,sl-SI,sv,tk,tr,vi,zh-Hans,zh-Hant,zh-HK
StripeandStripeIdentitynow requireStripeUICore. SeeMIGRATING.mdfor more info.
- Fixes an issue with image loading when using Swift Package Manager.
- Temporarily disabled WeChat Pay support in PaymentMethods.
- The
Stripemodule now requiresStripeCore. SeeMIGRATING.mdfor more info.
- Fixes broken card scanning links. (Thanks ricsantos)
- Fixes accessibilityLabel for postal code field. (Thanks romanilchyshyndepop)
- Improves compile time by 30% #1846 (Thanks JonathanDowning!)
- Releasing
StripeIdentityiOS SDK for use with Stripe Identity.
- Fixes an issue with
additionaDocumentfield typo #1833 - Adds support for WeChat Pay to PaymentMethods
- Weak-links SwiftUI #1828
- Adds 3DS2 support for Cartes Bancaires
- Fixes an issue with camera rotation during card scanning on iPad
- Fixes an issue where PaymentSheet could cause conflicts when included in an app that also includes PanModal #1818
- Fixes an issue with building on Xcode 13 #1822
- Fixes an issue where overriding STPPaymentCardTextField's
brandImage()func had no effect #1827 - Fixes documentation typo. (Thanks iAugux)
- Adds
STPCardFormView, a UI component that collects card details - Adds 'STPRadarSession'. Note this requires additional Stripe permissions to use.
- Fixes the
PaymentSheetAPI not being public. - Fixes an issue with missing headers. (Thanks jctrouble!)
- Adds the
PaymentSheet(https://stripe.dev/stripe-ios/docs/Classes/PaymentSheet.html) API, a prebuilt payment UI. - Fixes Mac Catalyst support in Xcode 12.5 #1797
- Fixes
STPPaymentCardTextFieldnot being open #1768
- Fixed warnings in Xcode 12.5. #1772
- Fixes a layout issue when confirming payments in SwiftUI. #1761 (Thanks mvarie!)
- Fixes a potential race condition when finalizing 3DS2 confirmations.
- Fixes an issue where a 3DS2 transaction could result in an incorrect error message when the card number is incorrect. #1778
- Fixes an issue where
STPPaymentHandler.shared().handleNextActionsometimes didn't return ahandleActionError. #1769 - Fixes a layout issue when confirming payments in SwiftUI. #1761 (Thanks mvarie!)
- Fixes an issue with opening URLs on Mac Catalyst
- Fixes an issue where OXXO next action is mistaken for a cancel in STPPaymentHandler
- SetupIntents for iDEAL, Bancontact, EPS, and Sofort will now send the required mandate information.
- Adds support for BLIK.
- Adds
decline_codeinformation to STPError. #1755 - Adds support for SetupIntents to STPApplePayContext
- Allows STPPaymentCardTextField to be subclassed. #1768
- Adds support for Maestro in Apple Pay on iOS 12 or later.
- Adds support for SwiftUI in custom integration using the
STPPaymentCardTextField.RepresentableView and the.paymentConfirmationSheet()ViewModifier. SeeIntegrationTesterfor usage examples. - Removes the UIViewController requirement from STPApplePayContext, allowing it to be used in SwiftUI.
- Fixes an issue where
STPPaymentOptionsViewControllercould fail to register a card. #1758 - Fixes an issue where some UnionPay test cards were marked as invalid. #1759
- Updates tests to run on Carthage 0.37 with .xcframeworks.
- Fixed an issue where a payment card text field could resize incorrectly on smaller devices or with certain languages. #1600
- Fixed an issue where the SDK could always return English strings in certain situations. #1677 (Thanks glaures-ioki!)
- Fixed an issue where an STPTheme had no effect on the navigation bar. #1753 (Thanks @rbenna!)
- Fixed handling of nil region codes. #1752
- Fixed an issue preventing card scanning from being disabled. #1751
- Fixed an issue with enabling card scanning in an app with a localized Info.plist.#1745
- Added a missing additionalDocument parameter to STPConnectAccountIndividualVerification.
- Added support for Afterpay/Clearpay.
- Stripe3DS2 is now open source software under the MIT License.
- Fixed various issues with bundling Stripe3DS2 in Cocoapods and Swift Package Manager. All binary dependencies have been removed.
- Fixed an infinite loop during layout on small screen sizes. #1731
- Fixed issues with missing image assets when using Cocoapods. #1655 #1722
- Fixed an issue which resulted in unnecessary queries to the BIN information service.
- Adds the ability to
attachanddetachPaymentMethod IDs to/from a CustomerContext. #1729 - Adds support for NetBanking.
- Fixes a crash during manual confirmation of a 3DS2 payment. #1725
- Fixes an issue that could cause some image assets to be missing in certain configurations. #1722
- Fixes an issue with confirming Alipay transactions.
- Re-exposes
cardNumberparameter inSTPPaymentCardTextField. - Adds support for UPI.
- Fixes an issue with some initializers not being exposed publicly following the conversion to Swift.
- Updates GrabPay integration to support synchronous updates.
- The SDK is now written in Swift, and some manual changes are required. Migration instructions are available at https://stripe.com/docs/mobile/ios/sdk-21-migration.
- Adds full support for Apple silicon.
- Xcode 12.2 is now required.
- Fixes an issue when using Cocoapods 1.10 and Xcode 12. #1683
- Fixes a warning when using Swift Package Manager. #1675
- Adds support for OXXO. #1592
- Applies a workaround for various bugs in Swift Package Manager. #1671 Please see #1673 for additional notes when using Xcode 12.0.
- Card scanning now works when the device's orientation is unknown. #1659
- The expiration date field's Simplified Chinese localization has been corrected. (Thanks cythb!) #1654
- Card scanning is now built into STPAddCardViewController. Card.io support has been removed. #1629
- Shrunk the SDK from 1.3MB when compressed & thinned to 0.7MB, allowing for easier App Clips integration. #1643
- Swift Package Manager, Apple Silicon, and Catalyst are now fully supported on Xcode 12. #1644
- Adds support for 19-digit cards. #1608
- Adds GrabPay and Sofort as PaymentMethod. #1627
- Drops support for iOS 10. #1643
pkPaymentErrorForStripeErrorno longer returns PKPaymentUnknownErrors. Instead, it returns the original NSError back, resulting in dismissal of the Apple Pay sheet. This means ApplePayContext dismisses the Apple Pay sheet for all errors that aren't specifically PKPaymentError types.metadatafields are no longer populated on retrieved Stripe API objects and must be fetched on your server using your secret key. If this is causing issues with your deployed app versions please reach out to Stripe Support. These fields have been marked as deprecated and will be removed in a future SDK version.
- Adds giropay PaymentMethod bindings #1569
- Adds Przelewy24 (P24) PaymentMethod bindings #1556
- Adds Bancontact PaymentMethod bindings #1565
- Adds EPS PaymentMethod bindings #1578
- Replaces es-AR localization with es-419 for full Latin American Spanish support and updates multiple localizations #1549 #1570
- Fixes missing custom number placeholder in
STPPaymentCardTextField#1576 - Adds tabbing on external keyboard support to
STPAUBECSFormViewand correctly types it as aUIViewinstead ofUIControl#1580
- Adds ability to attach shipping details when confirming PaymentIntents #1558
STPApplePayContextnow provides shipping details in theapplePayContext:didCreatePaymentMethod:paymentInformation:completion:delegate method and automatically attaches shipping details to PaymentIntents (unless manual confirmation)#1561- Adds support for the BECS Direct Debit payment method for Stripe users in Australia #1547
- Add advancedFraudSignalsEnabled property #1560
- Relaxes need for dob for full name connect account (
STPConnectAccountIndividualParams). #1539 - Adds Chinese (Traditional) and Chinese (Hong Kong) localizations #1536
- Adds
STPApplePayContext, a helper class for Apple Pay. #1499 - Improves accessibility #1513, #1504
- Adds support for the Bacs Direct Debit payment method #1487
- Adds support for 16 digit Diners Club cards #1498
- Fixes an issue building with Xcode 11.4 #1526
- Deprecates the
STPAPIClientinitWithConfiguration:method. Set theconfigurationproperty on theSTPAPIClientinstance instead. #1474 - Deprecates
publishableKeyandstripeAccountproperties ofSTPPaymentConfiguration. See MIGRATING.md for more details. #1474 - Adds explicit STPAPIClient properties on all SDK components that make API requests. These default to
[STPAPIClient sharedClient]. This is a breaking change for some users ofstripeAccount. See MIGRATING.md for more details. #1469 - The user's postal code is now collected by default in countries that support postal codes. We always recommend collecting a postal code to increase card acceptance rates and reduce fraud. See MIGRATING.md for more details. #1479
- Adds support for Klarna Pay on Sources API #1444
- Compresses images using
pngcrushto reduce SDK size #1471 - Adds support for CVC recollection in PaymentIntent confirm #1473
- Fixes a race condition when setting
defaultPaymentMethodonSTPPaymentOptionsViewController#1476
- STPAddCardViewControllerDelegate methods previously removed in v16.0.0 are now marked as deprecated, to help migrating users #1439
- Fixes an issue where canceling 3DS authentication could leave PaymentIntents in an inaccurate
requires_actionstate #1443 - Fixes text color for large titles #1446
- Re-adds support for pre-selecting the last selected payment method in STPPaymentContext and STPPaymentOptionsViewController. #1445
- Fix crash when adding/removing postal code cells #1450
- Adds support for creating tokens with the last 4 digits of an SSN #1432
- Renames Standard Integration to Basic Integration
- Adds localizations for English (Great Britain), Korean, Russian, and Turkish #1373
- Adds support for SEPA Debit as a PaymentMethod #1415
- Adds support for custom SEPA Debit Mandate params with PaymentMethod #1420
- Improves postal code UI for users with mismatched regions #1302
- Fixes a potential crash when presenting the add card view controller #1426
- Adds offline status checking to FPX payment flows #1422
- Adds support for push provisions for Issuing users #1396
- Adds support for building on macOS 10.15 with Catalyst. Use the .xcframework file attached to the release in GitHub. Cocoapods support is coming soon. #1364
- Errors from the Payment Intents API are now localized by default. See MIGRATING.md for details.
- Adds support for FPX in Standard Integration. #1390
- Simplified Apple Pay integration when using 3DS2. #1386
- Improved autocomplete behavior for some STPPaymentHandler blocks. #1403
- Fixed spurious
keyboardWillAppearmessages triggered by STPPaymentTextCard. #1393 - Fixed an issue with non-numeric placeholders in STPPaymentTextCard. #1394
- Dropped support for iOS 9. Please continue to use 17.0.2 if you need to support iOS 9.
- Fixes an error that could prevent a 3D Secure 2 challenge dialog from appearing in certain situations.
- Improved VoiceOver support. #1384
- Updated Apple Pay and Mastercard branding. #1374
- Updated the Standard Integration example app to use automatic confirmation. #1363
- Added support for collecting email addresses and phone numbers from Apple Pay. #1372
- Introduced support for FPX payments. (Invite-only Beta) #1375
- Cancellation during the 3DS2 flow will no longer cause an unexpected error. #1353
- Large Title UIViewControllers will no longer have a transparent background in iOS 13. #1362
- Adds an
availableCountriesoption to STPPaymentConfiguration, allowing one to limit the list of countries in the address entry view. #1327 - Fixes a crash when using card.io. #1357
- Fixes an issue with birthdates when creating a Connect account. #1361
- Updates example code to Swift 5. #1354
- The default value of
[STPTheme translucentNavigationBar]is nowYES. #1367
- Adds support for iOS 13, including Dark Mode and minor bug fixes. #1307
- Updates API version from 2015-10-12 to 2019-05-16 #1254
- Adds
STPSourceRedirectStatusNotRequiredtoSTPSourceRedirectStatus. Previously, optional redirects were marked asSTPSourceRedirectStatusSucceeded. - Adds
STPSourceCard3DSecureStatusRecommendedtoSTPSourceCard3DSecureStatus. - Removes
STPLegalEntityParams. Initialize anSTPConnectAccountParamswith anindividualorcompanydictionary instead. See https://stripe.com/docs/api/tokens/create_account#create_account_token-account
- Adds
- Changes the
STPPaymentContextDelegate paymentContext:didCreatePaymentResult:completion:completion block type toSTPPaymentStatusBlock, to let you inform the context that the user canceled. - Adds initial support for WeChat Pay. #1326
- The user's billing address will now be included when creating a PaymentIntent from an Apple Pay token. #1334
- Fixes STPThreeDSUICustomization not initializing defaults correctly. #1303
- Fixes STPPaymentHandler treating post-authentication errors as authentication errors #1291
- Removes preferredStatusBarStyle from STPThreeDSUICustomization, see STPThreeDSNavigationBarCustomization.barStyle instead #1308
- Adds a method to STPAuthenticationContext allowing you to configure the SFSafariViewController presented for web-based authentication.
- Adds STPAddress initializer that takes STPPaymentMethodBillingDetails. #1278
- Adds convenience method to populate STPUserInformation with STPPaymentMethodBillingDetails. #1278
- STPShippingAddressViewController prefills billing address for PaymentMethods too now, not just Card. #1278
- Update libStripe3DS2.a to avoid a conflict with Firebase. #1293
- Fixed an compatibility issue when building with certain Cocoapods configurations. #1288
- Improved compatibility with other OpenSSL-using libraries. #1265
- Fixed compatibility with Xcode 10.1. #1273
- Fixed an issue where STPPaymentContext could be left in a bad state when cancelled. #1284
- Changes to code obfuscation, resolving an issue with App Store review #1269
- Adds Apple Pay support to STPPaymentHandler #1264
- Adds API to let users set a default payment option for Standard Integration #1252
- Removes querying the Advertising Identifier (IDFA).
- Adds customizable UIStatusBarStyle to STDSUICustomization.
- Migrates Stripe3DS2.framework to libStripe3DS2.a, resolving an issue with App Store validation. #1246
- Fixes a crash in STPPaymentHandler. #1244
- Migrates STPPaymentCardTextField.cardParams property type from STPCardParams to STPPaymentMethodCardParams
- STPAddCardViewController:
- Migrates addCardViewController:didCreateSource:completion: and addCardViewController:didCreateToken:completion: to addCardViewController:didCreatePaymentMethod:completion
- Removes managedAccountCurrency property - there’s no equivalent parameter necessary for PaymentMethods.
- STPPaymentOptionViewController now shows, adds, removes PaymentMethods instead of Source/Tokens.
- STPCustomerContext, STPBackendAPIAdapter:
- Removes selectDefaultCustomerSource:completion: - Users must explicitly select their Payment Method of choice.
- Migrates detachSourceFromCustomer:completion:, attachSourceToCustomer:completion to detachPaymentMethodFromCustomer:completion:, attachPaymentMethodToCustomer:completion:
- Adds listPaymentMethodsForCustomerWithCompletion: - the Customer object doesn’t contain attached Payment Methods; you must fetch it from the Payment Methods API.
- STPPaymentContext now uses the new Payment Method APIs listed above instead of Source/Token, and returns the reworked STPPaymentResult containing a PaymentMethod.
- Migrates STPPaymentResult.source to paymentMethod of type STPPaymentMethod
- Deprecates STPPaymentIntentAction* types, replaced by STPIntentAction*. #1208
- Deprecates
STPPaymentIntentAction, replaced bySTPIntentAction - Deprecates
STPPaymentIntentActionType, replaced bySTPIntentActionType - Deprecates
STPPaymentIntentActionRedirectToURL, replaced bySTPIntentActionTypeRedirectToURL
- Deprecates
- Adds support for SetupIntents. See https://stripe.com/docs/payments/cards/saving-cards#saving-card-without-payment
- Adds support for 3DS2 authentication. See https://stripe.com/docs/mobile/ios/authentication
- Adds configurable support for JCB (Apple Pay). #1158
- Updates sample apps to use
PaymentIntentsandPaymentMethodswhere available. #1159 - Changes
STPPaymentMethodCardParamsexpMonthandexpYearproperty types toNSNumber *to fix a bug using Apple Pay. #1161
- Renames all former references to 'PaymentMethod' to 'PaymentOption'. See MIGRATING.md for more details. #1139
- Renames
STPPaymentMethodtoSTPPaymentOption - Renames
STPPaymentMethodTypetoSTPPaymentOptionType - Renames
STPApplePaymentMethodtoSTPApplePayPaymentOption - Renames
STPPaymentMethodTupletoSTPPaymentOptionTuple - Renames
STPPaymentMethodsViewControllertoSTPPaymentOptionsViewController - Renames all properties, methods, comments referencing 'PaymentMethod' to 'PaymentOption'
- Renames
- Rewrites
STPaymentMethodandSTPPaymentMethodTypeto match the Stripe API. #1140. - Adds
[STPAPI createPaymentMethodWithParams:completion:], which creates a PaymentMethod. #1141 - Adds
paymentMethodParamsandpaymentMethodIdtoSTPPaymentIntentParams. You can now confirm a PaymentIntent with a PaymentMethod. #1142 - Adds
paymentMethodTypestoSTPPaymentIntent. - Deprecates several Source-named properties, based on changes to the Stripe API. #1146
- Deprecates
STPPaymentIntentParams.saveSourceToCustomer, replaced bysavePaymentMethod - Deprecates
STPPaymentIntentsStatusRequiresSource, replaced bySTPPaymentIntentsStatusRequiresPaymentMethod - Deprecates
STPPaymentIntentsStatusRequiresSourceAction, replaced bySTPPaymentIntentsStatusRequiresAction - Deprecates
STPPaymentIntentSourceAction, replaced bySTPPaymentIntentAction - Deprecates
STPPaymentSourceActionAuthorizeWithURL, replaced bySTPPaymentActionRedirectToURL - Deprecates
STPPaymentIntent.nextSourceAction, replaced bynextAction
- Deprecates
- Added new localizations for the following languages #1050
- Danish
- Spanish (Argentina/Latin America)
- French (Canada)
- Norwegian
- Portuguese (Brazil)
- Portuguese (Portugal)
- Swedish
- Deprecates
STPEphemeralKeyProvider, replaced bySTPCustomerEphemeralKeyProvider. We now allow for ephemeral keys that are not customer #1131 - Adds CVC image for Amex cards #1046
- Fixed
STPPaymentCardTextField.nextFirstResponderFieldto never return nil #1059 - Improves return key functionality for
STPPaymentCardTextField,STPAddCardViewController#1059 - Add postal code support for Saudi Arabia #1127
- CVC field updates validity if card number/brand change #1128
- Changes
STPPaymentCardTextField, which now copies thecardParamsproperty. See MIGRATING.md for more details. #1031 - Renames
STPPaymentIntentParams.returnUrltoSTPPaymentIntentParams.returnURL. #1037 - Removes
STPPaymentIntent.returnUrland addsSTPPaymentIntent.nextSourceAction, based on changes to the Stripe API. #1038 - Adds
STPVerificationParams.document_backproperty. #1017 - Fixes bug in
STPPaymentMethodsViewControllerwhere selected payment method changes back if it wasn't dismissed in thedidFinishdelegate method. #1020
- Adds
STPPaymentMethodprotocol implementation forSTPSource. You can now callimage/templatedImage/labelon a source. #976 - Fixes crash in
STPAddCardViewControllerwith some prefilled billing addresses #1004 - Fixes
STPPaymentCardTextFieldlayout issues on small screens #1009 - Fixes hidden text fields in
STPPaymentCardTextFieldfrom being read by VoiceOver #1012 - Updates example app to add client-side metadata
charge_request_idto requests toexample-ios-backend#1008
- Adds
STPPaymentIntentto support PaymentIntents. #985, #986, #987, #988 - Reduce
NSURLSessionmemory footprint. #969 - Fixes invalid JSON error when deleting
Cardfrom aCustomer. #992
- Fixes payment method label overlapping the checkmark, for Amex on small devices #952
- Adds EPS and Multibanco support to
STPSourceParams#961 - Adds
STPBillingAddressFieldsNameoption toSTPBillingAddressFields#964 - Fixes crash in
STPColorUtils.perceivedBrightnessForColor#954 - Applies recommended project changes for Xcode 9.4 #963
- Fixes
[Stripe handleStripeURLCallbackWithURL:url]incorrectly returningNO#962
- Makes iDEAL
nameparameter optional, also accepts empty string asnil#940 - Adjusts scroll view content offset behavior when focusing on a text field #943
- Fixes an issue in
STPRedirectContextcausing some redirecting sources to fail in live mode due to prematurely dismissing theSFSafariViewControllerduring the initial redirects. #937
- Removes Bitcoin source support. See MIGRATING.md. #931
- Adds Masterpass support to
STPSourceParams#928 - Adds community submitted Norwegian (nb) translation. Thank @Nailer!
- Fixes example app usage of localization files (they were not able to be tested in Finnish and Norwegian before)
- Silences STPAddress deprecation warnings we ignore to stay compatible with older iOS versions
- Fixes "Card IO" link in full SDK reference #913
- Updated the "62..." credit card number BIN range to show a UnionPay icon
- Fix issue with apple pay token creation in PaymentContext, introduced by 12.1.0. #899
- Now matches clang static analyzer settings with Cocoapods, so you won't see any more analyzer issues. #897
- Adds
createCardSourcestoSTPPaymentConfiguration. If you enable this option, when your user adds a card in the SDK's UI, a card source will be created and attached to their Stripe Customer. If this option is disabled (the default), a card token is created. For more information on card sources, see https://stripe.com/docs/sources/cards
- Adding Visa Checkout support to
STPSourceParams#889
- Minimum supported iOS version is now 9.0.
- If you need to support iOS 8, the last supported version is 11.5.0
- Minimum supported Xcode version is now 9.0
AddressBookframework support has been removed.STPRedirectContextwill no longer retain itself for the duration of the redirect, you must explicitly maintain a reference to it yourself. #846STPPaymentConfiguration.requiredShippingAddressnow is a set ofSTPContactFieldobjects instead of aPKAddressFieldbitmask. #848- See MIGRATING.md for more information on any of the previously mentioned breaking API changes.
- Pre-built view controllers now layout properly on iPhone X in landscape orientation, respecting
safeAreaInsets. #854 - Fixes a bug in
STPAddCardViewControllerthat prevented users in countries without postal codes from adding a card whenrequiredBillingFields = .Zip. #853 - Fixes a bug in
STPPaymentCardTextField. When completely filled out, it ignored calls tobecomeFirstResponder. #855 STPPaymentContextnow has alargeTitleDisplayModeproperty, which you can use to control the title display mode in the navigation bar of our pre-built view controllers. #849- Fixes a bug where
STPPaymentContext'sretryLoadingmethod would not re-retrieve the customer object, even after callingSTPCustomerContext'sclearCachedCustomermethod. #863 STPPaymentContext'sretryLoadingmethod will now always attempt to retrieve a new customer object, regardless of whether a cached customer object is available. Previously, this method was only intended for recovery from a loading error; if a customer had already been retrieved,retryLoadingwould do nothing. #863STPCustomerContexthas a new property:includeApplePaySources. It is turned off by default. #864- Adds
UITextContentTypesupport. This turns on QuickType suggestions for the name, email, and address fields; and uses a better keyboard for Payment Card fields. #870 - Fixes a bug that prevented redirects to the 3D Secure authentication flow when it was optional. #878
STPPaymentConfigurationnow has astripeAccountproperty, which can be used to make API requests on behalf of a Connected account. #875- Adds
- [STPAPIClient createTokenWithConnectAccount:completion:], which creates Tokens for Connect Accounts: (optionally) accepting the Terms of Service, and sending information about the legal entity. #876 - Fixes an iOS 11 bug in
STPPaymentCardTextFieldthat blocked tapping on the number field while editing the expiration or CVC on narrow devices (4" screens). #883
- Adds a new helper method to
STPSourceParamsfor creating reusable Alipay sources. #811 - Silences spurious availability warnings when using Xcode9 #823
- Auto capitalizes currency code when using
paymentRequestWithMerchantIdentifierto improve compatibility with iOS 11PKPaymentAuthorizationViewController#829 - Fixes a bug in
STPRedirectContextwhich causedSFSafariViewController-based redirects to incorrectly dismiss when switching apps. #833 - Fixes a bug that incorrectly offered users the option to "Use Billing Address" on the shipping address screen when there was no existing billing address to fill in. #834
- Restores
[STPCard brandFromString:]method which was marked as deprecated in a recent version #801 - Adds
[STPBankAccount metadata]and[STPCard metadata]read-only accessors and improves annotation for[STPSource metadata]#808 - Un-deprecates
STPBackendAPIAdapterand all associated methods. #813 - The
STPBackendAPIAdapterprotocol now includes two optional methods,detachSourceFromCustomerandupdateCustomerWithShipping. If you've implemented a class conforming toSTPBackendAPIAdapter, you may add implementations of these methods to support deleting cards from a customer and saving shipping info to a customer. #813 - Adds the ability to set custom footers on view controllers managed by the SDK. #792
STPPaymentMethodsViewControllerwill now display saved card sources in addition to saved card tokens. #810- Fixes a bug where certain requests would return a generic failed to parse response error instead of the actual API error. #809
- Adds support for creating
STPSourceParamsfor P24 source #779 - Adds support for native app-to-app Alipay redirects #783
- Fixes crash when
paymentContext.hostViewControlleris set to aUINavigationController#786 - Improves support and compatibility with iOS 11
- Changes and fixes methods on
STPCard,STPCardParams,STPBankAccount, andSTPBankAccountParamsto bring card objects more in line with the rest of the API. See MIGRATING for further details. - Adds nullability annotations to
STPPaymentMethodprotocol #753 - Improves the
[STPAPIResponseDecodable allResponseFields]by removing all instances of[NSNull null]including ones that are nested. See MIGRATING.md. #747
- Adds an option to allow users to delete payment methods from the
STPPaymentMethodsViewController. Enabled by default but can disabled using thecanDeletePaymentMethodsproperty ofSTPPaymentConfiguration. - Adds a postal code field to
STPPaymentCardTextField, configurable withpostalCodeEntryEnabledandpostalCodePlaceholder. Disabled by default. STPCustomer'sshippingAddressproperty is now correctly annotated as nullable.- Removed
STPCheckoutUnknownError,STPCheckoutTooManyAttemptsError, andSTPCustomerContextMissingKeyProviderError. These errors will no longer occur.
- Adds stripeAccount property to
STPAPIClient, set this to perform API requests on behalf of a connected account - Fixes the
routingNumberproperty ofSTPBankAccountso that it is populated when the information is available - Adds iOS Objective-C Style Guide
- We've greatly simplified the integration for
STPPaymentContext. See MIGRATING.md. - As part of this new integration, we've added a new class,
STPCustomerContext, which will automatically prefetch your customer and cache it for a brief interval. We recommend initializing yourSTPCustomerContextbefore your user enters your checkout flow so their payment methods are loaded in advance. If in addition to usingSTPPaymentContext, you create a separateSTPPaymentMethodsViewControllerto let your customer manage their payment methods outside of your checkout flow, you can use the same instance ofSTPCustomerContextfor both. - We've added a
shippingAddressproperty toSTPUserInformation, which you can use to pre-fill your user's shipping information. STPPaymentContextwill now save your user's shipping information to their Stripe customer object. Shipping information will automatically be pre-filled from the customer object for subsequent checkouts.- Fixes nullability annotation for
[STPFile stringFromPurpose:]. See MIGRATING.md. - Adds description implementations to all public models, for easier logging and debugging.
- The card autofill via SMS feature of
STPPaymentContexthas been removed. See MIGRATING.md.
- We've added a
paymentCountryproperty toSTPPaymentContext. This affects the countryCode of Apple Pay payments, and defaults to "US". You should set this to the country your Stripe account is in. paymentRequestWithMerchantIdentifier:has been deprecated. See MIGRATING.md- If the card.io framework is present in your app,
STPPaymentContextandSTPAddCardViewControllerwill show a "scan card" button. STPAddCardViewControllerwill now attempt to auto-fill the users city and state from their entered Zip code (United States only)- Polling for source object updates is deprecated. Check https://stripe.com/docs for the latest best practices on how to integrate with the sources API using webhooks.
- Fixes a crash in
STPCustomerDeserializerwhen both data and error are nil. paymentMethodsViewController:didSelectPaymentMethod:is now optional.- Updates the example apps to use Alamofire.
- Adds STPRedirectContext, a helper class for handling redirect sources.
- STPAPIClient now supports tokenizing a PII number and uploading images.
- Updates STPPaymentCardTextField's icons to match Elements on the web. When the card number is invalid, the field will now display an error icon.
- The alignment of the new brand icons has changed to match the new CVC and error icons. If you use these icons via
STPImageLibrary, you may need to adjust your layout. - STPPaymentCardTextField's isValid property is now KVO-observable.
- When creating STPSourceParams for a SEPA debit source, address fields are now optional.
STPPaymentMethodsViewControllerDelegatenow has a separatepaymentMethodsViewControllerDidCancel:callback, differentiating from successful method selections. You should make sure to also dismiss the view controller in that callback- Because collecting some basic data on tokenization helps us detect fraud, we've removed the ability to disable analytics collection using
[Stripe disableAnalytics].
- Fixes a bug where card sources didn't include the card owner's name.
- Fixes an issue where STPPaymentMethodsViewController didn't reload after adding a new payment method.
- Adds support for creating, retrieving, and polling Sources. You can enable any payment methods available to you in the Dashboard.
- Updates the Objective-C example app to include example integrations using several different payment methods.
- Updates
STPCustomerto includeSTPSourceobjects in itssourcesarray if a customer has attached sources. - Removes methods deprecated in Version 6.0.
- Fixes property declarations missing strong/nullable identifiers.
- Adds button to billing/shipping entry screens to fill address information from the other one.
- Fixes and unifies view controller behavior around theming and nav bars.
- Adds month validity check to
validationStateForExpirationYear - Changes some Apple Pay images to better conform to official guidelines.
- Changes STPPaymentCardTextField's card number placeholder to "4242..."
- Updates STPPaymentCardTextField's CVC placeholder so that it changes to "CVV" for Amex cards
- Fixes a regression introduced in v9.0.0 in which color in STPTheme is used as the background color for UINavigationBar
- Note: This will cause navigation bar theming to work properly as described in the Stripe iOS docs, but you may need to audit your custom theme settings if you based them on the actual behavior of 9.0-9.2
- If the navigation bar has a theme different than the view controller's theme, STP view controllers will use the bar's theme to style it's UIBarButtonItems
- Adds a fallback to using main bundle for localized strings lookup if locale is set to a language the SDK doesn't support
- Adds method to get a string of a card brand from
STPCardBrand - Updated description of how to run tests in README
- Fixes crash when user cancels payment before STPBackendAPIAdapter methods finish
- Fixes bug where country picker wouldn't update when first selected.
- Moves FBSnapshotTestCase dependency to Cartfile.private. No changes if you are not using Carthage.
- Adds prebuilt UI for collecting shipping information.
- Adds localized strings for 7 languages: de, es, fr, it, ja, nl, zh-Hans.
- Slight redesign to card/billing address entry screen.
- Improved internationalization for State/Province/County address field.
- Adds new Mastercard 2-series BIN ranges.
- Fixes an issue where callbacks may be run on the wrong thread.
- Fixes UIAppearance compatibility in STPPaymentCardTextField.
- Fixes a crash when changing application language via an Xcode scheme.
- Change minimum requirements to iOS 8 and Xcode 8
- Adds "app extension API only" support.
- Updates Swift example app to Swift 3
- Various fixes to ObjC example app
- Add ability to set currency for managed accounts when adding card
- Fix broken links for Privacy Policy/Terms of Service for Remember Me feature
- Sort countries in picker alphabetically by name instead of ISO code
- Make "County" field optional on billing address screen.
- PKPayment-related methods are now annotated as available in iOS8+ only
- Optimized speed of input sanitation methods (thanks @kballard!)
- Improved internationalization on billing address forms
- Users in countries that don't use postal codes will no longer see that field.
- The country field is now auto filled in with the phone's region
- Changing the selected country will now live update other fields on the form (such as State/County or Zip/Postal Code).
- Fixed an issue where certain Cocoapods configurations could result in Stripe resource files being used in place of other frameworks' or the app's resources.
- Fixed an issue where when using Apple Pay, STPPaymentContext would fire two
didFinishWithStatusmessages. - Fixed the
deviceSupportsApplePaymethod to also check for Discover cards. - Removed keys from Stripe.bundle's Info.plist that were causing iTunes Connect to sometimes error on app submission.
- You can now optionally use an array of PKPaymentSummaryItems to set your payment amount, if you would like more control over how Apple Pay forms are rendered.
- Updated credit card and Apple Pay icons.
- Fixed some images not being included in the resources bundle target.
- Non-US locales now have an alphanumeric keyboard for postal code entry.
- Modals now use UIModalPresentationStyleFormSheet.
- Added more accessibility labels.
- STPPaymentCardTextField now conforms to UIKeyInput (thanks @theill).
- Fixed an issue with Apple Pay payments not using the correct currency.
- View controllers now update their status bar and scroll view indicator styles based on their theme.
- SMS code screen now offers to paste copied codes.
- Fixed an issue with some Cocoapods installations
- Fixed an issue with custom theming of Stripe UI
- Fixed error handling in STPAddCardViewController
- Added prebuilt UI for collecting and managing card information.
- Fixed an issue with validating certain Visa cards.
- Added Discover support for Apple Pay
- Add the now-required
accountHolderNameandaccountHolderTypeproperties to STPBankAccountParams - We now record performance metrics for the /v1/tokens API - to disable this behavior, call [Stripe disableAnalytics].
- You can now demo the SDK more easily by running
pod try stripe. - This release also removes the deprecated Checkout functionality from the SDK.
- Added an
additionalAPIParametersfield to STPCardParams and STPBankAccountParams for sending additional values to the API - useful for beta features. Similarly, added anallResponseFieldsproperty to STPToken, STPCard, and STPBankAccount for accessing fields in the response that are not yet reflected in those classes' @properties.
- Renamed card on STPPaymentCardTextField to cardParams.
- You can now set an STPPaymentCardTextField's contents programmatically by setting cardParams to an STPCardParams object.
- Added delegate methods for responding to didBeginEditing events in STPPaymentCardTextField.
- Added a UIImage category for accessing our card icon images
- Fixed deprecation warnings for deployment targets >= iOS 9.0
- Splits logic in STPCard into 2 classes - STPCard and STPCardParams. STPCardParams is for making requests to the Stripe API, while STPCard represents the response (you'll almost certainly want just to replace any usage of STPCard in your app with STPCardParams). This also applies to STPBankAccount and the newly-created STPBankAccountParams.
- Version 6.0.1 fixes a minor Cocoapods issue.
- Adds STPPaymentCardTextField, a new version of github.com/stripe/PaymentKit featuring many bugfixes. It's useful if you need a pre-built credit card entry form.
- Adds the currency param to STPCard for those using managed accounts & debit card payouts.
- Versions 5.1.1 and 5.1.2 fix minor issues with CocoaPods installation
- Version 5.1.3 contains bug fixes for STPPaymentCardTextField.
- Version 5.1.4 improves compatibility with iOS 9.
- Fix an issue with Carthage installation
- Fix an issue with CocoaPods frameworks
- Deprecate native Stripe Checkout
- Fix a compiler warning
- Versions 4.0.1 and 4.0.2 fix minor issues with CocoaPods and Carthage installation.
- Remove STPPaymentPresenter
- Support for latest ApplePayStubs
- Add nullability annotations to improve Swift support (note: this now requires Swift 1.2)
- Bug fixes
- Add support for native Stripe Checkout, as well as STPPaymentPresenter for automatically using Checkout as a fallback for Apple Pay
- Add OSX support, including Checkout
- Add framework targets and Carthage support
- It's safe to remove the STRIPE_ENABLE_APPLEPAY compiler flag after this release.
- Migrate code into STPAPIClient
- Add 'brand' and 'funding' properties to STPCard
- Add bank account tokenization methods
- Add billing address fields to our Apple Pay API
- Various bug fixes and code improvements
- Move Apple Pay testing functionality into a separate project, ApplePayStubs. For more info, see github.com/stripe/ApplePayStubs.
- Improve the provided example app
- Remove token retrieval API method
- Refactor functional tests to use new XCTestCase functionality
- Group ApplePay code in a CocoaPods subspec
- Move ApplePay code behind a compiler flag to avoid warnings from Apple when accidentally including it
- Fix some small bugs related to ApplePay and iOS8
- Add support for native payments via Pay
- Removed PaymentKit as a dependency. If you'd like to use it, you may still do so by including it separately.
- Removed STPView. PaymentKit provides a near-identical version of this functionality if you need to migrate.
- Improve example project
- Various code fixes
- Fixed an issue where tokenization requests would fail under iOS 6 due to SSL certificate verification
- Send some basic version and device details with requests for debugging.
- Added -description to STPToken
- Fixed some minor code nits
- Modernized code
- Added test suite for SSL certificate expiry/revocation
- You can now set STPView's delegate from Interface Builder
- API methods now verify the server's SSL certificate against a preset blacklist.
- Fixed some bugs with SSL verification.
- Note: This version now requires the
Securityframework. You will need to add this to your app if you're not using CocoaPods.
- Upgraded tests from OCUnit to XCTest
- Fixed an issue with the SenTestingKit dependency
- Removed some dead code
- Fixed: Some example files had target memberships set for StripeiOS and iOSTest.
- Fixed: The example publishable key was expired.
- Fixed: Podspec did not pass linting.
- Some fixes for 64-bit.
- Many improvements to the README.
- Fixed example under iOS 7
- Some source code cleaning and modernization.
- Add exceptions for null successHandler and errorHandler.
- Added the ability to POST the created token to a URL.
- Made STPCard properties nonatomic.
- Moved PaymentKit to be a submodule; added to Podfile as a dependency.
- Fixed some warnings caught by the static analyzer (thanks to jcjimenez!)
- Add CocoaPods support
- Change directory structure of bindings to make it easier to install
- Initial release
Special thanks to: Todd Heasley, jcjimenez.

