Skip to main content
Esta página documenta @whop/elements@1.10.0 y @whop/elements-react@1.10.0.
Desde v1.0.0. Se monta dentro de Wallet. 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().
Puedes montar este elemento en línea (create) o abrirlo como un overlay modal (createOverlay).

Datos de ejemplo. Abre el Playground.

Props

string
Un token con alcance limitado para la lectura/escritura privilegiada; necesita payout:transfer_funds para las transferencias directas, payout:withdraw_funds para las listas de destinatarios y airdrop_link:manage para los enlaces de reclamación. Si se omite, la lectura lleva la propia sesión del visitante, que solo responde en el mismo origen.
string
Anula el encabezado del selector de destinatarios. Si se omite, el encabezado es “Choose recipient”.
boolean
Habilita la búsqueda de destinatarios. Sugiere personas y empresas cuando hay menos de seis destinatarios guardados, y busca desde Add recipient después de escribir. Por defecto es true.
Muestra la acción de enlace de reclamación en el selector de destinatarios. Desactívala para un host sin airdrop_link:manage. Por defecto es true.
SendRecipient | null
Omite el selector y abre directamente la pantalla de importe de este destinatario, para una fila de acción del tipo “pagar a esta persona”. En ese caso no se muestra ningún botón de atrás, ya que no hay ningún selector detrás. Por defecto es null.
string
Preselecciona una moneda en el selector de la pantalla de importe. Recurre a currency y después a USD. Por defecto es "".

Eventos

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

onStepChanged

La pantalla visible cambió.
object

onSendCompleted

Una transferencia se completó correctamente. Actualiza todo lo que, por tu parte, lea el saldo o la actividad de la cuenta.
object

onLinkCreated

Se creó un enlace de reclamación. Actualiza todo lo que, por tu parte, lea el saldo de la cuenta.
object

onDone

El visitante hizo clic en “Done” en una pantalla de éxito: cierra la superficie que lo contiene.

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ó.
object

Métodos

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

refresh

Vuelve a obtener los saldos y la lista de destinatarios de la cuenta. Llámalo después de que algo por tu parte cambie lo que puede ofrecer. Devuelve Promise<void>

mount

Monta el elemento en target y comienza a cargarlo. Los componentes de React se montan solos. Parámetros
string | HTMLElement
requerido

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
Partial<SendElementProps>
requerido

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.
En React, pasa appearance a <Wallet>. Establécelo globalmente con WhopElements({ appearance }).