The Stripe iOS SDK makes it easy to build an excellent payment experience in your iOS app. It provides powerful, customizable, UI elements to use out-of-the-box to collect your users' payment details.

We also expose the low-level APIs that power those elements to make it easy to build fully custom forms. This guide will take you all the way from integrating our SDK to accepting payments from your users via both credit cards and Apple Pay.

If you'd like to see a complete iOS example, check out Rocket Rides, built using the iOS SDK and Stripe Connect.

Install and configure the SDK

You can choose to install the Stripe iOS SDK via your favorite method. We support CocoaPods and Carthage with both static and dynamic frameworks.

Configure your Stripe integration in your App Delegate

After you're done installing the SDK, configure it with your Stripe API keys.

import UIKit
import Stripe

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        STPPaymentConfiguration.shared().publishableKey = "pk_test_TYooMQauvdEDq54NiTphI7jx"
        // do any other necessary launch configuration
        return true
    }
}

#import "AppDelegate.h"
@import Stripe;

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [[STPPaymentConfiguration sharedConfiguration] setPublishableKey:@"pk_test_TYooMQauvdEDq54NiTphI7jx"];
    // do any other necessary launch configuration
    return YES;
}
@end

Set up Apple Pay (optional)

Accepting Apple Pay in your app involves some (very quick) setup on the Apple Developer website. Follow the steps in Accepting Apple Pay in Your iOS App to create an Apple Merchant ID.

After you've obtained an Apple Merchant ID, set it in your configuration:

STPPaymentConfiguration.shared().appleMerchantIdentifier = "your apple merchant identifier"

[[STPPaymentConfiguration sharedConfiguration] setAppleMerchantIdentifier:@"your apple merchant identifier"];

Standard vs. custom UI components

The simplest way to integrate our SDK is using STPPaymentContext, a class designed to make building your app's checkout flow as easy as possible. It handles collecting, saving, and reusing your user's payment details, and can also be used to collect shipping info. See Using Standard UI Components to get started.

If you find that the standard UI components are not flexible enough for your needs, see Custom UI Components, which allows you to build with the individual components.

Using Stripe and Apple Pay vs. in-app purchases

Apple Pay doesn't replace Apple's In-App Purchase API. You can use any of Stripe's supported payment methods and Apple Pay in your iOS app to sell physical goods (e.g., groceries and clothing) or for services your business provides (e.g., club memberships and hotel reservations). These payments are processed through Stripe and you only need to pay Stripe's processing fee.

Apple's developer terms require their In-App Purchase API be used for digital "content, functionality, or services", such as premium content for your app or subscriptions for digital content. Payments made using the In-App Purchase API are processed by Apple and subject to their transaction fees.

Next steps

• Using iOS Standard UI Components
• Using iOS Custom UI Components
• Using Payment Intents on iOS