Skip to main content
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:

Opciones

Pásalas a whop.wallet.create({ … }), o como props de <Wallet> en React.
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".
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.
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.
string
requerido
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
Personalización visual para los elementos de este grupo. Anula el WhopElements({ appearance }) global. Cámbiala en vivo con update({ appearance }).
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.
object

onLoadingChange

Se ejecuta cuando cambia el estado de carga agrupado. El valor es true mientras algún elemento montado siga cargando.
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
Partial<WalletOptions>
requerido

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:

ActionsElement

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.

Saldos

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)

Informes

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)

ActivityElement

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.

ActivityDetailElement

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.

DepositElement

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.

ConvertElement

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.

WithdrawElement

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.

SendElement

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.

CardDetailsElement

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.

Tarjetas

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)