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.
Learn about our Stripe Identity iOS SDK to verify the identity of your users on iOS.
Table of contents
- Getting started
- Card scanning
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.
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.
Stripe API: StripePayments provides 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.
Card scanning: We support card scanning on iOS 13 and higher. See our Card scanning section.
App Clips: The
StripeApplePay module provides a lightweight SDK for offering Apple Pay in an App Clip.
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), Polish, Portuguese, Portuguese (Brazil), Romanian, Russian, Slovak, Slovenian, Spanish, Spanish (Latin America), Swedish, Turkish, Thai and Vietnamese.
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.
For help with Apple's App Privacy Details form in App Store Connect, visit Stripe iOS SDK Privacy Details.
|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
|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|
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 of the required frameworks.
Stripe module, link the following frameworks:
For other modules, follow the instructions below:
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.
The Stripe iOS SDK requires Xcode 14.1 or later and is compatible with apps targeting iOS 13 or above. We support Catalyst on macOS 10.16 or later.
Prebuilt UI (Recommended)
- This example demonstrates how to manually accept various payment methods using the Stripe API.
Building from source
We use Tuist to generate Xcode projects, and all Xcode related files have been removed from the master branch of the repository. Note that project files are still available on tagged releases.
If you want to build from the master branch you need to follow these steps:
- Clone the repository and
cdinto its directory.
- Install Tuist by running
curl -Ls https://install.tuist.io | bash
tuist generate, optionally pass the
-noption if you don't want to open Xcode automatically.
You can build any of the generated targets as you normally would.
For more information about Tuist, visit https://tuist.io.
PaymentSheet 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.
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.
- 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
Stripe.xcworkspace. Make sure to use the iPhone 12 mini, iOS 16.1 simulator so the snapshot tests will pass.
Migrating from older versions