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

# RequiredActionsElement

> Los banners de acciones pendientes del panel de saldo de Whop (verificación de identidad, depósitos, impuestos y el resto) en el mismo orden en que los devuelve la API. Una cuenta sin nada pendiente no renderiza nada en absoluto, por lo que el elemento puede permanecer fijo en un diseño. Los textos provienen de la API. Pulsar Verify inicia una sesión de identidad alojada y se dirige a ella; Add money informa de `depositRequested` y se queda donde está, para que el host monte su propio flujo de depósito (por ejemplo, el elemento `deposit` del controlador `wallet`); todos los demás botones siguen el propio enlace de la acción. Lee con el `accessToken` del handle de Dashboard, que necesita `payout:account:read`, además de `identity:write` para iniciar la verificación. Una lectura fallida no renderiza nada en lugar de un error: un banner nunca debería convertirse en lo más llamativo de la página de otra persona.

> [!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 [`Dashboard`](https://docs.whop.com/es/elements/latest/dashboard/overview). `accountId` y `accessToken` provienen de ahí. Pasa las props y los callbacks a través de las opciones de creación o de las props de React. Conserva el handle creado, o la `ref` de React, para llamar a `refresh()`.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Dashboard /* options */>
        <RequiredActionsElement onActionRequested={(e) => console.log(e)} onIdentityVerificationRequested={(e) => console.log(e)} onDepositRequested={(e) => console.log(e)} />
      </Dashboard>
    </WhopElements>
  );
}
```

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

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

## Props

**kind** `"individual" | "business"`

Qué verificación inicia el botón Verify. `individual` (KYC) es lo que desbloquea los pagos y una tarjeta de Whop. `business` (KYB) cubre eso y además desbloquea financiación y tarjetas de empresa: úsalo para una empresa que vaya a necesitarlos. Por defecto es `"individual"`.

## Eventos

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

### `onActionRequested`

El visitante pulsó un botón de un banner. Se dispara para cada acción, incluidas las que el propio elemento también gestiona.

**payload** `object`

**propiedades**

**action** `string` *required*

**valores**

Uno de `"deposit_funds"`, `"review_held_payments"`, `"submit_information_request"`, `"update_automatic_withdrawal_method"`, `"reauthorize_payout_methods"`, `"update_payout_method"`, `"update_payout_profile"`, `"card_usage_review"`, `"verify_identity"`, `"scale_account_setup"`, `"sign_formation_documents"`, `"configure_tax_remitter"`, `"add_vat_registration"`, `"confirm_tax_details"`, `"accept_payout_terms"`, `"enable_two_factor_authentication"` o `"respond_to_abuse_report"`.

**accountId** `string` *required*

### `onIdentityVerificationRequested`

El visitante pulsó Verify en una acción `verify_identity` que el elemento puede iniciar. El elemento abre la verificación de identidad por sí mismo; este evento se dispara a la vez, para que un host pueda registrar el recorrido.

**payload** `object`

**propiedades**

**accountId** `string` *required*

### `onDepositRequested`

El visitante pulsó Add money. El elemento nunca abre un flujo de depósito por sí mismo: en respuesta a esto, monta el tuyo, como el elemento `deposit` del controlador `wallet`.

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

### `refresh`

Vuelve a leer la cuenta. Llámalo cuando el visitante regrese de verificar o depositar para que los banners reflejen el nuevo estado sin esperar a que caduque la caché.

**Devuelve** `Promise<void>`

### `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\<RequiredActionsElementProps\>` *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-RequiredActions` | Los banners de acciones pendientes |

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

dashboard.update({
  appearance: {
    classes: { 'whop-RequiredActions': { fontWeight: '700' } }
  }
});
```

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