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

# Personnalisation du checkout

> Personnalisez l'apparence de vos pages de paiement avec les couleurs des boutons, les polices et les styles de bordure

La personnalisation du checkout vous permet d'aligner vos pages de paiement sur votre marque. Choisissez une couleur d'arrière-plan, une couleur de bouton, une police et un style de bordure au niveau du compte, et remplacez-les éventuellement par lien de paiement ou par session de paiement via l'API.

> [card] [Essayer le checkout playground](https://whop.com/checkout-playground)
>
> Prévisualisez la couleur d'arrière-plan, la couleur des boutons, la police et le style de bordure sur un checkout en direct avant de les appliquer.

## Ce que vous pouvez personnaliser

| Paramètre | Description |
| - | - |
| **Couleur d'arrière-plan** | Un code couleur hexadécimal appliqué au panneau récapitulatif de la commande sur la page de paiement (par ex. `#F4F4F5`) |
| **Couleur des boutons** | Un code couleur hexadécimal pour la couleur des boutons (par ex. `#FF5733`) |
| **Police** | `system` (par défaut), `roboto` ou `open_sans` |
| **Style de bordure** | `rounded` (par défaut), `pill` ou `rectangular` |

## Personnalisation globale

La personnalisation globale s'applique à tous les liens de paiement de votre entreprise. Les liens individuels héritent de ces paramètres, sauf s'ils disposent de leurs propres remplacements.

1. Accédez à **Dashboard** > **Settings** > **Checkout Branding**
2. Choisissez votre **couleur d'arrière-plan**, votre **couleur de bouton**, votre **police** et votre **style de bordure**
3. Utilisez l'aperçu en direct pour voir à quoi ressemblera votre checkout
4. Sélectionnez **Save**

## Remplacements par lien

Remplacez la personnalisation globale sur un lien de paiement spécifique. C'est utile lorsqu'un produit ou une campagne en particulier nécessite une apparence différente.

1. Accédez à **Dashboard** > **Checkout Links**
2. Modifiez le lien de paiement que vous souhaitez personnaliser
3. Dans la section **Checkout branding**, ajustez n'importe quel paramètre
4. Enregistrez vos modifications

Tout paramètre laissé sur **Global default** hérite de la personnalisation du compte. Seuls les paramètres que vous modifiez explicitement sont remplacés pour ce lien.

> [!NOTE]
>
> La personnalisation par lien a priorité sur la personnalisation globale. Si vous
> modifiez vos paramètres globaux ultérieurement, tout lien disposant de ses propres
> remplacements conserve ses valeurs personnalisées pour les paramètres remplacés.

## Personnaliser des sessions de paiement individuelles

Définissez la personnalisation de sessions de paiement individuelles à l'aide du paramètre `checkoutStyling` lors de la création d'une session de paiement. La personnalisation au niveau de la session a la priorité la plus élevée.

L'ordre de résolution est : **session de paiement** > **lien de paiement (plan)** > **paramètres par défaut du compte**.

```graphql theme={null}
mutation {
	createCheckoutSession(
		input: {
			planId: "plan_XXXXXXXXX"
			checkoutStyling: {
				backgroundColor: "#F4F4F5"
				buttonColor: "#FF5733"
				fontFamily: roboto
				borderStyle: pill
			}
		}
	) {
		id
		purchaseUrl
		checkoutStyling {
			backgroundColor
			buttonColor
			fontFamily
			borderStyle
		}
	}
}
```

### Paramètres

| Champ | Type | Description |
| - | - | - |
| `backgroundColor` | String | Un code couleur hexadécimal (par ex. `#F4F4F5`). `null` pour hériter. |
| `buttonColor` | String | Un code couleur hexadécimal (par ex. `#FF5733`). `null` pour hériter. |
| `fontFamily` | enum | `system`, `roboto` ou `open_sans`. `null` pour hériter. |
| `borderStyle` | enum | `rounded`, `pill` ou `rectangular`. `null` pour hériter. |

Passez `null` pour n'importe quel champ afin d'hériter du niveau suivant de la chaîne de résolution.

## Ajouter une adresse e-mail connue

Contrôlez le champ e-mail des pages de paiement à l'aide de paramètres d'URL. C'est utile lorsque vous connaissez déjà l'e-mail d'un client grâce à une page d'atterrissage ou à un outil de gestion de la relation client. Vous évitez ainsi de redemander l'adresse e-mail.

| Paramètre | Effet |
| - | - |
| `email` | Remplit le champ e-mail |
| `email.disabled=1` | Verrouille le champ e-mail pour que le client ne puisse pas le modifier |
| `email.hidden=1` | Masque entièrement le champ e-mail |

### Exemples

Préremplir et verrouiller :

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.disabled=1
```

Préremplir et masquer :

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.hidden=1
```

> [!NOTE]
>
> Fournissez le paramètre `email` pour utiliser `email.hidden` ou `email.disabled`. Si vous activez
> les deux options, le checkout masque le champ.

Lorsque vous intégrez l'[élément Checkout](https://docs.whop.com/fr/elements/latest/checkout/checkout.md) sur votre propre site, passez `buyerEmail` pour préremplir l'adresse et `lockBuyerEmail` pour empêcher l'acheteur de la modifier.

## Ajouter un numéro de téléphone et une adresse connus

Renseignez le numéro de téléphone, les informations de facturation et l'adresse de livraison du client à l'aide de paramètres d'URL. Le client peut toujours modifier chaque champ prérempli.

| Paramètre | Effet |
| - | - |
| `phone` | Remplit le numéro de téléphone, y compris le téléphone de facturation pour les moyens de paiement qui en nécessitent un |
| `name` | Remplit le nom de facturation |
| `address.line1`, `address.line2`, `address.city` | Remplissent l'adresse de facturation |
| `address.state`, `address.postal_code`, `address.country` | Remplissent l'adresse de facturation |
| `shipping.name` | Remplit le nom du destinataire de la livraison |
| `shipping.address.line1`, `shipping.address.city`, … | Remplissent l'adresse de livraison, avec les mêmes champs que l'adresse de facturation |

Incluez l'indicatif du pays dans `phone` et encodez le signe plus sous la forme `%2B`, par exemple `phone=%2B14155552671`. Utilisez un code pays à deux lettres pour `country`, comme `US`.

### Exemple

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&phone=%2B14155552671&name=Ada+Lovelace&address.country=US&address.postal_code=94107
```

## E-mails clients

Whop envoie des e-mails à vos clients concernant leurs achats et abonnements. Le nom de l'expéditeur est le nom de votre entreprise suivi de **via Whop**, par exemple **Acme via Whop**. L'adresse de l'expéditeur est `no-reply@businesses.whop.com`. Si vous avez ajouté un logo d'entreprise, il apparaît en haut de chaque e-mail.

Les sous-comptes qu'une plateforme crée via l'API démarrent avec les e-mails clients désactivés. La plateforme peut les activer avec le champ `send_customer_emails`.

| E-mail | Quand Whop l'envoie |
| - | - |
| **Confirmation de commande** | Après un achat unique ou le premier paiement d'un abonnement. Les achats gratuits n'en reçoivent pas. |
| **Reçu de renouvellement** | Après chaque prélèvement de renouvellement, y compris le premier prélèvement après un essai gratuit, et après un prélèvement lié à un changement de plan. Il indique le montant, le libellé du relevé bancaire lorsque Whop en dispose, et un lien pour mettre à jour la carte ou annuler. |
| **Renouvellement à venir** | Une fois par période de facturation, avant le renouvellement de l'abonnement. Les essais gratuits de plus de 7 jours le reçoivent 7 jours avant le premier prélèvement. Les plans facturés tous les 6 mois ou moins souvent le reçoivent 30 jours avant le renouvellement. Tous les autres le reçoivent environ 24 heures avant le renouvellement. Whop ne l'envoie pas si le membre a annulé ou si vous avez suspendu ses paiements. |
| **Échec de paiement** | Lorsqu'un paiement d'abonnement échoue et que [Whop va le relancer](https://docs.whop.com/fr/payments/payment-declines.md). Whop ne l'envoie pas pour la dernière tentative échouée qui annule l'abonnement. Certains moyens de paiement, comme PayPal, ne reçoivent pas cet e-mail. |
| **Abonnement annulé** | Lorsque vous ou le membre annulez un abonnement, même si l'accès se poursuit jusqu'à la fin de la période de facturation. |
| **Remboursement** | Lorsque vous remboursez un paiement. |

Pour un essai gratuit, l'e-mail de renouvellement à venir sert de rappel de fin d'essai. Whop n'envoie pas d'e-mail de bienvenue distinct. Pour accueillir les nouveaux membres par e-mail, configurez un [message **User joins**](https://docs.whop.com/fr/manage-your-business/growth-marketing/automated-messaging.md) et cochez **Send email to user when triggered**.

### Désactiver les e-mails clients

1. Accédez à **Dashboard** > **Settings** > **Checkout**
2. Désactivez **Send transactional emails to your members**

> [!WARNING]
>
> Lorsque les e-mails clients sont désactivés, vos clients ne reçoivent de Whop ni confirmations de commande, ni reçus de renouvellement, ni rappels de renouvellement ou de fin d'essai, ni avis d'échec de paiement. Ces e-mails aident les clients à reconnaître les prélèvements, ce qui peut éviter des demandes de remboursement et des litiges.

Cela interrompt les e-mails de ce tableau. Les e-mails de facture et les avis de modification du calendrier de facturation sont toujours envoyés, tout comme vos messages automatisés.

Vous ne pouvez pas modifier le texte des e-mails de Whop. Pour envoyer vos propres e-mails, déclenchez-les à partir des [webhooks](https://docs.whop.com/fr/developer/guides/webhooks.md).


## Related topics

- [Guide du programme Whop Partner](https://docs.whop.com/fr/partners.md)
- [SaaS](https://docs.whop.com/fr/supported-business-models/saas.md)
- [Contrôles de paiement](https://docs.whop.com/fr/trust-and-safety/account-health/controls.md)
