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

# EmailElement

> Collecte l'e-mail de l'acheteur et le transmet à `payments.createConfirmationToken()` tant qu'il est monté. Un `billingDetails.email` explicite est prioritaire. Un compte Whop correspondant affiche une connexion facultative avec vérification par code, ou avec la passkey du compte lorsqu'il en possède une. Une connexion réussie débloque les moyens de paiement enregistrés dans l'élément de paiement. Les acheteurs peuvent continuer en tant qu'invités.

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

*Depuis `v1.0.0`.*

Se monte à l'intérieur de [`Payments`](https://docs.whop.com/fr/elements/latest/payments/overview). Transmettez les props et les callbacks via les options de création ou les props React.

Se monte à l'intérieur d'un scope `WhopPayments`. Collecte l'e-mail de l'acheteur, que chaque jeton de confirmation exige, et le contrôleur le lit pour générer le jeton, que vous le liiez ou non.

Montez-le à l'intérieur de `<Payments>`, qui gère le débit et le jeton de confirmation. `<Payments>` se monte lui-même à l'intérieur de `<WhopElements>`. Il collecte l'e-mail de l'acheteur et le publie auprès du provider, de sorte que `createConfirmationToken` l'envoie sans qu'on ait à lui transmettre quoi que ce soit.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <EmailElement onChange={(e) => console.log(e)} />
      </Payments>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { EmailElement, Payments } from '@whop/elements-react-native';

export function ContactStep() {
  return (
    <Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx">
      <EmailElement onChange={({ email, complete }) => console.log(email, complete)} />
    </Payments>
  );
}
```

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

```swift Swift theme={null}
import Elements
import SwiftUI

// .whopElements(environment:) runs once at the app root. See Getting started.
struct CheckoutScreen: View {
    @State private var email = ""

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopEmailElement(email: $email)
                    WhopBrandingElement()
                }
                .padding()
            }
        }
    }
}
```

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

[EmailElement exécuté sur Android, dans l'application d'exemple React Native](https://app.revyl.ai/embed/00ebe239-4c8b-4fe4-90d9-0e57771e2f35?controls=0)

## Props

**label** `boolean`

Affiche le libellé localisé. Définissez `false` si vous fournissez le vôtre. Le champ conserve un `aria-label` localisé. Par défaut : `true`.

**placeholder** `string`

Texte du placeholder du champ e-mail. Vide (par défaut), il affiche `you@example.com`. Avec les libellés flottants, c'est le texte du libellé qui sert de placeholder. Par défaut : `""`.

**labelMode** `"above" | "floating"`

`above` (par défaut) affiche le libellé au-dessus du champ. `floating` utilise le texte du libellé comme placeholder, puis affiche un petit libellé au-dessus du texte saisi dès que le champ a une valeur. Ignoré lorsque `label` vaut `false`. Par défaut : `"above"`. Depuis `v1.5.0`.

**defaultValue** `string`

Valeur initiale appliquée une fois au montage. Par défaut : `""`.

## Événements

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

### `onChange`

Se déclenche lorsque l'e-mail change. `complete` vaut true lorsque l'adresse est plausible. La connexion le déclenche avec l'e-mail connecté, qui alimente aussi `createConfirmationToken()`.

**payload** `object`

**propriétés**

**email** `string` *required*

**complete** `boolean` *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\<EmailElementProps\>` *required*

## Style

Stylisez ces parties via `appearance.classes`. Utilisez le camel case ou le kebab case pour les noms de propriétés et incluez les unités. Les feuilles de style de la page ne peuvent pas atteindre le frame de l'élément. Le framework valide chaque déclaration avant de l'injecter.

| Classe | Cible |
| - | - |
| `.whop-Email` | Racine de l'élément e-mail |
| `.whop-EmailChecking` | Le contour animé pendant la vérification de l'e-mail ou l'envoi d'un code de connexion |
| `.whop-EmailCodeHint` | La ligne demandant le code de connexion |
| `.whop-EmailError` | Message d'e-mail invalide |
| `.whop-EmailInput` | Le champ e-mail |
| `.whop-EmailInputInvalid` | Champ e-mail contenant une valeur non plausible |
| `.whop-EmailLabel` | Libellé du champ e-mail |
| `.whop-EmailPasskey` | Le bouton de connexion par passkey dans le champ e-mail |
| `.whop-EmailSignedIn` | Ligne de l'acheteur connecté |
| `.whop-EmailSignIn` | Contrôle de connexion « Welcome back » |
| `.whop-EmailSignInError` | Message d'erreur de connexion |
| `.whop-EmailSignOut` | Contrôle permettant de choisir un autre e-mail |
| `.whop-EmailWelcome` | Le message d'accueil affiché au-dessus de l'e-mail du compte |
| `.whop-VerificationError` | Le message d'échec dans la boîte de dialogue |
| `.whop-VerificationInput` | Le champ du code à usage unique |
| `.whop-VerificationInputInvalid` | Ajoutée au champ de code après une tentative échouée |
| `.whop-VerificationInputSlot` | Une case de chiffre du champ de code à usage unique |
| `.whop-VerificationInputSlotActive` | Ajoutée à la case de code dans laquelle l'acheteur saisit |
| `.whop-VerificationPending` | La ligne « verifying… » pendant qu'un envoi est en cours |

```ts theme={null}
const payments = whop.payments.create({
  appearance: {
    classes: {
      'whop-Email': { borderRadius: '8px', fontWeight: '600' },
      'whop-EmailChecking': { borderRadius: '8px', fontWeight: '600' },
      'whop-EmailCodeHint': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 19 classes use this shape
payments.update({
  appearance: { classes: { 'whop-Email': { fontWeight: '700' } } }
});
```

Avec React, transmettez `appearance` à `<Payments>`. Définissez-la globalement avec `WhopElements({ appearance })`.

## Paramètres

**email** `Binding\<String\>?`

Relit la valeur. Le contrôleur la collecte dans tous les cas.

**showsLabel** `Bool`

Définissez false si vous fournissez votre propre libellé ; le champ conserve son libellé d'accessibilité. Par défaut : `true`.

**placeholder** `String?`

Vide, il affiche `you@example.com`.

## États

S'affiche immédiatement. Une adresse non plausible affiche son erreur dès que le champ perd le focus, puis en direct.

## Bon à savoir

* Sans lui, transmettez vous-même `billingDetails.email` à `createConfirmationToken`. La génération refuse un jeton sans e-mail.
* Un `billingDetails.email` explicite au moment de la génération prévaut sur ce que cet élément a collecté.
* Une adresse plausible est vérifiée auprès de l'annuaire des comptes, avec un debounce puis à nouveau à la perte du focus. Une adresse reconnue propose une connexion, et l'élément présente lui-même la feuille de saisie du code à six chiffres.
* Une connexion vérifiée débloque les moyens de paiement enregistrés de l'acheteur dans [`WhopPaymentElement`](https://docs.whop.com/fr/elements/latest/payments/payment#swift). Lisez `payments.buyer` pour savoir de qui il s'agit, et utilisez `payments.signOut()` pour l'oublier.
* Le jeton à portée limitée dure une heure et ne se renouvelle pas. Lorsqu'il expire, la liste des moyens enregistrés revient vide et l'acheteur paie avec un nouveau moyen, le même parcours qu'un invité.

## Installation

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/whopio/elements-swift.git", from: "0.1.0")
]
```

> [!NOTE]
>
> Montez-le à l'intérieur d'un scope `WhopPayments(accountID:charge:)`, qui crée le contrôleur et le transmet à son contenu. `payments.buyer` est l'acheteur connecté dès qu'une connexion par e-mail en a authentifié un. `WhopBrandingElement` doit aussi être à l'écran, car Whop est le marchand officiel (merchant of record) de ces ventes et `createConfirmationToken` refuse sans lui. Stylisez avec `.whopElementsAppearance(_:)`. Le module est `Elements`, et non `WhopElements` du SDK wallet. Consultez [Premiers pas](https://docs.whop.com/fr/elements/latest/getting-started.md) et [Apparence](https://docs.whop.com/fr/elements/latest/appearance.md).

## Props

**defaultValue** `string`

Valeur initiale appliquée une fois au montage.

**label** `boolean`

Affiche le libellé localisé. Par défaut : `true`.

**placeholder** `string`

Vide, il affiche `you@example.com`.

**onChange** `(payload: EmailChangePayload) =\> void`

Se déclenche à chaque modification.

**style** `StyleProp\<ViewStyle\>`

Appliqué à la `View` externe de l'élément. Pour la personnalisation du thème, préférez `appearance.parts` sur le provider, qui couvre tous les éléments de cette interface. Notez que les noms de parties React Native forment aujourd'hui leur propre ensemble, distinct des noms de classes `whop-*` du web : un objet appearance web ne peut donc pas être repris tel quel.

**fallback** `ReactNode`

Affiché à la place du squelette intégré pendant le chargement de l'élément.

**onReady** `() =\> void`

Se déclenche une fois que l'élément est interactif. `<Payments>` les regroupe, donc c'est généralement son propre `onLoadingChange` qu'il vous faut.

**onError** `(error: \{ message: string; code?: string \}) =\> void`

Un échec de chargement ou de configuration pour cet élément. L'élément affiche sa propre vue d'erreur dans tous les cas.

## `EmailChangePayload`

Ce que renvoie `onChange` :

* `email: string` : la valeur actuelle
* `complete: boolean` : l'adresse est analysable

## États

S'affiche immédiatement. `onChange` signale `complete` dès que l'adresse est analysable, et l'élément affiche son propre message de validation à la perte du focus.

## Bon à savoir

* L'e-mail publié est celui que le jeton de confirmation porte comme `billing_details.email`. Transmettre `billingDetails.email` à `createConfirmationToken` le remplace.
* Définissez `label={false}` lorsque votre formulaire fournit son propre libellé. Le champ conserve son libellé d'accessibilité dans tous les cas.

> [!NOTE]
>
> Enveloppez votre application dans `<WhopElements getToken={…}>` une seule fois, puis montez `<Payments>` autour des éléments. Consultez [Premiers pas](https://docs.whop.com/fr/elements/latest/getting-started.md) et [Apparence](https://docs.whop.com/fr/elements/latest/appearance.md).


## Related topics

- [Premiers pas avec Elements](https://docs.whop.com/fr/elements/latest/getting-started.md)
- [BrandingElement](https://docs.whop.com/fr/elements/latest/payments/branding.md)
- [Créer un checkout avec les Payment Elements](https://docs.whop.com/fr/developer/guides/payment-elements.md)
