Stripe iOS SDK

Stripe

Last update: Jan 5, 2023

Related tags

Overview

Stripe iOS SDK

The Stripe iOS SDK makes it quick and easy to build an excellent payment experience in your iOS app. We provide powerful and customizable UI screens and elements that can be used out-of-the-box to collect your users' payment details. We also expose the low-level APIs that power those UIs so that you can build fully custom experiences.

Get started with our 📚 integration guides and example projects, or 📘 browse the SDK reference.

Learn about our Stripe Identity iOS SDK to verify the identity of your users on iOS.

Updating to a newer version of the SDK? See our migration guide and changelog.

Features
Releases
Requirements
Getting started
- Integration
- Examples
Card scanning
Contributing
Migrating

Features

Simplified security: We make it simple for you to collect sensitive data such as credit card numbers and remain PCI compliant. This means the sensitive data is sent directly to Stripe instead of passing through your server. For more information, see our integration security guide.

Apple Pay: We provide a seamless integration with Apple Pay.

SCA-ready: The SDK automatically performs native 3D Secure authentication if needed to comply with Strong Customer Authentication regulation in Europe.

Stripe API: We provide low-level APIs that correspond to objects and methods in the Stripe API. You can build your own entirely custom UI on top of this layer, while still taking advantage of utilities like STPCardValidator to validate your user’s input.

Native UI: We provide native screens and elements to collect payment details. For example, PaymentSheet is a prebuilt UI that combines all the steps required to pay - collecting payment details, billing details, and confirming the payment - into a single sheet that displays on top of your app.

Card scanning: We support card scanning on iOS 13 and higher. See our Card scanning section.

Localized: We support the following localizations: Bulgarian, Catalan, Chinese (Hong Kong), Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English (US), English (United Kingdom), Estonian, Filipino, Finnish, French, French (Canada), German, Greek, Hungarian, Indonesian, Italian, Japanese, Korean, Latvian, Lithuanian, Malay, Maltese, Norwegian Bokmål, Norwegian Nynorsk (Norway), Portuguese (Brazil), Polish, Portuguese, Romanian, Russian, Slovakian, Slovenian, Spanish, Spanish (Latin America), Swedish, Turkish, Turkmen, and Vietnamese.

Recommended usage

If you're selling digital products or services that will be consumed within your app, (e.g. subscriptions, in-game currencies, game levels, access to premium content, or unlocking a full version), you must use Apple's in-app purchase APIs. See the App Store review guidelines for more information. For all other scenarios you can use this SDK to process payments via Stripe.

Releases

We support Cocoapods, Carthage, and Swift Package Manager. If you link the library manually, use a version from our releases page and make sure to embed all of the following frameworks:

Stripe.xcframework
Stripe3DS2.xcframework
StripeCore.xcframework
StripeUICore.xcframework

To manually link the Stripe Identity iOS SDK, follow these instructions.

If you're reading this on GitHub.com, please make sure you are looking at the tagged version that corresponds to the release you have installed. Otherwise, the instructions and example code may be mismatched with your copy. You can read the latest tagged version of this README and browse the associated code on GitHub using this link.

Requirements

The Stripe iOS SDK requires Xcode 12.2 or later and is compatible with apps targeting iOS 11 or above. We support Catalyst on macOS 10.15 or later.

For iOS 10 support, please use v19.4.0. If you need to support iOS 9, use v17.0.2.

Requirements for the Stripe Identity iOS SDK can be found here.

Getting started

Integration

Get started with our 📚 integration guides and example projects, or 📘 browse the SDK reference for fine-grained documentation of all the classes and methods in the SDK.

Examples

Prebuilt UI
- This example demonstrates how to build a payment flow using our drop-in prebuilt UI component PaymentSheet.
Non-Card Payment Examples
- This example demonstrates how to use STPAPIClient to manually accept various non-card payment methods.

Card scanning

PaymentSheet UI offers built-in card scanning. To enable card scanning, you'll need to set NSCameraUsageDescription in your application's plist, and provide a reason for accessing the camera (e.g. "To scan cards"). Card scanning is supported on devices with iOS 13 or higher.

You can demo this feature in our PaymentSheet example app. When you run the example app on a device, you'll see a "Scan Card" button when adding a new card.

Contributing

We welcome contributions of any kind including new features, bug fixes, and documentation improvements. Please first open an issue describing what you want to build if it is a major change so that we can discuss how to move forward. Otherwise, go ahead and open a pull request for minor changes such as typo fixes and one liners.

Running tests

Install Carthage 0.37 or later (if you have homebrew installed, brew install carthage)
From the root of the repo, run bundle install && bundle exec fastlane stripeios_tests. This will install the test dependencies and run the tests.
Once you have run this once, you can also run the tests in Xcode from the StripeiOS target in Stripe.xcworkspace. Make sure to use the iPhone 8, iOS 13.7 simulator so the snapshot tests will pass.

Migrating from older versions

See MIGRATING.md

Comments

Swift UI Integration

Hi, I recently started a Swift UI project and was trying to integrate creating customer tokens within the app. Has anyone tried integrating Stripe with Swift UI? I know it is still in beta 🙈
triaged

opened by djshumpert 52
Allow setting STPPaymentCardTextField values externally

Setting card number, expiration, and cvc for STPPaymentCardTextField externally would be extremely useful. For example, when scanning a card with the camera there is no way to populate a STPPaymentCardTextField with the captured values.

opened by alampila 25
STPCheckoutOptions.h import issue with CocoaPods & Frameworks
We're including Stripe via CocoaPods in our project. Using frameworks for iOS 8 we see a build error with version 4.0.3.

Here's an abridged version of our Podfile

platform :ios, "8.0" use_frameworks! ... pod 'Stripe' pod 'Stripe/ApplePay' ...

This is not an issue with version 3.1.0
opened by keith 25
Warning for non-debug configuration

This warning presents when testing the app in the debug config, using test cards.

Warning! You're building your app in a non-debug configuration, but appear to be using your Stripe test key. Make sure not to submit to the App Store with your test keys!

How can I get rid of it?

opened by ecristerna 21
Adding support for the file uploads and personally identifiable information
Summary

This PR adds file upload support for identity verification and evidence disputes. It also adds support for the tokenization of personally identifiable information (PII).

Motivation

Hello again, @jack-stripe ! Over here at Zola we needed to add support for identity verification from our mobile client. We thought this would be a useful addition to the main repo. Here's a summary of the changes:

STPFile - model object representing a file that has been upload to the Stripe API.

STPFileClient - API client to upload a UIImage object for either identify verification or an evidence dispute.

STPMultipartFormDataPart - Represents a single part of a multipart/form-data upload.

STPMultipartFormDataEncoder - Transforms an array of STPMultipartFormDataPart objects into the HTTP body data required by a multipart/form-data upload.

Added createTokenWithPersonalIDNumber:completion: to STPAPIClient.

Example Usage

// Upload an identifying document let client = STPFileClient(publishableKey: "pk_test_foo") client.uploadImage(UIImage(named: "image")!, purpose: .identityDocument) { file, error in debugPrint(file, error) } // Tokenize a personal ID number let client = STPAPIClient(publishableKey: "pk_test_foo") client.createToken(withPersonalIDNumber: 000000000) { token, error in debugPrint(token, error) }

Testing

Your unit test target is currently broken on master (it looks like you're missing the FBSnapshotTestCase dependency). If you fix the target I'm happy to provide unit tests and functional tests for my additions.
opened by scalessec 19
Opt-in to compile Apple Pay code
It seems that Apple will send you a nastygram via email if you submit an iOS8 app that uses the new bindings but doesn't have an Apple Pay entitlement because it references new PassKit symbols.* We should find a way to make sure these don't get compiled unless people actually want them.

Note: they'll still accept your app, just send you a warning email
opened by jflinter 19
crash in STPImageLibrary.safeImageNamed on Mac Catalyst (intel) in Stripe (21.0.1)

Summary

I am using an STPPaymentCardTextField, that I added via Interface builder. When running the App with Mac Catalyst, opening the screen immediately leads to a crash. Library version: Stripe (21.0.1) It does not crash on iOS devices. It did not crash on any device (including mac Catalyst) in Stripe (19.x.x) - it was still PaymentCardTextField back then I think.

Code to reproduce

Just when loading the view.

iOS version

macOS 10.15.7

Installation method

cocoapods

SDK version

21.0.1

Other information

Crashing when force unwrapping the image at the end of STPImageLibrary.safeImageNamed

Here is the stack trace: #4 0x0000000102165502 in static STPImageLibrary.safeImageNamed(_:templateIfAvailable:) at FoodRunner/Pods/Stripe/Stripe/STPImageLibrary.swift:172 #5 0x0000000102165e13 in static STPImageLibrary.brandImage(for:template:) at FoodRunner/Pods/Stripe/Stripe/STPImageLibrary.swift:207 #6 0x000000010216448b in static STPImageLibrary.cardBrandImage(for:) at FoodRunner/Pods/Stripe/Stripe/STPImageLibrary.swift:80 #7 0x00000001021a2426 in static STPPaymentCardTextField.brandImage(for:) at FoodRunner/Pods/Stripe/Stripe/STPPaymentCardTextField.swift:519 #8 0x00000001021a2f22 in STPPaymentCardTextField.brandImageView.getter at FoodRunner/Pods/Stripe/Stripe/STPPaymentCardTextField.swift:554 #9 0x00000001021a9fca in STPPaymentCardTextField.commonInit() at FoodRunner/Pods/Stripe/Stripe/STPPaymentCardTextField.swift:635 #10 0x00000001021a81e6 in STPPaymentCardTextField.init(coder:) at FoodRunner/Pods/Stripe/Stripe/STPPaymentCardTextField.swift:610 #11 0x00000001021a8273 in @objc STPPaymentCardTextField.init(coder:) ()
triaged

opened by rocketnik 18
Framework size for AppClips

Currently when installed through cocoapods, the 21.0.1 framework is above 9MB, and the 20.0.* framework is about 5MB. This makes it almost impossible to include Stripe functionality in an AppClip, where the total uncompressed size of the app needs to be < 10MB.

Would it be possible to either reduce the size of the main framework, or have a framework that only includes Core functionality that would be required for an appclip, like token creation and Apple Pay? Getting this down to a MB or two would make it much easier to include in an AppClip.
triaged

opened by woodymelling 18
Stripe SDK size is huge
Summary

App size is very important for our customers, where most of them will download the app over 3G while trying to make a booking in place. Lately, we have observed our app size growing and, together with other factors, we have seen an increase of the size of Stripe with our last update (we migrated from a version of more than 2 years old). Inspecting the binary, you can see how stripe is the biggest library by far in our project (ignoring the swift libraries), even bigger than our whole project code. However, we make very limited used of it, since we mostly interact with the API only, and we do not make use of any of the provided UI. Is there a way where we can import a lighter version of the SDK? this is already very important for us, but it will be crucial soon since we have in roadmap an AppClip where we expect people to pay, and with this binary size it will become impossible.

Code to reproduce

None

iOS version

All

Installation method

pod 'Stripe', '~> 21.6.0'

SDK version

21.6.0
triaged
opened by angelolloqui 17
iOS 11 support

To make it easier to diagnose your issue, please fill out the following:

Summary

The examples don't work with iOS 11

Code to reproduce

pod update in terminal. Also using PKAddressField anywhere in Swift code

iOS version

What version of iOS are you observing the problem on? 11

Installation method

How did you install our SDK? pod install

SDK version

What version of our SDK are you using? You can find this by either looking at your Podfile.lock (if you're using Cocoapods), your Cartfile.resolved (if you're using Carthage), or by looking at the value of STPSDKVersion in STPAPIClient.h. 11.3

Other information

Anything else you can include that'll make it easier for us to help you!

opened by massoud12345 17
Pod contains old API version

Summary

The stripe-ios pod sends the API calls with the following stripe version (STPAPIClient.m line 49) static NSString * const APIVersion = @"2015-10-12";

I'm wondering if this is on purpose? Should I change it to the API version we use on our server? If yes, how?
triaged

opened by odedharth 16
Switch to DocC

Summary

Switch from Jazzy to DocC.

Testing

CI, published a test site here: https://davidme-stripe.github.io/docc-test/stripe-ios/documentation/stripe/

opened by davidme-stripe 0
Financial Connections: implement support for merchant_logo being displayed in Consent Pane
Summary

Adds logos in the Consent Pane as part of an experiment.

context: https://stripe.slack.com/archives/C02KW8G938W/p1671654017106379

https://www.figma.com/file/pU6S60e08Rgv0dvycCxMT8/Connections---Mobile?node-id=228%3A28999&t=uMV3CjQjZ6w8M7vS-0

Testing

Note that by default we are in "control" experience. I hard-coded "treatment" to test, and I also hard-coded various array sizes of merchant_logo to test.

Exposure event in Splunk:

Control

https://user-images.githubusercontent.com/105514761/209403474-4f682a70-9577-441e-9608-9357b85aa7a7.mov

Treatment

https://user-images.githubusercontent.com/105514761/209403510-d70ebd82-e10a-4141-aac9-92a1ab5cf885.mov
opened by kgaidis-stripe 0
[Financial Connections] Adds custom presentation logic

Summary

Adds custom looking but native hack-ish presentation logic.

Motivation

Get away from z-stack looking presentation.

Testing

https://user-images.githubusercontent.com/92807969/209227890-7d0f2d55-c482-4b8d-a675-15e5e9adc463.mov

https://user-images.githubusercontent.com/92807969/209227903-eb109ba9-ed8d-4733-877b-c59b14a00502.mov

opened by vardges-stripe 0

Conform PaymentSheetError to CustomDebugStringConvertible

Summary

Conform PaymentSheetError to CustomDebugStringConvertible and adds more detailed debug descriptions.

Motivation

It seems like we intended to do this but forgot.

Conforming to CustomDebugStringConvertible lets us provide the string used when calling print, debugPrint, and po in the debugger.

You can see other *Error types conform to it in other SDKs e.g. IdentityVerificationSheetError.

Testing

I manually tested:

print(PaymentSheetError.unknown(debugDescription: "The client secret is missing"))
print(PaymentSheetError.noPaymentMethodTypesAvailable(paymentIntentPaymentMethods: [.USBankAccount, .UPI]))

This produces the following output before:

unknown(debugDescription: "The client secret is missing")
noPaymentMethodTypesAvailable

and after:

An error ocurred in PaymentSheet. The client secret is missing
An error ocurred in PaymentSheet. No payment method types are available. You may need to set `allowsDelayedPaymentMethods` or `allowsPaymentMethodsRequiringShippingAddress` in your PaymentSheet.Configuration object. The PaymentIntent has the following types: [USBankAccount, UPI]

Changelog

See CHANGELOG.md

opened by yuki-stripe 0

Optimize docs build
Summary

We were running SourceKitten multiple times over each module. Reduce that to only run once on all modules before building the docs.

Use incremental builds where possible.

Upload the produced docs as an artifact in Bitrise.

Switch to Xcode 13 for now, as it's what we use to deploy the docs and Xcode 14 isn't outputting correct attributes for @_spi classes.

Motivation

Reduce docs build time from 15m to 9m, prepare for deploy script changes.

Testing

CI, on Xcode 13
opened by davidme-stripe 0

Releases(23.3.1)

23.3.1(Dec 12, 2022)
23.3.1 2022-12-12

[Fixed] Fixed a bug where 3 decimal place currencies were not being formatted properly.

PaymentSheet

[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.

CardScan

[Fixed] Fixed UX model loading from the wrong bundle. #2078 (Thanks nickm01)

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(55.71 MB)
23.3.0(Dec 5, 2022)
23.3.0 2022-12-05

PaymentSheet

[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.

Financial Connections

[Changed] FinancialConnectionsSheet methods now require to be called from non-extensions.

[Changed] BankAccountToken.bankAccount was changed to an optional.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(55.61 MB)
23.2.0(Nov 14, 2022)
23.2.0 2022-11-14

PaymentSheet

[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 to true and set PaymentSheet.Configuration.shippingDetails to 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_usage value being set when there's no customer.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(52.55 MB)
23.1.1(Nov 7, 2022)
23.1.1 2022-11-07

Payments

[Fixed] Fixed an issue with linking the StripePayments SDK in certain configurations.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(52.47 MB)
23.1.0(Oct 31, 2022)
23.1.0 2022-10-31

CardScan

[Added] Added a README.md for the CardScanSheet integration.

PaymentSheet

[Added] Added parameters to customize the primary button and Apple Pay button labels. They can be found under PaymentSheet.Configuration.primaryButtonLabel and PaymentSheet.ApplePayConfiguration.buttonType respectively.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(52.26 MB)
23.0.0(Oct 24, 2022)
23.0.0 2022-10-24

Payments

[Changed] Reduced the size of the SDK by splitting the Stripe module into StripePaymentSheet, StripePayments, and StripePaymentsUI. 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 cardParams parameter has been deprecated in favor of paymentMethodParams, making it easier to include the postal code from the card field. If you need to access the STPPaymentMethodCardParams, use .paymentMethodParams.card.

PaymentSheet

[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.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(52.23 MB)
22.8.4(Oct 12, 2022)
22.8.4 2022-10-12

PaymentSheet

[Fixed] Use .formSheet modal presentation in Mac Catalyst. #2023 (Thanks sergiocampama!)

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(51.52 MB)
22.8.3(Oct 4, 2022)
22.8.3 2022-10-03

CardScan

[Fixed] Garbled privacy link text in Card Scan UI

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(51.37 MB)
22.8.2(Sep 19, 2022)
22.8.2 2022-09-19

Identity

[Changed] Support uploading single side documents.

[Fixed] Fixed Xcode 14 support.

Financial Connections

[Fixed] Fixes an issue of returning canceled result from FinancialConnections if user taps cancel on the manual entry success screen.

CardScan

[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.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(51.23 MB)
22.8.1(Sep 12, 2022)
22.8.1 2022-09-12

PaymentSheet

[Fixed] Fixed potential crash when using Link in Mac Catalyst.

[Fixed] Fixed Right-to-Left (RTL) layout issues.

Apple Pay

[Fixed] Fixed an issue where applePayContext:willCompleteWithResult:authorizationResult:handler: may not be called in Objective-C implementations of STPApplePayContextDelegate.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(50.82 MB)
22.8.0(Sep 6, 2022)
22.8.0 2022-09-06

PaymentSheet

[Changed] Renamed PaymentSheet.reset() to PaymentSheet.resetCustomer(). See MIGRATING.md for more info.

[Added] You can now set closures in PaymentSheet.ApplePayConfiguration.customHandlers to configure the PKPaymentRequest and PKPaymentAuthorizationResult during a transaction. This enables you to build support for Merchant Tokens and Order Tracking in iOS 16.

Apple Pay

[Added] You can now implement the applePayContext(_:willCompleteWithResult:handler:) function in your ApplePayContextDelegate to configure the PKPaymentAuthorizationResult during a transaction. This enables you to build support for Order Tracking in iOS 16.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(50.74 MB)
22.7.1(Sep 1, 2022)
22.7.1 2022-08-31

[Fixed] Fixed Mac Catalyst support in Xcode 14. #2001

PaymentSheet

[Fixed] PaymentSheet now uses configuration.apiClient for Apple Pay instead of always using STPAPIClient.shared.

[Fixed] Fixed a layout issue with PaymentSheet in landscape.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(50.68 MB)
22.7.0(Aug 15, 2022)
22.7.0 2022-08-15

PaymentSheet

[Fixed] Fixed a layout issue on iPad.

[Changed] Improved Link support in custom flow (PaymentSheet.FlowController).

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(50.75 MB)
22.6.0(Jul 5, 2022)
22.6.0 2022-07-05

PaymentSheet

[Added] PaymentSheet now supports Link payment method.

[Changed] Change behavior of Afterpay/Clearpay: Charge in 3 for GB, FR, and ES

STPCardFormView

[Changed] Postal code is no longer collected for billing addresses in Japan.

Identity

[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.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(49.93 MB)
22.5.1(Jun 21, 2022)
22.5.1 2022-06-21

[Fixed] Fixed an issue with STPPaymentHandler where returning an app redirect could cause a crash.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(49.78 MB)
22.5.0(Jun 13, 2022)
22.5.0 2022-06-13

PaymentSheet

[Added] You can now use PaymentSheet.ApplePayConfiguration.paymentSummaryItems to directly configure the payment summary items displayed in the Apple Pay sheet. This is useful for recurring payments.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(49.01 MB)
22.4.0(May 23, 2022)
22.4.0 2022-05-23

PaymentSheet

[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] affirm and AUBECSDebit payment methods are now available in PaymentSheet

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(48.06 MB)
22.3.2(May 18, 2022)
22.3.2 2022-05-18

CardScan

[Added] Added privacy text to the CardImageVerification Sheet UI

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(47.88 MB)
22.3.1(May 16, 2022)
22.3.1 2022-05-16

[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

Identity

[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.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(47.81 MB)
22.3.0(May 3, 2022)
22.3.0 2022-05-03

PaymentSheet

[Added] us_bank_account PaymentMethod is now available in payment sheet

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(47.31 MB)
22.2.0(Apr 26, 2022)
22.2.0 2022-04-25

Connections

[Changed] StripeConnections SDK has been renamed to StripeFinancialConnections. See MIGRATING.md for more info.

PaymentSheet

[Fixed] Fixed an issue where source_cancel API requests were being made for non-3DS payment method types.

[Fixed] Fixed an issue where certain error messages were not being localized.

Identity

[Fixed] Minor UI fixes when using IdentityVerificationSheet with native components

[Changed] Improvements to native component IdentityVerificationSheet document detection

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(46.82 MB)
22.1.1(Apr 11, 2022)
22.1.1 2022-04-11

Identity

[Fixed] Fixes VerificationClientSecret (Thanks Masataka-n!)

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(45.70 MB)
22.1.0(Apr 4, 2022)
22.1.0 2022-04-04

[Changed] Localization improvements.

Identity

[Added] IdentityVerificationSheet can now be used with native iOS components.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(45.11 MB)
22.0.0(Mar 29, 2022)
22.0.0 2022-03-28

[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_account PaymentMethod is now available for ACH Direct Debit payments, including APIs to collect customer bank information (requires StripeConnections) and verify microdeposits.

[Added] StripeConnections SDK can be optionally included to support ACH Direct Debit payments.

PaymentSheet

[Changed] PaymentSheet now uses light and dark mode agnostic icons for payment method types.

[Changed] Link payment method (private beta) UX improvements.

Identity

[Changed] IdentityVerificationSheet now has an availability requirement of iOS 14.3 on its initializer instead of the present method.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(45.06 MB)
21.13.0(Mar 16, 2022)
21.13.0 2022-03-15

[Changed] Binary framework distribution now requires Xcode 13. Carthage users using Xcode 12 need to add the --no-use-binaries flag.

PaymentSheet

[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 alwaysLight or alwaysDark.

[Fixed] A race condition when setting the primaryButtonColor on PaymentSheet.Configuration.

[Added] PaymentSheet now supports Link (private beta).

CardScan

[Added] The CardImageVerificationSheet initializer can now take an additional Configuration object.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(43.29 MB)
21.12.0(Feb 14, 2022)
21.12.0 2022-02-14

[Added] We now offer a 1MB Apple Pay SDK module intended for use in an App Clip. Visit our App Clips docs for details.

Stripe now requires StripeApplePay. See MIGRATING.md for more info.

[Added] Added a convenience initializer to create an STPCardParams from an STPPaymentMethodParams.

PaymentSheet

[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

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(41.59 MB)
21.11.1(Jan 11, 2022)

[Fixed] Fixes a build warning in SPM caused by an invalid Package.swift file
Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(35.90 MB)
21.11.0(Jan 4, 2022)
[Changed] The maximum identity_document file upload size has been increased, improving the quality of compressed images. See https://stripe.com/docs/file-upload

[Fixed] The maximum dispute_evidence file 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.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(36.25 MB)
21.10.0(Dec 15, 2021)
21.10.0 2021-12-14

Added API bindings for Klarna

StripeIdentity now requires StripeCameraCore. See MIGRATING.md for more info.

Releasing StripeCardScan Beta 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!)

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(36.28 MB)
21.9.1(Dec 3, 2021)
21.9.1 2021-12-02

Fixes a build warning caused by a duplicate NSURLComponents+Stripe.swift file.

Source code(tar.gz)
Source code(zip)
Stripe.xcframework.zip(25.74 MB)