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

> Verzamelt het e-mailadres van de koper en geeft het door aan `payments.createConfirmationToken()` zolang het is gemount. Een expliciet `billingDetails.email` heeft voorrang. Bij een overeenkomend Whop-account verschijnt een optionele inlog met codeverificatie, of met de passkey van het account als dat er een heeft. Een geslaagde inlog ontgrendelt opgeslagen betaalmethoden in het betaalelement. Kopers kunnen doorgaan als gast.

> [!NOTE]
>
> Deze pagina documenteert `@whop/elements@1.10.0` en `@whop/elements-react@1.10.0`.

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Payments`](https://docs.whop.com/nl/elements/latest/payments/overview). Geef props en callbacks mee via de create-opties of als React-props.

Wordt gemount binnen een `WhopPayments`-scope. Verzamelt het e-mailadres van de koper, dat elk bevestigingstoken vereist, en de controller leest het voor het aanmaken van het token, of je het nu bindt of niet.

Mount binnen `<Payments>`, dat de afschrijving en het bevestigingstoken beheert. `<Payments>` zelf wordt gemount binnen `<WhopElements>`. Het verzamelt het e-mailadres van de koper en publiceert het naar de provider, zodat `createConfirmationToken` het meestuurt zonder dat je iets hoeft mee te geven.

```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()
            }
        }
    }
}
```

Voorbeeldgegevens. [Open de Playground](https://docs.whop.com/nl/elements/latest/payments/overview#playground).

[EmailElement draaiend op Android, in de React Native-voorbeeldapp](https://app.revyl.ai/embed/00ebe239-4c8b-4fe4-90d9-0e57771e2f35?controls=0)

## Props

**label** `boolean`

Toont het gelokaliseerde label. Stel in op `false` als je een eigen label gebruikt. De invoer behoudt een gelokaliseerd `aria-label`. Standaard `true`.

**placeholder** `string`

Placeholdertekst voor de e-mailinvoer. Leeg (standaard) geeft `you@example.com` weer. Met zwevende labels is de labeltekst in plaats daarvan de placeholder. Standaard `""`.

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

`above` (standaard) toont het label boven de invoer. `floating` gebruikt de labeltekst als placeholder en toont daarna een klein label boven de getypte tekst zodra de invoer een waarde heeft. Wordt genegeerd wanneer `label` `false` is. Standaard `"above"`. Sinds `v1.5.0`.

**defaultValue** `string`

Beginwaarde die eenmaal bij het mounten wordt toegepast. Standaard `""`.

## Events

Geef callbacks mee in de create-opties of als React-props.

### `onChange`

Wordt geactiveerd wanneer het e-mailadres verandert. `complete` is true wanneer het aannemelijk is. Een inlog activeert het met het ingelogde e-mailadres, dat ook naar `createConfirmationToken()` gaat.

**payload** `object`

**eigenschappen**

**email** `string` *required*

**complete** `boolean` *required*

### `onLoaderStart`

Wordt uitgevoerd nadat het laadskelet voor het eerst is weergegeven en vóór `onReady`.

### `onReady`

Wordt uitgevoerd na de eerste volledige weergave van het element.

### `onError`

Wordt uitgevoerd wanneer het element niet kan laden of crasht. De fallback blijft zichtbaar. Gebruik `code` voor programmatische afhandeling. `sourceKey` identificeert een mislukte host-state-bron.

**e** `object`

**eigenschappen**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Methoden

Roep deze aan op de handle die `create` retourneert, of via een React-`ref`.

### `mount`

Mount het element in `target` en begint met laden. React-componenten mounten zichzelf.

**Parameters**

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

### `destroy`

Verwijdert het element en geeft het frame en de abonnementen vrij. Je kunt het meerdere keren aanroepen. React verwijdert het element automatisch.

### `update`

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de componentprops.

**Parameters**

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

## Styling

Style deze onderdelen via `appearance.classes`. Gebruik camelCase of kebab-case voor eigenschapsnamen en vermeld eenheden. Stylesheets van de pagina kunnen het frame van het element niet bereiken. Het framework valideert elke declaratie voordat die wordt geïnjecteerd.

| Klasse | Doel |
| - | - |
| `.whop-Email` | Root van het e-mailelement |
| `.whop-EmailChecking` | De bewegende omlijning terwijl het e-mailadres wordt gecontroleerd of een inlogcode wordt verstuurd |
| `.whop-EmailCodeHint` | De regel die om de inlogcode vraagt |
| `.whop-EmailError` | Melding voor een ongeldig e-mailadres |
| `.whop-EmailInput` | De e-mailinvoer |
| `.whop-EmailInputInvalid` | E-mailinvoer met een onaannemelijke waarde |
| `.whop-EmailLabel` | Label van het e-mailveld |
| `.whop-EmailPasskey` | De inlogknop voor de passkey in de e-mailinvoer |
| `.whop-EmailSignedIn` | Rij van de ingelogde koper |
| `.whop-EmailSignIn` | Inlogbediening voor terugkerende kopers |
| `.whop-EmailSignInError` | Foutmelding bij het inloggen |
| `.whop-EmailSignOut` | Bediening om een ander e-mailadres te kiezen |
| `.whop-EmailWelcome` | De welkomstweergave met een begroeting boven het e-mailadres van het account |
| `.whop-VerificationError` | De foutmelding in het dialoogvenster |
| `.whop-VerificationInput` | De invoer voor de eenmalige code |
| `.whop-VerificationInputInvalid` | Toegevoegd aan de code-invoer na een mislukte poging |
| `.whop-VerificationInputSlot` | Eén cijfervak van de invoer voor de eenmalige code |
| `.whop-VerificationInputSlotActive` | Toegevoegd aan het codevak waarin de koper typt |
| `.whop-VerificationPending` | De regel "verifying…" terwijl een verzending bezig is |

```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' } } }
});
```

Geef in React `appearance` mee aan `<Payments>`. Stel het globaal in met `WhopElements({ appearance })`.

## Parameters

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

Leest de waarde terug. De controller verzamelt die in beide gevallen.

**showsLabel** `Bool`

Stel in op false als je een eigen label gebruikt; de invoer behoudt zijn toegankelijkheidslabel. Standaard `true`.

**placeholder** `String?`

Leeg geeft `you@example.com` weer.

## Statussen

Wordt direct weergegeven. Een onaannemelijk adres toont de fout zodra het veld de focus verliest, daarna live.

## Goed om te weten

* Zonder dit element geef je zelf `billingDetails.email` mee aan `createConfirmationToken`. Het aanmaken weigert een token zonder e-mailadres.
* Een expliciet `billingDetails.email` op het moment van aanmaken heeft voorrang op wat dit element heeft verzameld.
* Een aannemelijk adres wordt opgezocht in de accountdirectory, met debounce en opnieuw bij blur. Een herkend adres biedt een inlog aan, en het element toont zelf het sheet voor de zescijferige code.
* Een geverifieerde inlog ontgrendelt de opgeslagen betaalmethoden van de koper in [`WhopPaymentElement`](https://docs.whop.com/nl/elements/latest/payments/payment#swift). Lees `payments.buyer` om te zien wie het is, en gebruik `payments.signOut()` om de koper te vergeten.
* Het afgebakende token is een uur geldig en wordt niet vernieuwd. Wanneer het verloopt, komt de route voor opgeslagen methoden leeg terug en betaalt de koper met een nieuwe methode, hetzelfde pad als een gast.

## Installatie

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

> [!NOTE]
>
> Mount het binnen een `WhopPayments(accountID:charge:)`-scope, die de controller aanmaakt en aan de inhoud doorgeeft. `payments.buyer` is de ingelogde koper zodra een inlog via e-mail er een heeft bevestigd. `WhopBrandingElement` moet ook op het scherm staan, omdat Whop merchant of record is bij deze verkopen en `createConfirmationToken` zonder dit element weigert. Style met `.whopElementsAppearance(_:)`. De module is `Elements`, niet `WhopElements` van de wallet-SDK. Zie [Aan de slag](https://docs.whop.com/nl/elements/latest/getting-started.md) en [Appearance](https://docs.whop.com/nl/elements/latest/appearance.md).

## Props

**defaultValue** `string`

Beginwaarde die eenmaal bij het mounten wordt toegepast.

**label** `boolean`

Toont het gelokaliseerde label. Standaard `true`.

**placeholder** `string`

Leeg geeft `you@example.com` weer.

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

Wordt bij elke wijziging geactiveerd.

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

Toegepast op de buitenste `View` van het element. Gebruik voor thema's bij voorkeur `appearance.parts` op de provider, dat elk element op dit oppervlak dekt. Let op: de namen van React Native-onderdelen vormen momenteel een eigen set, niet de `whop-*`-klassenamen van het web, dus een appearance-object voor het web is niet ongewijzigd over te zetten.

**fallback** `ReactNode`

Wordt weergegeven in plaats van het ingebouwde skelet terwijl het element laadt.

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

Wordt eenmaal geactiveerd zodra het element interactief is. `<Payments>` groepeert deze, dus de eigen `onLoadingChange` daarvan is meestal wat je nodig hebt.

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

Een laad- of configuratiefout voor dit element. Het element geeft in beide gevallen zijn eigen foutscherm weer.

## `EmailChangePayload`

Wat `onChange` teruggeeft:

* `email: string`: de huidige waarde
* `complete: boolean`: het adres kan worden geparset

## Statussen

Wordt direct weergegeven. `onChange` meldt `complete` zodra het adres kan worden geparset, en het element toont zijn eigen validatiemelding bij blur.

## Goed om te weten

* Het gepubliceerde e-mailadres is wat het bevestigingstoken meestuurt als `billing_details.email`. Als je `billingDetails.email` meegeeft aan `createConfirmationToken`, wordt dit overschreven.
* Stel `label={false}` in wanneer je formulier een eigen label levert. De invoer behoudt in beide gevallen zijn toegankelijkheidslabel.

> [!NOTE]
>
> Wikkel je app eenmaal in `<WhopElements getToken={…}>` en mount daarna `<Payments>` rond de elementen. Zie [Aan de slag](https://docs.whop.com/nl/elements/latest/getting-started.md) en [Appearance](https://docs.whop.com/nl/elements/latest/appearance.md).


## Related topics

- [Aan de slag met Elements](https://docs.whop.com/nl/elements/latest/getting-started.md)
- [BrandingElement](https://docs.whop.com/nl/elements/latest/payments/branding.md)
- [Bouw een checkout met payment elements](https://docs.whop.com/nl/developer/guides/payment-elements.md)
