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

# Wallet

> Gestiona las superficies de dinero de una cuenta. `actions` renderiza los controles Deposit, Accept, Send y Convert: Deposit, Send y Convert abren sus overlays de Wallet, mientras que Accept abre el creador de enlaces de checkout de Whop para una cuenta de empresa o la creación de una empresa para una cuenta personal. `deposit` devuelve las vías de financiación activas; `convert` intercambia USD por oro, Bitcoin o un token de acciones y expone monedas FX cuando el host habilita `fxEnabled`; `send` mueve dinero a un destinatario o crea un enlace de reclamación público; `withdraw` lista los métodos de pago y crea el pago cuando el host no gestiona ya esa API; `balances` tiene dos vistas: la lista de activos y el bloque de saldo que representa el valor a lo largo de una ventana; `cards` es la lista compacta de tarjetas emitidas; `cardsTable` renderiza el listado completo y ordenable de tarjetas; `cardsChart` representa el gasto con tarjeta; `whopCard` renderiza una tarjeta revelable; `activity` lista los movimientos del libro contable; `activityDetail` renderiza un movimiento obtenido previamente, o recupera uno por ID de actividad o ID de transacción con tarjeta, en un panel lateral independiente. La barra de acciones pendientes y el recordatorio de identidad están en el controlador `dashboard`. Cualquier superficie basada en datos puede usar la sesión del visitante cuando no se proporciona ningún token.

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

*Desde `v1.0.0`.*

## Playground

Combina los elementos con datos de ejemplo. Usa los controles, añade y organiza elementos, y observa cómo se disparan los eventos en vivo:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        {/* mount elements here */}
      </Wallet>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const wallet = window.WhopElements().wallet.create({ /* options */ });
</script>
```

## Opciones

Pásalas a `whop.wallet.create({ … })`, o como props de `<Wallet>` en React.

**currency** `string`

Código de moneda ISO 4217 de tres letras para los campos de importe. Un código desconocido recurre a `usd`. Por defecto es `"usd"`.

**accessToken** `string`

Token opcional con alcance limitado que se proyecta en los elementos hijos de la wallet basados en datos. Sin él, las lecturas usan la sesión del visitante.

**openHoldingOnSelect** `boolean`

Muestra la página de saldo de un activo en lugar del gráfico y la lista de saldos cuando se hace clic en una fila. Desactivado por defecto para que un host que enruta con `balanceSelected` no quede tapado por una segunda pantalla. Por defecto es `false`.

**accountId** `string` *required*

ID de cuenta o de usuario cuyo dinero leen estas superficies. Los ID de cuenta llevan el prefijo `biz_`; los ID de usuario llevan el prefijo `user_` y solo pueden leer el saldo propio del visitante.

**appearance** `Appearance`

Personalización visual para los elementos de este grupo. Anula el `WhopElements({ appearance })` global. Cámbiala en vivo con `update({ appearance })`.

**locale** `WhopElementsLocale`

Configuración regional para el texto de la interfaz de los elementos de este grupo. Establécela en una de las configuraciones regionales incluidas en la app para anular la configuración global. Cualquier otro valor recurre a la configuración regional predeterminada.

## Eventos

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

### `onIdentityVerificationRequested`

Un depósito requiere verificación de identidad. Gestiona este callback para abrir tu flujo de ajustes o de verificación; Wallet no navega.

**payload** `object`

**propiedades**

**accountId** `string` *required*

### `onLoadingChange`

Se ejecuta cuando cambia el estado de carga agrupado. El valor es `true` mientras algún elemento montado siga cargando.

**loading** `boolean`

## Métodos

Llámalos en el handle de Wallet obtenido de `whop.wallet.create({ … })` o `useWallet()`.

### `update`

Combina nuevas opciones del handle en todos los elementos montados. En React, cambia las props del namespace en su lugar.

**Parámetros**

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

### `destroy`

Destruye todos los elementos y subcontroladores que creó este handle, elimina el frame del controlador y libera sus suscripciones. Puedes llamarlo más de una vez, pero un handle destruido rechaza cualquier otra llamada: crea un nuevo handle para empezar de nuevo. React elimina el grupo automáticamente cuando el provider se desmonta.

## Elementos

Los elementos que monta este grupo. Cada uno tiene su propia página:

> [card] [ActionsElement](https://docs.whop.com/es/elements/latest/wallet/actions.md)
>
> La fila de acciones de la cuenta del panel de saldo de Whop. Deposit, Send, Withdraw y Convert abren los overlays integrados del controlador de Wallet. Accept abre el creador de enlaces de checkout de Whop para una cuenta de empresa o la creación de una empresa para una cuenta personal. Cada botón también emite su evento de solicitud para que la página que lo integra pueda observar la acción.

> [card] [Saldos](https://docs.whop.com/es/elements/latest/wallet/balances)
>
> Tres vistas del dinero de una cuenta. La vista de saldo muestra el total, un gráfico de cómo ha cambiado y un selector del intervalo de tiempo. La vista de lista muestra los activos que componen ese total, valorados en dólares. La vista de desglose divide una moneda en importes disponibles, pendientes, en reserva y negativos, sin controles de movimiento de dinero. Cuando `openHoldingOnSelect` está activado, una fila de la lista reemplaza el lienzo de esta unidad (el gráfico y la lista) por la página de saldo de ese activo, en lugar de solo informar del clic. *(subcontrolador, 4 elementos)*

> [card] [Informes](https://docs.whop.com/es/elements/latest/wallet/reports)
>
> El historial del saldo y la actividad financiera que hay detrás, incluidas las exportaciones a CSV. Los extractos de la cuenta están disponibles en el panel de Whop. *(subcontrolador, 2 elementos)*

> [card] [ActivityElement](https://docs.whop.com/es/elements/latest/wallet/activity.md)
>
> La actividad del libro contable de una cuenta: cada movimiento de dinero entrante o saliente, del más reciente al más antiguo. La lista se pagina a medida que el visitante se desplaza, y las filas informan de cuál se pulsó en lugar de navegar, para que puedas abrir tu propia pantalla de detalle.

> [card] [ActivityDetailElement](https://docs.whop.com/es/elements/latest/wallet/activityDetail.md)
>
> Un panel lateral de detalle independiente para un movimiento. Apúntalo a una fila de actividad financiera obtenida previamente, a un ID de actividad del libro contable o a un ID de transacción con tarjeta: una fila obtenida previamente tiene prioridad; en caso contrario, el elemento recupera el registro por sí mismo. Una transacción con tarjeta abre el recibo de la tarjeta: comercio, importe, estado, la tarjeta a la que se cargó, su titular en una cuenta de empresa, la fecha de liquidación, la categoría, la conversión de moneda y el cashback.

> [card] [DepositElement](https://docs.whop.com/es/elements/latest/wallet/deposit.md)
>
> Añade fondos a una cuenta de Whop. Renderiza un campo de importe y las vías de financiación activas de la cuenta: cripto (una dirección de depósito por red con su QR) y transferencia bancaria (los datos de transferencia para cada moneda de liquidación). Las vías de una cuenta de empresa se resuelven sin credenciales, así que funcionan en cualquier página; una cuenta personal (`user_`) solo se revela sus vías a sí misma, así que pasa `accessToken` para ella; si se omite, la propia sesión del visitante en el mismo origen la cubre. Las tarjetas y el saldo de la plataforma son opcionales: pasa `savedCards`, `allowNewCard` o `showPlatformBalance` y el elemento recoge el importe y la elección, después emite `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` y espera a que llames a `showStep({ step: 'amount' })` cuando tu propia pantalla haya terminado.

> [card] [ConvertElement](https://docs.whop.com/es/elements/latest/wallet/convert.md)
>
> Convierte el saldo en USD de una cuenta a oro, Coinbase Wrapped Bitcoin o un token de acciones, y viceversa, a través de la API pública de swaps de Whop. Un montaje entre orígenes necesita un `accessToken` con los scopes `company:balance:read` más `crypto_wallet:swap` o `crypto_wallet:manage`.

> [card] [WithdrawElement](https://docs.whop.com/es/elements/latest/wallet/withdraw.md)
>
> Recoge un importe de pago y un método de pago guardado, agrupa las opciones de entrega estándar e instantánea con comisiones en vivo y estimaciones de llegada, y recoge un nuevo método de pago cuando es necesario. Cuando el host no gestiona el flujo, el elemento lista los métodos y crea el pago por sí mismo: pasa `accessToken` (o confía en la sesión del visitante en el mismo origen). Un host que ya se comunica con la API de pagos puede seguir proporcionando métodos, límites e indicadores de carga; al confirmar, se emite `withdrawalRequested` para que ese host cree el pago.

> [card] [SendElement](https://docs.whop.com/es/elements/latest/wallet/send.md)
>
> Envía dinero desde una cuenta a un destinatario: un usuario, otra cuenta o un enlace de reclamación público que cualquiera puede canjear. Las transferencias directas usan la vía fiat o cripto configurada de la cuenta de origen. Renderiza su propia búsqueda de destinatarios, resuelta a partir del ID de cuenta sin más credenciales que el propio token de la cuenta. Necesita un `accessToken` con el scope `payout:transfer_funds` para las transferencias directas y `payout:withdraw_funds` para las listas de destinatarios; la búsqueda de destinatarios de la cuenta necesita además `company:authorized_user:read` y `member:basic:read`, y los enlaces de reclamación de la cuenta necesitan `airdrop_link:manage`: un host sin alguno de esos scopes debería desactivar la prop correspondiente en lugar de dejar una fila que devolverá un 403.

> [card] [CardDetailsElement](https://docs.whop.com/es/elements/latest/wallet/cardDetails)
>
> Una tarjeta y lo que se ha gastado con ella: la propia tarjeta, lo que ha gastado respecto a su límite y sus últimas transacciones. Se abre como un panel lateral. La cara de la tarjeta, su revelado y su bloqueo provienen del elemento `whopCard` integrado en su interior, así que un host obtiene una sola superficie en lugar de tener que montar tres. Pulsar una transacción, o pedir la lista completa, informa de la solicitud: el panel nunca navega.

> [card] [Tarjetas](https://docs.whop.com/es/elements/latest/wallet/cards)
>
> Las superficies de tarjetas de una cuenta, montadas desde un solo lugar: la lista compacta de tarjetas emitidas, el listado completo ordenable, el gráfico de gasto y una sola tarjeta revelable. Monta las vistas que necesite la página: comparten la cuenta y la credencial con la que se crea esta unidad, así que una página que muestra un gráfico encima de un listado los conecta una sola vez. *(subcontrolador, 5 elementos)*


## Related topics

- [Habilitar pagos salientes de subcuentas](https://docs.whop.com/es/developer/platforms/render-payout-portal.md)
- [ActivityElement](https://docs.whop.com/es/elements/latest/wallet/activity.md)
- [ListElement](https://docs.whop.com/es/elements/latest/wallet/balances-list.md)
