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

# BrandingElement

> El aviso de comerciante registrado (merchant of record) de Whop: la aceptación por parte del comprador de los Términos de servicio para compradores y la Política de privacidad de Whop, con el logotipo textual de Whop. Obligatorio: los elementos de pago, de tarjeta y de campos de tarjeta permanecen en su estado de carga hasta que se monta, y los pagos no pueden confirmarse sin él.

> [!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 las props y los callbacks a través de las opciones de creación o de las props de React.

> [!NOTE]
>
> **Obligatorio.** Los demás elementos de un handle de Payments, excepto `AddressElement`, `EmailElement` y `TaxIdElement`, permanecen en su estado de carga hasta que se monta `BrandingElement`: móntalo junto a ellos.

Se monta dentro de un ámbito `WhopPayments`. La línea de comerciante registrado que toda superficie de pago tiene que incluir, con el logotipo textual de Whop dibujado como un trazado.

Móntalo dentro de `<Payments>`, que es dueño del cobro y del token de confirmación. `<Payments>` se monta a su vez dentro de `<WhopElements>`. Es obligatorio en todo formulario que recopile datos: `createConfirmationToken` se rechaza mientras no haya ninguno montado, y adopta el tema del resto de tu formulario.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <BrandingElement />
      </Payments>
    </WhopElements>
  );
}
```

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

<Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx">
  {/* your form */}
  <BrandingElement />
</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('branding').mount('#payments-branding');
</script>
```

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

// .whopElements(environment:) runs once at the app root. See Getting started.
struct CheckoutScreen: View {

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

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

[BrandingElement ejecutándose en Android, en la app de ejemplo de React Native](https://app.revyl.ai/embed/c280bcb7-3262-4cc8-a0ef-d77bc0c49b55?controls=0)

## Props

*Este elemento no acepta props del consumidor.*

## Eventos

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

### `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\<BrandingElementProps\>` *required*

## Estilos

Este elemento no expone nombres de clase para estilos. Usa `appearance` (tema, color de acento, variables) para cambiar su estilo.

## Estados

Se renderiza inmediatamente. No obtiene nada y no tiene estado de error.

## Información útil

* **`createConfirmationToken` se rechaza mientras está desmontado.** Whop es el comerciante registrado en estas ventas, por lo que hay que informar de ello al comprador en la pantalla donde paga.
* El logotipo textual es un trazado vectorial, no un recurso, por lo que el framework no incluye ningún paquete de imágenes.

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

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

## Estados

Se renderiza inmediatamente. No tiene datos que cargar ni estados propios.

## Información útil

* Obligatorio. `createConfirmationToken` se rechaza con un `BrandingRequiredError` mientras no haya ningún `BrandingElement` montado, exactamente igual que los elementos web retienen su aparición hasta que se adjunta el branding.
* Móntalo una vez en cualquier lugar dentro de `<Payments>`, normalmente debajo de tu botón de envío.
* El logotipo textual sigue por sí solo la apariencia clara u oscura del tema resuelto.

> [!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).


## Related topics

- [CardCvcElement](https://docs.whop.com/es/elements/latest/payments/cardFields-cardCvc.md)
- [CardExpiryElement](https://docs.whop.com/es/elements/latest/payments/cardFields-cardExpiry.md)
- [CardNumberElement](https://docs.whop.com/es/elements/latest/payments/cardFields-cardNumber.md)
