Installation

Whop’s iOS SDKs are distributed as separate Swift packages — WhopCheckout for payments and WhopElements for embedded chat and payouts. Install only what you need.

WhopCheckout (In-App Purchases)

The WhopCheckout package handles subscriptions and payments in your app.

Step 1: Add Package Dependency

In Xcode, go to File → Add Package Dependencies…

Enter the package URL:

https://github.com/whopio/whopsdk-checkout-swift

Step 2: Select Version

Choose the latest version or specify a version range:

• Up to Next Major: Recommended for production
• Exact Version: For stability

Step 3: Create an API key

The SDK requires an API key scoped to the iap:read permission. This permission is designed for client-side use, so the key is safe to embed in your app bundle.

Step 4: Import and configure

import SwiftUI
import WhopCheckout
@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(Checkout.shared)
                .task {
                    try? await Checkout.shared.configure(
                        // companyId: find in Dashboard URL (starts with biz_)
                        companyId: "biz_xxxxxxxxxxxxxx",
                        // apiKey: create in Dashboard > Developer with iap:read permission
                        apiKey: "your_api_key_here",
                        planMappings: [
                            .init(whopId: "plan_xxxxx", appleId: "monthly_sub")
                        ]
                    )
                }
        }
    }
}

WhopElements (embedded Chat, Payouts…)

Use WhopElements to embed Whop chat channels in your app.

Step 1: Add Package Dependency

In Xcode, go to File → Add Package Dependencies…

Enter the package URL:

https://github.com/whopio/whopsdk-elements-swift

Step 2: Select Version

Choose the latest version or specify a version range.

Step 3: Import and Configure the specific element

import SwiftUI
import WhopElements
@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            NavigationStack {
                WhopChatView(channelId: "chat_feed_XXXXXXXXXXXXXX")
            }
            .task {
                await WhopSDK.configureWithOAuth(appId: "app_XXXXXXXXXXXXXX")
            }
        }
    }
}

Requirements

• iOS 17.0+
• Xcode 15.0+
• Swift 5.10+

Next steps