Overview

The Bolt iOS SDK (BoltInternal) provides a streamlined integration for launching Bolt’s managed checkout flow and SSO login from your iOS app. The SDK handles the complete checkout UI, payment authorization, and Bolt account login, so you can focus on your app experience.

Completing the integration requires three primary steps:

1. Initialize the SDK with your publishable key.
2. Configure a checkout session with an order token from your backend.
3. Launch the checkout flow and handle the result.

Installation

Swift Package Manager

Add the Bolt SDK via Xcode:

1. Go to File > Add Package Dependencies…
2. Enter the repository URL: https://github.com/BoltApp/bolt-ios-checkout-sdk
3. Select the version rule (e.g. “Up to Next Major”) and click Add Package.

Or add it directly to your Package.swift:

dependencies: [
    .package(url: "https://github.com/BoltApp/bolt-ios-checkout-sdk", from: "<version>")
]

SDK Initialization

The SDK must be initialized exactly once during your application’s lifecycle. The best place to do this is in your AppDelegate or SwiftUI App entry point.

UIKit (AppDelegate)

import BoltInternal

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        BoltCheckout.initialize(
            publishableKey: "YOUR_PUBLISHABLE_KEY",
            environment: .production, // or .sandbox
            merchantDivisionId: "YOUR_MERCHANT_DIVISION_ID"
        )

        return true
    }
}

SwiftUI

import BoltInternal
import SwiftUI

@main
struct MyApp: App {
    init() {
        BoltCheckout.initialize(
            publishableKey: "YOUR_PUBLISHABLE_KEY",
            environment: .production,
            merchantDivisionId: "YOUR_MERCHANT_DIVISION_ID"
        )
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

Configuration Requirements

To use the SDK, ensure you have the following credentials properly configured:

API Quick Reference

Next Steps

• Checkout Flow — Generate order tokens and launch the managed checkout experience.
• SSO Login — Authenticate users with their Bolt account via OAuth 2.0 and PKCE.
• Custom Checkout — Build a custom checkout using the payment flow and authorization APIs.
• API Reference — Full reference for all delegates, result types, and callbacks.

Cross-Platform Parity

The iOS SDK API is designed to closely mirror the Android / Kotlin SDK: