Swiftpack.co - stripe/stripe-ios as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
stripe/stripe-ios
Stripe iOS SDK
.package(url: "https://github.com/stripe/stripe-ios.git", from: "yuki/vFoo")

Stripe iOS SDK

Travis CocoaPods Carthage compatible License Platform

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.

Table of contents

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

  1. Install Carthage 0.37 or later (if you have homebrew installed, brew install carthage)
  2. From the root of the repo, run bundle install && bundle exec fastlane stripeios_tests. This will install the test dependencies and run the tests.
  3. 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

GitHub

link
Stars: 1514
Last commit: Yesterday

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Release Notes

Version 21.9.0
Yesterday

21.9.0 2021-10-18

PaymentSheet

This release adds several new features to PaymentSheet, our drop-in UI integration:

More supported payment methods

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

Pre-fill billing details

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.

Save payment methods on payment

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.

SetupIntent support

This is currently only available for cards + Apple/Google Pay.

Initialize PaymentSheet with a SetupIntent to set up cards for future use without charging.

Smart payment method ordering

When a customer is adding a new payment method, PaymentSheet uses information like the customers region to show the most relevant payment methods first.

Other changes

  • 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

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics