> ## 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.

# Demander des autorisations pour votre app

> Configurez les autorisations dont votre app a besoin et demandez l'approbation des créateurs qui l'installent.

Les apps utilisent des autorisations pour accéder aux données du compte et agir au nom des utilisateurs. Chaque appel API nécessite l'autorisation correspondante. Vous déclarez celles dont vous avez besoin dans les paramètres de votre app, les créateurs les approuvent lors de l'installation, et vos appels SDK ne réussissent qu'une fois que les créateurs ont accordé ces autorisations.

> [!TIP]
>
> Retrouvez les autorisations requises pour n'importe quel endpoint dans la référence API. Chaque page d'opération les liste sous « Required permissions ».

## Autorisations requises et facultatives

Vous pouvez marquer chaque autorisation comme requise ou facultative. Ce choix modifie l'expérience d'installation pour les créateurs.

| Type | Le créateur peut la désactiver à l'installation | À utiliser quand |
| - | - | - |
| **Requise** | Non | L'app ne peut pas fonctionner sans ce scope |
| **Facultative** | Oui | Le scope alimente une fonctionnalité secondaire, pas le flux principal (p. ex. analytics sur option) |

Les autorisations facultatives conviennent bien aux fonctionnalités sur option. Si un créateur refuse une autorisation facultative, votre app doit continuer à fonctionner, simplement sans cette fonctionnalité.

## Configurer les autorisations

> [!WARNING]
>
> Le flux d'autorisations est obligatoire, même pour tester sur votre propre compte. Le flux est le même à l'installation et en auto-test, ce qui vous permet de repérer tôt les scopes manquants.

**1. Ouvrez l'onglet des autorisations de votre app**

1. Accédez au [tableau de bord développeur](https://whop.com/dashboard/developer).
2. Sélectionnez ou créez une app.
3. Sélectionnez l'onglet **Permissions**.

![Paramètres des autorisations](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=514a98987e714d5a2542b3d7665020f7)

**2. Ajoutez les autorisations dont vous avez besoin**

Sélectionnez **Add permissions**, choisissez ce dont votre app a besoin, puis confirmez.

Comparez avec les endpoints API que vous prévoyez d'appeler et ajoutez toutes les autorisations qu'ils exigent.

**3. Configurez chaque autorisation**

Pour chacune :

1. Rédigez une courte justification expliquant pourquoi l'app en a besoin. Les créateurs la voient lors de l'installation, et chaque autorisation doit avoir sa propre justification pour respecter les [exigences de publication sur l'App Store](https://docs.whop.com/fr/developer/apps/listing-requirements.md).
2. Marquez-la comme **requise** ou **facultative**.

![Justification des autorisations](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings-justification.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=93ec46a13be088ad236a7fe69f6f6ad2)

**4. Enregistrez**

![Enregistrer les paramètres des autorisations](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings-save.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=683b42f4dcfed0eeee535d82dcce3e5f)

**5. Installez sur un compte de test**

Ouvrez votre lien d'installation direct : `https://whop.com/apps/app_xxxxxxxxx/install`.

Choisissez un compte, examinez la demande d'autorisations, puis approuvez.

![Demande d'autorisations](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-oauth.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=4b427b52f269ee6b92fcf7434069ad43)

## Mettre à jour les autorisations ultérieurement

Les autorisations peuvent évoluer avec l'app. Lorsque vous en ajoutez une nouvelle :

* Les installations existantes voient un bouton **Re-approve** à côté de votre app.
* Les appels API qui nécessitent la nouvelle autorisation échouent tant que chaque créateur ne l'a pas réapprouvée.

> [!NOTE]
>
> Lorsque vous ajoutez une autorisation, réapprouvez-la aussi sur votre propre compte de test. Les nouveaux scopes ne sont pas appliqués tant que vous ne les avez pas acceptés dans [Authorized apps](https://whop.com/dashboard/settings/authorized-apps).

Les créateurs peuvent gérer à tout moment les autorisations accordées dans `Dashboard → Settings → Authorized apps`.

<video controls src="https://mintcdn.com/whop/_aQsA39rzB5Zq8ZK/how-to-videos/configure-app-permissions.mp4?fit=max&auto=format&n=_aQsA39rzB5Zq8ZK&q=85&s=dff99f10fb43e8914fdcd1b0eb4bd044" />

## Questions fréquentes

> [accordion] Combien d'autorisations une app peut-elle demander ?
>
> Jusqu'à 100 par app.

> [accordion] Où sont listées les autorisations requises pour un endpoint ?
>
> Chaque endpoint de la [référence API](https://docs.whop.com/fr/api-reference/payments/list-payments.md) liste directement ses autorisations requises.
>
> ![Autorisations dans la référence SDK](https://mintcdn.com/whop/purcney6SuEUQzS5/images/sdk-reference-required-permissions.png?fit=max\&auto=format\&n=purcney6SuEUQzS5\&q=85\&s=141d5a09a00942f216c98d233824dcf9)

> [accordion] Une app peut-elle demander des autorisations supplémentaires par la suite ?
>
> Oui. Vous pouvez demander des autorisations supplémentaires et le créateur sera invité à les réapprouver.
>
> > [!NOTE]
> >
> > Tant que les autorisations n'ont pas été réapprouvées, les requêtes API nécessitant les autorisations **nouvellement demandées** échoueront. Assurez-vous que votre code gère ces erreurs et propose une solution de repli utile.
>
> > [!WARNING]
> >
> > Pendant le développement de votre app, veillez à réapprouver vous-même les autorisations dans vos paramètres [Authorized apps](https://whop.com/dashboard/settings/authorized-apps).
> >
> > Consultez [Configurer vos autorisations](https://docs.whop.com/fr/developer/guides/permissions.md#update-permissions-later) pour plus d'informations.

## Étapes suivantes

> [card] [Authentification](https://docs.whop.com/fr/developer/guides/authentication.md)
>
> Vérifiez l'utilisateur à l'origine d'une requête et contrôlez son niveau d'accès.

> [card] [Écouter les webhooks](https://docs.whop.com/fr/developer/guides/webhooks.md)
>
> Recevez les événements de paiement, d'adhésion et d'inscription. Les webhooks nécessitent leurs propres scopes `webhook_receive:*`.

> [card] [Suivre les installations](https://docs.whop.com/fr/developer/guides/app-installations.md)
>
> Sachez quand un compte installe ou supprime votre app, et associez-le à vos propres enregistrements.

> [card] [Créer des vues d'app](https://docs.whop.com/fr/developer/guides/app-views.md)
>
> Configurez les vues du tableau de bord, les expériences et les fiches Discover.

> [card] [Lancer un proxy de développement local](https://docs.whop.com/fr/developer/guides/dev-proxy.md)
>
> Reproduisez en localhost la configuration iframe + cookie de production.


## Related topics

- [Notifications push](https://docs.whop.com/fr/developer/guides/notifications.md)
- [OAuth](https://docs.whop.com/fr/developer/guides/oauth.md)
- [Créer des apps Whop avec React Native](https://docs.whop.com/fr/developer/guides/react-native.md)
