> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Installer les SDK iOS de Whop

> Installez les SDK WhopCheckout et WhopElements avec Swift Package Manager, et créez la clé API dont WhopCheckout a besoin.

Whop distribue ses SDK iOS sous forme de packages Swift distincts : **WhopCheckout** pour les paiements et **WhopElements** pour le chat intégré et les versements. N'installez que ce dont vous avez besoin.

## WhopCheckout (achats intégrés)

Le package WhopCheckout gère les abonnements et les paiements dans votre app.

### Étape 1 : ajouter la dépendance du package

Dans Xcode, allez dans **File** → **Add Package Dependencies...**.

Saisissez l'URL du package :

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

### Étape 2 : sélectionner la version

Choisissez la dernière version ou une plage de versions :

* **Up to Next Major** : recommandé pour la production
* **Exact Version** : pour la stabilité

### Étape 3 : créer une clé API

Le SDK nécessite une clé API disposant uniquement de la permission `iap:read`. Whop a conçu cette permission pour une utilisation côté client : vous pouvez donc intégrer la clé dans le bundle de votre app.

**1. Ouvrir les Developer Settings**

Accédez aux [Developer Settings de Whop](https://whop.com/dashboard/developer) et sélectionnez votre app.

**2. Créer la clé API**

Sélectionnez **Create API Key**, puis sélectionnez **uniquement** la permission `iap:read`.

**3. Copier la clé**

Copiez la clé générée : vous la transmettrez à `Checkout.shared.configure()` à l'étape suivante.

> [!WARNING]
>
> N'accordez que la permission `iap:read`. C'est la seule permission conçue pour une utilisation côté client, et elle limite la clé aux opérations d'achat intégré. N'embarquez jamais dans votre app une clé disposant de permissions plus étendues.

### Étape 4 : importer et configurer

```swift theme={null}
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")
                        ]
                    )
                }
        }
    }
}
```

> [card] [Créer un paywall](https://docs.whop.com/fr/developer/guides/ios/build-a-paywall.md)
>
> Poursuivez avec le guide de configuration complet

***

## WhopElements (chat intégré et wallet)

Utilisez WhopElements pour intégrer des canaux de chat Whop dans votre app.

### Étape 1 : ajouter la dépendance du package

Dans Xcode, allez dans **File** → **Add Package Dependencies...**.

Saisissez l'URL du package :

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

### Étape 2 : sélectionner la version

Choisissez la dernière version ou une plage de versions.

### Étape 3 : importer et configurer l'élément spécifique

```swift theme={null}
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")
            }
        }
    }
}
```

> [card] [Chat intégré](https://docs.whop.com/fr/developer/guides/chat/quickstart.md)
>
> Poursuivez avec le guide d'intégration du chat

> [card] [Wallet Elements](https://docs.whop.com/fr/elements/latest/getting-started.md)
>
> Affichez les soldes et l'activité d'un compte avec les éléments wallet en Swift

***

## Prérequis

* iOS 17.0+
* Xcode 15.0+
* Swift 5.10+

## Prochaines étapes

> [card] [Créer un paywall](https://docs.whop.com/fr/developer/guides/ios/build-a-paywall.md)
>
> Ajoutez des abonnements et des paiements

> [card] [Vérifier les droits d'accès](https://docs.whop.com/fr/developer/guides/ios/check-entitlements.md)
>
> Protégez le contenu en fonction du statut d'abonnement

> [card] [Chat intégré](https://docs.whop.com/fr/developer/guides/chat/quickstart.md)
>
> Ajoutez le chat Whop à votre app

> [card] [Wallet Elements](https://docs.whop.com/fr/elements/latest/getting-started.md)
>
> Affichez les soldes et l'activité d'un compte avec les éléments wallet en Swift

> [card] [Référence de l'API](https://docs.whop.com/fr/developer/guides/ios/checkout-reference.md)
>
> Documentation complète du SDK


## Related topics

- [SDK iOS Checkout](https://docs.whop.com/fr/developer/guides/ios/overview.md)
- [Référence du SDK iOS Checkout](https://docs.whop.com/fr/developer/guides/ios/checkout-reference.md)
- [Démarrage rapide de l'API Whop](https://docs.whop.com/fr/developer/quickstart.md)
