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

# AdsAgreementElement

> Signe le contrat Whop Ads Services and Payment Authorization Agreement pour un compte. L'enregistrement de la facturation des dépenses publicitaires du compte ouvre le contrat ; tant qu'un représentant autorisé ne l'a pas signé, aucune campagne ne peut être lancée. Le signataire saisit son nom légal complet et, facultativement, sa fonction, accepte les conditions, et la signature saisie est archivée avec le contrat. Une fois le contrat signé, l'élément indique qui l'a signé et quand ; tant que la facturation n'est pas configurée, il n'y a rien à signer et l'élément l'indique. `campaign-creator` l'ouvre lui-même par-dessus le builder lorsqu'un lancement nécessite une signature : ne le montez donc vous-même que pour proposer la signature à l'avance — sur une page de paramètres ou d'onboarding, par exemple.

> [!NOTE]
>
> Cette page documente `@whop/elements@1.10.0` et `@whop/elements-react@1.10.0`.

*Depuis `v1.9.0`.*

Se monte à l'intérieur de [`Ads`](https://docs.whop.com/fr/elements/latest/ads/overview). `accountId` et `accessToken` proviennent de celui-ci. Transmettez les props et les callbacks via les options de création ou les props React.

> [!NOTE]
>
> Vous pouvez monter cet élément **inline** (`create`) ou l'ouvrir sous forme d'overlay **modal** (`createOverlay`).

```tsx React theme={null}
import { WhopElements, Ads, AdsAgreementElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <AdsAgreementElement onSigned={(e) => console.log(e)} />
      </Ads>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const ads = window.WhopElements().ads.create({ /* options */ });
  ads.create('ads-agreement', { onSigned: (e) => console.log(e) }).mount('#ads-ads-agreement');
</script>
```

Données d'exemple. [Ouvrir le Playground](https://docs.whop.com/fr/elements/latest/ads/overview#playground).

## Props

*Cet élément n'accepte aucune prop de l'intégrateur.*

## Événements

Transmettez les callbacks dans les options de création ou dans les props React.

### `onSigned`

Le contrat a été signé et enregistré. `agreementVersion` est la version signée ; `acceptedAt` indique quand, sous forme d'horodatage ISO 8601. Une fenêtre modale se ferme lors de cet événement.

**payload** `object`

**propriétés**

**agreementVersion** `string | null` *required*

**acceptedAt** `string | null` *required*

### `onLoaderStart`

S'exécute après le premier affichage du squelette de chargement et avant `onReady`.

### `onReady`

S'exécute après le premier affichage complet de l'élément.

### `onError`

S'exécute lorsque l'élément ne parvient pas à se charger ou plante. L'affichage de repli reste visible. Utilisez `code` pour une gestion programmatique. `sourceKey` identifie une source d'état hôte en échec.

**e** `object`

**propriétés**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Méthodes

Appelez-les sur le handle renvoyé par `create`, ou via une `ref` React.

### `mount`

Monte l'élément dans `target` et démarre le chargement. Les composants React se montent eux-mêmes.

**Paramètres**

**target** `string | HTMLElement` *required*

### `destroy`

Supprime l'élément et libère son frame et ses abonnements. Vous pouvez l'appeler plusieurs fois. React supprime l'élément automatiquement.

### `update`

Fusionne de nouvelles props dans l'élément monté. Avec React, modifiez plutôt les props du composant.

**Paramètres**

**options** `Partial\<AdsAgreementElementProps\>` *required*

## Style

Cet élément n'expose pas de noms de classes pour le style. Utilisez `appearance` (thème, couleur d'accent, variables) pour modifier son apparence.


## Related topics

- [Ads](https://docs.whop.com/fr/elements/latest/ads/overview.md)
- [CampaignCreatorElement](https://docs.whop.com/fr/elements/latest/ads/campaign-creator.md)
- [TableElement](https://docs.whop.com/fr/elements/latest/ads/reporting-table.md)
