Whop

Get started

1. 1

   Use the sandbox

   Sign up at sandbox.whop.com. Sandbox and production share no accounts, keys or products.

   sandbox.whop.com
2. 2

   Create a key for the app

   In Dashboard → Developer, create an API key with the iap:read permission. Only this scoped key may ship in an app; never put an account API key in mobile code.

3. 3

   Add the iOS Checkout SDK

   In Xcode, choose File → Add Package Dependencies and enter the repository URL. It needs iOS 17 or later.

   Copy

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

4. 4

   Configure it and gate a screen

   MyApp.swiftCopy

   import SwiftUI
   import WhopCheckout
   
   @main
   struct MyApp: App {
       var body: some Scene {
           WindowGroup {
               ContentView()
                   .environment(Checkout.shared)
                   .task {
                       try? await Checkout.shared.configure(
                           companyId: "biz_xxxxxxxxxxxxxx",
                           apiKey: "your_api_key_here",
                           planMappings: [
                               .init(whopId: "plan_xxxxx", appleId: "monthly_sub")
                           ]
                       )
                   }
           }
       }
   }
   
   struct ContentView: View {
       @Environment(Checkout.self) var checkout
   
       var body: some View {
           if checkout.isSubscribed {
               Text("Welcome, premium user!")
           } else {
               Button("Upgrade to Premium") {
                   Task {
                       try? await checkout.purchase("plan_xxxxx")
                   }
               }
           }
       }
   }

5. 5

   Handle payments on the server

   Keep the full API key on a server, such as a Convex action, and listen for the payment.succeeded webhook.

   Copy

   npm install @whop/sdk
   export WHOP_ENVIRONMENT=sandbox
   export WHOP_API_KEY=your_sandbox_key

   Whop developer quickstart