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

> Recopila el correo electrónico del comprador y lo pasa a `payments.createConfirmationToken()` mientras está montado. Un `billingDetails.email` explícito tiene prioridad. Si coincide con una cuenta de Whop, muestra un inicio de sesión opcional con verificación por código, o con la passkey de la cuenta si tiene una. Un inicio de sesión correcto desbloquea los métodos de pago guardados en el elemento de pago. Los compradores pueden continuar como invitados.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

*Desde `v1.0.0`.*

Se monta dentro de [`Payments`](https://docs.whop.com/es/elements/latest/payments/overview). Pasa props y callbacks mediante las opciones de creación o las props de React.

Se monta dentro de un ámbito `WhopPayments`. Recopila el correo electrónico del comprador, que todo token de confirmación requiere, y el controlador lo lee para emitir el token tanto si lo vinculas como si no.

Móntalo dentro de `<Payments>`, que gestiona el cobro y el token de confirmación. `<Payments>` se monta a su vez dentro de `<WhopElements>`. Recopila el correo electrónico del comprador y lo publica en el provider, por lo que `createConfirmationToken` lo envía sin que tengas que pasarle nada.

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

Datos de ejemplo. [Abre el Playground](https://docs.whop.com/es/elements/latest/payments/overview#playground).

[EmailElement ejecutándose en Android, en la app de ejemplo de React Native](https://app.revyl.ai/embed/00ebe239-4c8b-4fe4-90d9-0e57771e2f35?controls=0)

## Props

**label** `boolean`

Muestra la etiqueta localizada. Establécelo en `false` cuando proporciones la tuya. El campo conserva un `aria-label` localizado. El valor predeterminado es `true`.

**placeholder** `string`

Texto de marcador de posición del campo de correo electrónico. Vacío (predeterminado) muestra `you@example.com`. Con etiquetas flotantes, el texto de la etiqueta actúa como marcador de posición. El valor predeterminado es `""`.

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

`above` (predeterminado) muestra la etiqueta encima del campo. `floating` usa el texto de la etiqueta como marcador de posición y luego muestra una pequeña etiqueta encima del texto escrito una vez que el campo tiene un valor. Se ignora cuando `label` es `false`. El valor predeterminado es `"above"`. Desde `v1.5.0`.

**defaultValue** `string`

Valor inicial que se aplica una vez al montar. El valor predeterminado es `""`.

## Eventos

Pasa los callbacks en las opciones de creación o como props de React.

### `onChange`

Se dispara cuando cambia el correo electrónico. `complete` es true cuando es plausible. El inicio de sesión lo dispara con el correo electrónico de la sesión iniciada, que también alimenta `createConfirmationToken()`.

**payload** `object`

**propiedades**

**email** `string` *required*

**complete** `boolean` *required*

### `onLoaderStart`

Se ejecuta después de que el esqueleto de carga se pinta por primera vez y antes de `onReady`.

### `onReady`

Se ejecuta después del primer pintado completo del elemento.

### `onError`

Se ejecuta cuando el elemento no se carga o falla. El contenido de respaldo permanece visible. Usa `code` para el manejo programático. `sourceKey` identifica una fuente de estado del host que falló.

**e** `object`

**propiedades**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Métodos

Llámalos en el handle que devuelve `create`, o a través de una `ref` de React.

### `mount`

Monta el elemento en `target` y comienza a cargarlo. Los componentes de React se montan solos.

**Parámetros**

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

### `destroy`

Elimina el elemento y libera su frame y sus suscripciones. Puedes llamarlo más de una vez. React elimina el elemento automáticamente.

### `update`

Combina nuevas props en el elemento montado. En React, cambia las props del componente en su lugar.

**Parámetros**

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

## Estilos

Aplica estilo a estas partes mediante `appearance.classes`. Usa camel case o kebab case para los nombres de las propiedades e incluye las unidades. Las hojas de estilo de la página no pueden llegar al frame del elemento. El framework valida cada declaración antes de inyectarla.

| Clase | Aplica a |
| - | - |
| `.whop-Email` | Raíz del elemento de correo electrónico |
| `.whop-EmailChecking` | El contorno animado mientras se comprueba el correo electrónico o se envía un código de inicio de sesión |
| `.whop-EmailCodeHint` | La línea que solicita el código de inicio de sesión |
| `.whop-EmailError` | Mensaje de correo electrónico no válido |
| `.whop-EmailInput` | El campo de correo electrónico |
| `.whop-EmailInputInvalid` | Campo de correo electrónico con un valor no plausible |
| `.whop-EmailLabel` | Etiqueta del campo de correo electrónico |
| `.whop-EmailPasskey` | El botón de inicio de sesión con passkey dentro del campo de correo electrónico |
| `.whop-EmailSignedIn` | Fila del comprador con sesión iniciada |
| `.whop-EmailSignIn` | Control de inicio de sesión de bienvenida de nuevo |
| `.whop-EmailSignInError` | Mensaje de error de inicio de sesión |
| `.whop-EmailSignOut` | Control para elegir un correo electrónico diferente |
| `.whop-EmailWelcome` | El saludo de la vista de bienvenida sobre el correo electrónico de la cuenta |
| `.whop-VerificationError` | El mensaje de error en el diálogo |
| `.whop-VerificationInput` | El campo del código de un solo uso |
| `.whop-VerificationInputInvalid` | Se añade al campo del código después de un intento fallido |
| `.whop-VerificationInputSlot` | Una casilla de dígito del campo del código de un solo uso |
| `.whop-VerificationInputSlotActive` | Se añade a la casilla del código en la que escribe el comprador |
| `.whop-VerificationPending` | La línea "verifying…" mientras hay un envío en curso |

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

En React, pasa `appearance` a `<Payments>`. Establécelo globalmente con `WhopElements({ appearance })`.

## Parámetros

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

Devuelve el valor. El controlador lo recopila en cualquier caso.

**showsLabel** `Bool`

Establécelo en false cuando proporciones tu propia etiqueta; el campo conserva su etiqueta de accesibilidad. El valor predeterminado es `true`.

**placeholder** `String?`

Vacío muestra `you@example.com`.

## Estados

Se renderiza inmediatamente. Una dirección no plausible muestra su error cuando el campo pierde el foco y, a partir de ahí, en vivo.

## Información útil

* Sin él, pasa tú mismo `billingDetails.email` a `createConfirmationToken`. La emisión rechaza un token sin correo electrónico.
* Un `billingDetails.email` explícito en el momento de la emisión prevalece sobre lo que recopiló este elemento.
* Una dirección plausible se comprueba contra el directorio de cuentas, con debounce y de nuevo al perder el foco. Si se reconoce, se ofrece un inicio de sesión y el propio elemento presenta la hoja del código de seis dígitos.
* Un inicio de sesión verificado desbloquea los métodos de pago guardados del comprador en [`WhopPaymentElement`](https://docs.whop.com/es/elements/latest/payments/payment#swift). Lee `payments.buyer` para saber quién es, y usa `payments.signOut()` para olvidarlo.
* El token con alcance limitado dura una hora y no se renueva. Cuando caduca, la sección de métodos guardados vuelve vacía y el comprador paga con un método nuevo, el mismo camino que sigue un invitado.

## Instalación

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

> [!NOTE]
>
> Móntalo dentro de un ámbito `WhopPayments(accountID:charge:)`, que crea el controlador y se lo pasa a su contenido. `payments.buyer` es el comprador con sesión iniciada una vez que un inicio de sesión por correo electrónico lo ha verificado. `WhopBrandingElement` también tiene que estar en pantalla, porque Whop es el comerciante registrado en estas ventas y `createConfirmationToken` se rechaza sin él. Aplica estilo con `.whopElementsAppearance(_:)`. El módulo es `Elements`, no `WhopElements` del SDK de wallet. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md) y [Appearance](https://docs.whop.com/es/elements/latest/appearance.md).

## Props

**defaultValue** `string`

Valor inicial que se aplica una vez al montar.

**label** `boolean`

Muestra la etiqueta localizada. El valor predeterminado es `true`.

**placeholder** `string`

Vacío muestra `you@example.com`.

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

Se dispara en cada edición.

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

Se aplica al `View` exterior del elemento. Para la personalización del tema, es preferible `appearance.parts` en el provider, que cubre todos los elementos de esta superficie. Ten en cuenta que, por ahora, los nombres de las partes de React Native son un conjunto propio, no los nombres de clase `whop-*` de la web, por lo que un objeto de appearance de la web no se puede trasladar sin cambios.

**fallback** `ReactNode`

Se renderiza en lugar del esqueleto integrado mientras el elemento se carga.

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

Se dispara una vez que el elemento es interactivo. `<Payments>` los agrupa, así que normalmente lo que quieres es su propio `onLoadingChange`.

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

Un fallo de carga o de configuración de este elemento. En cualquier caso, el elemento renderiza su propia vista de error.

## `EmailChangePayload`

Lo que devuelve `onChange`:

* `email: string`: el valor actual
* `complete: boolean`: la dirección se puede analizar

## Estados

Se renderiza inmediatamente. `onChange` informa de `complete` una vez que la dirección se puede analizar, y el elemento muestra su propio mensaje de validación al perder el foco.

## Información útil

* El correo electrónico publicado es el que el token de confirmación lleva como `billing_details.email`. Pasar `billingDetails.email` a `createConfirmationToken` lo sobrescribe.
* Establece `label={false}` cuando tu formulario proporcione su propia etiqueta. El campo conserva su etiqueta de accesibilidad en cualquier caso.

> [!NOTE]
>
> Envuelve tu app en `<WhopElements getToken={…}>` una vez y luego monta `<Payments>` alrededor de los elementos. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md) y [Appearance](https://docs.whop.com/es/elements/latest/appearance.md).
