Stripe iOS SDK

The StripeCryptoOnramp SDK allows developers to build a headless crypto onramp flow within an iOS application. It provides a CryptoOnrampCoordinator to orchestrate the entire process—including Link authentication, KYC (Know Your Customer) and identity verification, payment method collection, and checkout—while allowing the developer to maintain control over the application's UI and navigation.

Note: This SDK is currently in private preview. Access must be requested via the Stripe documentation.

The Stripe Connect iOS SDK provides embedded components that allow you to grant users access to Stripe products directly within your app. The following components are currently supported:

• Account onboarding: Displays a localized onboarding form that performs data validation.
• Payments: Allows users to view payment details and manage disputes.
• Payouts: Displays payouts and enables users to perform payouts.

PaymentSheet is a pre-built UI component that handles the entire payment lifecycle in a single sheet displayed on top of your application. It combines collecting payment information, gathering billing details, and confirming the payment.

Key benefits include:

• Support for 10+ payment methods.
• Built-in card scanning.
• Support for Light and Dark modes.
• Helps maintain PCI compliance by handling sensitive data within the Stripe UI.

Follow these patterns for control flow to ensure readability and debuggability:

• Braces: Always wrap conditional bodies with curly braces.
• Else placement: Place else if and else on the same line as the preceding closing brace.
• Returns: Each return statement must be on its own line. Do not use single-line returns like if (condition) return YES;.
• Ternary Operators: Use sparingly and only for simple conditions.
• Switch Statements: For enums, include an entry for every value and avoid using default.

if (condition) {
    // A
} else if (condition) {
    // B
} else {
    // C
}

The Stripe iOS SDK has the following platform requirements:

• iOS: 15 or above (For support for iOS 13 and 14, use version 25.17.0).
• macOS (Catalyst): macOS 12 or later.
• Xcode: Supports all Apple-supported Xcode versions.

When choosing how to process payments, follow Apple's guidelines:

• Digital Products/Services: If you are selling items consumed within the app (e.g., subscriptions, in-game currency, premium content), you must use Apple's in-app purchase APIs.
• Other Scenarios: For all other scenarios (e.g., physical goods or services), you can use the Stripe iOS SDK to process payments.