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

# Activer Apple Pay et Google Pay

> Hébergez le fichier de vérification Apple Pay et enregistrez votre domaine pour qu'Apple Pay et Google Pay fonctionnent dans les Whop Elements de votre site.

Apple Pay et Google Pay permettent aux clients de payer avec le portefeuille déjà présent sur leur appareil. Lorsqu'un élément de paiement ou de checkout [Whop Elements](https://docs.whop.com/fr/elements/latest/getting-started.md) s'affiche sur votre propre site, les deux portefeuilles exigent qu'Apple Pay soit prêt sur le domaine de la page. Un seul domaine avec Apple Pay prêt active les deux portefeuilles pour tous les éléments de cette page.

> [!NOTE]
>
> La vérification de domaine n'est requise que pour les pages que vous hébergez. Les pages de paiement
> hébergées par Whop et whop.com sont déjà approuvées.

## Prérequis

Avant de configurer Apple Pay, vérifiez que vous disposez de :

* Un domaine sur lequel vous montez les Whop Elements
* La possibilité d'héberger un fichier sur ce domaine (pour servir le fichier de vérification Apple Pay)

## Vérification auto-hébergée

Pour vérifier votre domaine, servez le fichier d'association de domaine de l'identifiant marchand Apple Pay à un chemin précis de votre domaine, puis enregistrez le domaine auprès de Whop.

### Étape 1 : télécharger le fichier de vérification

Téléchargez le [fichier de vérification Apple Pay](https://whop.com/.well-known/apple-platform-integrator/apple-developer-merchantid-domain-association).

### Étape 2 : héberger le fichier

Hébergez ce fichier au chemin suivant sur votre domaine :

```
https://<your-domain>/.well-known/apple-developer-merchantid-domain-association
```

Le fichier doit être :

* Servi en HTTPS
* Accessible sans authentification
* Servi avec le contenu exact (sans modification)

> [tab] Next.js
>
> Placez le fichier dans votre dossier `public` :
>
> ```
> public/
> └── .well-known/
>     └── apple-developer-merchantid-domain-association
> ```

> [tab] Nginx
>
> Ajoutez un bloc location pour servir le fichier :
>
> ```nginx theme={null}
> location /.well-known/apple-developer-merchantid-domain-association {
>     alias /path/to/apple-developer-merchantid-domain-association;
>     default_type application/octet-stream;
> }
> ```

> [tab] Vercel
>
> Créez un fichier `vercel.json` avec une règle de réécriture qui redirige vers le fichier hébergé sur whop.com :
>
> ```json theme={null}
> {
>   "rewrites": [
>     {
>       "source": "/.well-known/apple-developer-merchantid-domain-association",
>       "destination": "https://whop.com/.well-known/apple-platform-integrator/apple-developer-merchantid-domain-association"
>     }
>   ]
> }
> ```

> [tab] Cloudflare Pages
>
> Placez le fichier dans votre répertoire de sortie :
>
> ```
> dist/
> └── .well-known/
>     └── apple-developer-merchantid-domain-association
> ```

### Étape 3 : vérifier l'accès au fichier

Vérifiez que vous pouvez accéder au fichier en visitant :

```
https://<your-domain>/.well-known/apple-developer-merchantid-domain-association
```

Le fichier doit se télécharger ou afficher son contenu sans aucune erreur.

### Étape 4 : enregistrer votre domaine

Enregistrez le domaine depuis le tableau de bord ou via l'API. Dans les deux cas, Whop vérifie que le fichier est accessible avant d'enregistrer le domaine auprès d'Apple.

> [tab] Tableau de bord
>
> Ouvrez **Websites** dans votre tableau de bord et sélectionnez le domaine. Sélectionnez **Fix Apple Pay**, suivez les étapes, puis sélectionnez **Check now**.

> [tab] API
>
> Ajoutez le domaine avec Apple Pay via l'[API Domains](https://docs.whop.com/fr/api-reference/domains/domain). Si votre compte possède déjà le domaine, [mettez-le à jour](https://docs.whop.com/fr/api-reference/domains/update-domain.md) avec `apple_pay: {}` à la place. Votre clé API doit disposer de l'autorisation `domain:manage`.
>
> ```typescript TypeScript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const domain = await client.domains.create({
>   domain: "shop.example.com",
>   apple_pay: {},
> });
>
> console.log(domain.apple_pay?.state); // "pending" while Whop registers the domain with Apple
> ```
>
> ```python Python theme={null}
> import os
> from whop_sdk import Whop
>
> client = Whop(token=os.environ["WHOP_API_KEY"])
>
> domain = client.domains.create(domain="shop.example.com", apple_pay={})
>
> print(domain.apple_pay.state)  # "pending" while Whop registers the domain with Apple
> ```
>
> Whop enregistre le domaine auprès d'Apple en arrière-plan. [Récupérez le domaine](https://docs.whop.com/fr/api-reference/domains/retrieve-domain.md) jusqu'à ce que `apple_pay.state` soit `ready`, ou `action_required` lorsqu'Apple n'a pas pu récupérer le fichier. Une fois le fichier hébergé, enregistrez à nouveau un domaine `action_required` avec [Check Domain](https://docs.whop.com/fr/api-reference/domains/check-domain.md) :
>
> ```typescript TypeScript theme={null}
> await client.domains.check({ id: domain.id });
> ```
>
> ```python Python theme={null}
> client.domains.check(id=domain.id)
> ```
>
> L'API Domains remplace l'API Payment Method Domains, désormais obsolète. Le [journal des modifications de l'API](https://docs.whop.com/fr/developer/api/versioning.md) indique la correspondance de chacune de ses requêtes avec l'API Domains.

## Dépannage

> [accordion] Le bouton Apple Pay ou Google Pay n'apparaît pas
>
> * Assurez-vous que votre domaine apparaît comme vérifié dans **Payment domains** ou renvoie `apple_pay.state: "ready"` depuis l'[API Domains](https://docs.whop.com/fr/api-reference/domains/retrieve-domain.md).
> * L'[ExpressCheckoutElement](https://docs.whop.com/fr/elements/latest/checkout/expressCheckout.md) n'affiche que les portefeuilles avec lesquels l'appareil de l'acheteur peut payer, et n'affiche rien si aucun portefeuille n'est disponible. Testez Apple Pay dans Safari sur un véritable appareil Apple, et non dans un simulateur.
> * Si vous utilisez **Framer**, chargez le script Elements via Custom Code dans les en-têtes de votre site, et non via le composant Embed. Le composant Embed de Framer utilise une iframe `srcdoc`, que Safari considère comme un contexte non sécurisé et dans laquelle il bloque Apple Pay.

> [accordion] Le fichier auto-hébergé renvoie une erreur 404
>
> * Vérifiez que le fichier se trouve au bon emplacement :
>   `/.well-known/apple-developer-merchantid-domain-association`.
> * Vérifiez que votre serveur web sert les fichiers sans extension.
> * Assurez-vous que la configuration de votre hébergement ne bloque pas le répertoire `.well-known`.

## Étapes suivantes

> [card] [Express Checkout](https://docs.whop.com/fr/developer/guides/express-checkout.md)
>
> Ajoutez des boutons Apple Pay et Google Pay en un clic à votre site

> [card] [Liens de paiement](https://docs.whop.com/fr/payments/create-checkout-link.md)
>
> Créez des liens de paiement partageables pour vos produits
