@whop/elements 1.0.0-beta.1 → 1.0.0-beta.3

package/wallet.d.ts

@@ -15,6 +15,15 @@ export interface WalletOptions {
 	 * @default "usd"
 	 */
 	currency?: string;
+	/**
+	 * Optional scoped token projected to data-backed wallet children. Without it, reads use the viewer session.
+	 */
+	accessToken?: string;
+	/**
+	 * Show a holding's balance page in place of the balances chart and list when a row is clicked. Off by default so a host that routes on `balanceSelected` is not covered by a second screen.
+	 * @default false
+	 */
+	openHoldingOnSelect?: boolean;
 	/**
 	 * Account or user ID whose money these surfaces read. Account IDs are prefixed `biz_`; user IDs are prefixed `user_` and can read only the viewer's own balance.
 	 */
@@ -38,38 +47,30 @@ export interface WalletOptions {
 }
 
 /**
- * Consumer props for the "activity" element. Set at create (or as `<ActivityElement />` JSX props), and updatable live via `update()`.
- * @see https://docs.whop.com/elements/latest/wallet/activity
+ * Consumer props for the "required-actions" element. Set at create (or as `<RequiredActionsElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/required-actions
  */
-export interface ActivityElementProps {
-	/**
-	 * Only show activity for this currency. Without it, activity from every currency is shown.
-	 */
-	currency?: string;
+export interface RequiredActionsElementProps {
 	/**
-	 * A scoped token for the read. An account needs `company:balance:read`, and a user needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 * A scoped token for the read and for starting verification — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * When off, card transaction rows render inert (no click, no hover) instead of firing `activitySelected`. Use it when you know the viewer isn't allowed to see those details.
-	 * @default true
+	 * Which verification the Verify button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
 	 */
-	canOpenCardTransactionDetails?: boolean;
+	kind?: "individual" | "business";
 }
 
 /**
- * The live handle for a mounted "activity" element. Returned by `create("activity")`; in React, the component's `ref`.
- * @see https://docs.whop.com/elements/latest/wallet/activity
+ * The live handle for a mounted "required-actions" element. Returned by `create("required-actions")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/required-actions
  */
-export interface ActivityElementHandle {
+export interface RequiredActionsElementHandle {
 	/**
-	 * Re-fetch the account's activity from the first page. Call it after a mutation made elsewhere (a deposit, a send) so the list reflects it without waiting for the cache to expire.
+	 * Re-read the account. Call it when the viewer returns from verifying or depositing so the banners reflect the new state without waiting for the cache to expire.
 	 */
 	refresh: () => Promise<void>;
-	/**
-	 * Set the date filter from outside the element, for example wiring a chart brush selection into the list. Pass `null` to clear it.
-	 */
-	setDateRange: (input: ActivityDateRangeOverride | null) => Promise<void>;
 	/**
 	 * Mounts the element in `target` and starts loading. React components mount themselves.
 	 */
@@ -81,44 +82,40 @@ export interface ActivityElementHandle {
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update: (options: Partial<ActivityElementProps>) => void;
+	update: (options: Partial<RequiredActionsElementProps>) => void;
 }
 
 /**
- * Options for `create("activity")`: the consumer props plus event callbacks and lifecycle hooks.
+ * Options for `create("required-actions")`: the consumer props plus event callbacks and lifecycle hooks.
  * @example
  * ```ts
- * const activity = wallet.create("activity", {}); // this interface: props + on<Event> callbacks
- * activity.mount("#wallet-activity");
+ * const required_actions = wallet.create("required-actions", {}); // this interface: props + on<Event> callbacks
+ * required_actions.mount("#wallet-required-actions");
  * ```
- * @see https://docs.whop.com/elements/latest/wallet/activity
+ * @see https://docs.whop.com/elements/latest/wallet/required-actions
  */
-export interface ActivityElementCreateOptions {
-	/**
-	 * Only show activity for this currency. Without it, activity from every currency is shown.
-	 */
-	currency?: string;
+export interface RequiredActionsElementCreateOptions {
 	/**
-	 * A scoped token for the read. An account needs `company:balance:read`, and a user needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 * A scoped token for the read and for starting verification — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * When off, card transaction rows render inert (no click, no hover) instead of firing `activitySelected`. Use it when you know the viewer isn't allowed to see those details.
-	 * @default true
+	 * Which verification the Verify button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
 	 */
-	canOpenCardTransactionDetails?: boolean;
+	kind?: "individual" | "business";
 	/**
-	 * A row was clicked. Open your own detail view or route for it; the element never navigates.
+	 * The viewer pressed a banner button. Fires for every action, including ones the element also handles itself.
 	 */
-	onActivitySelected?: ((payload: { activity: LedgerActivity; }) => void);
+	onActionRequested?: ((payload: { action: "deposit_funds" | "submit_information_request" | "update_automatic_withdrawal_method" | "reauthorize_payout_methods" | "update_payout_profile" | "card_usage_review" | "verify_identity" | "sign_formation_documents" | "connect_fulfillment_tracker" | "setup_apple_pay_domains" | "configure_tax_remitter" | "add_vat_registration"; accountId: string; }) => void);
 	/**
-	 * The pointer entered a row, or left one (`null`). Point something of your own at the same moment, like marking the row on a balance chart.
+	 * The viewer pressed Verify on a `verify_identity` action the element can start. The element opens identity verification itself — this fires alongside, so a host can record the trip.
 	 */
-	onActivityHovered?: ((payload: { activity: LedgerActivity; } | null) => void);
+	onIdentityVerificationRequested?: ((payload: { accountId: string; }) => void);
 	/**
-	 * The viewer changed the date filter through the filter row rather than through `setDateRange`. Clear any range selection of your own, like a chart brush, that no longer matches.
+	 * The viewer pressed Add money. The Wallet controller opens its deposit overlay.
 	 */
-	onDateRangeChanged?: ((payload: { dateRange: { start: string; end: string; } | null; }) => void);
+	onDepositRequested?: ((payload: Record<string, never>) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -134,80 +131,67 @@ export interface ActivityElementCreateOptions {
 }
 
 /**
- * Consumer props for the "deposit" element. Set at create (or as `<DepositElement />` JSX props), and updatable live via `update()`.
- * @see https://docs.whop.com/elements/latest/wallet/deposit
+ * Consumer props for the "actions" element. Set at create (or as `<ActionsElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/actions
  */
-export interface DepositElementProps {
-	/**
-	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero, or above 9,999,999, is ignored.
-	 * @default ""
-	 */
-	amount?: string;
+export interface ActionsElementProps {
 	/**
-	 * Offer the crypto rail when the account has a deposit address.
+	 * Show the Deposit button.
 	 * @default true
 	 */
-	showCrypto?: boolean;
+	showDeposit?: boolean;
 	/**
-	 * Offer the bank-transfer rail when the account has wire instructions.
+	 * Show the Accept button.
 	 * @default true
 	 */
-	showBank?: boolean;
+	showAccept?: boolean;
 	/**
-	 * Cards you already hold for this payer, rendered as funding rows. Choosing one emits `cardDepositRequested` with the amount — the element never collects a card payment.
-	 * @default []
+	 * Show the Send button.
+	 * @default true
 	 */
-	savedCards?: DepositSavedCard[];
+	showSend?: boolean;
 	/**
-	 * Add an "Add card" row that emits `addCardRequested` so you can open your own card-collection flow.
+	 * Show the Withdraw button. Off by default so an existing row keeps the buttons it already had.
 	 * @default false
 	 */
-	allowNewCard?: boolean;
+	showWithdraw?: boolean;
 	/**
-	 * Offer a "Platform balance" row that emits `platformBalanceSelected` immediately, with no amount step.
-	 * @default false
+	 * Show the Convert button.
+	 * @default true
 	 */
-	showPlatformBalance?: boolean;
+	showConvert?: boolean;
 	/**
-	 * Processing fees to preview under the amount when a card row is selected. `percentageFee` is in percentage POINTS (`2.9` is 2.9%); `fixedFee` and `radarFee` are major units (`0.3` is $0.30).
-	 * @default null
+	 * Disable the Deposit button while keeping it visible.
+	 * @default false
 	 */
-	cardFee?: DepositCardFee | null;
+	depositDisabled?: boolean;
 	/**
-	 * Preselect a rail by id (`bank`, `crypto`, `platform_balance`, or a saved card id). Continue stays disabled while that rail is not yet offered, rather than funding through another one.
-	 * @default ""
+	 * Disable the Accept button while keeping it visible.
+	 * @default false
 	 */
-	preferredMethodId?: string;
+	acceptDisabled?: boolean;
 	/**
-	 * Emit `bankSelected` and stay on the amount screen instead of showing the wire fields — for hosts that run their own step (a verification, an onboarding) first. Because that host owns the rail, the row is then offered even before the account has instructions to show.
+	 * Disable the Send button while keeping it visible.
 	 * @default false
 	 */
-	deferBankToHost?: boolean;
+	sendDisabled?: boolean;
 	/**
-	 * Show an "I have deposited my funds" button on the crypto screen that emits `depositConfirmed`, so you can start watching for the transfer.
+	 * Disable the Withdraw button while keeping it visible.
 	 * @default false
 	 */
-	confirmCryptoDeposit?: boolean;
+	withdrawDisabled?: boolean;
 	/**
-	 * Open straight onto a rail instead of the picker. `crypto` and `bank` need no amount; their back button emits `dismissed` because there is no picker behind them.
-	 * @default "amount"
+	 * Disable the Convert button while keeping it visible.
+	 * @default false
 	 */
-	initialStep?: "amount" | "bank" | "crypto";
+	convertDisabled?: boolean;
 }
 
 /**
- * The live handle for a mounted "deposit" element. Returned by `create("deposit")`; in React, the component's `ref`.
- * @see https://docs.whop.com/elements/latest/wallet/deposit
+ * The live handle for a mounted "actions" element. Returned by `create("actions")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/actions
  */
-export interface DepositElementHandle {
-	/**
-	 * Move the element to a screen. `{ step: "amount" }` is how you hand control back after settling a card or platform-balance deposit on your side.
-	 */
-	showStep: (input: { step: "amount" | "bank" | "crypto"; }) => Promise<void>;
-	/**
-	 * Re-resolve the account's funding rails. Call it after anything on your side changes what the account can offer — finishing bank onboarding, for instance — so the new rail appears without waiting for the cache to expire.
-	 */
-	refresh: () => Promise<void>;
+export interface ActionsElementHandle {
 	/**
 	 * Mounts the element in `target` and starts loading. React components mount themselves.
 	 */
@@ -219,106 +203,89 @@ export interface DepositElementHandle {
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update: (options: Partial<DepositElementProps>) => void;
+	update: (options: Partial<ActionsElementProps>) => void;
 }
 
 /**
- * Options for `create("deposit")`: the consumer props plus event callbacks and lifecycle hooks.
+ * Options for `create("actions")`: the consumer props plus event callbacks and lifecycle hooks.
  * @example
  * ```ts
- * const deposit = wallet.create("deposit", {}); // this interface: props + on<Event> callbacks
- * deposit.mount("#wallet-deposit");
+ * const actions = wallet.create("actions", {}); // this interface: props + on<Event> callbacks
+ * actions.mount("#wallet-actions");
  * ```
- * @see https://docs.whop.com/elements/latest/wallet/deposit
+ * @see https://docs.whop.com/elements/latest/wallet/actions
  */
-export interface DepositElementCreateOptions {
+export interface ActionsElementCreateOptions {
 	/**
-	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero, or above 9,999,999, is ignored.
-	 * @default ""
-	 */
-	amount?: string;
-	/**
-	 * Offer the crypto rail when the account has a deposit address.
+	 * Show the Deposit button.
 	 * @default true
 	 */
-	showCrypto?: boolean;
+	showDeposit?: boolean;
 	/**
-	 * Offer the bank-transfer rail when the account has wire instructions.
+	 * Show the Accept button.
 	 * @default true
 	 */
-	showBank?: boolean;
-	/**
-	 * Cards you already hold for this payer, rendered as funding rows. Choosing one emits `cardDepositRequested` with the amount — the element never collects a card payment.
-	 * @default []
-	 */
-	savedCards?: DepositSavedCard[];
+	showAccept?: boolean;
 	/**
-	 * Add an "Add card" row that emits `addCardRequested` so you can open your own card-collection flow.
-	 * @default false
+	 * Show the Send button.
+	 * @default true
 	 */
-	allowNewCard?: boolean;
+	showSend?: boolean;
 	/**
-	 * Offer a "Platform balance" row that emits `platformBalanceSelected` immediately, with no amount step.
+	 * Show the Withdraw button. Off by default so an existing row keeps the buttons it already had.
 	 * @default false
 	 */
-	showPlatformBalance?: boolean;
-	/**
-	 * Processing fees to preview under the amount when a card row is selected. `percentageFee` is in percentage POINTS (`2.9` is 2.9%); `fixedFee` and `radarFee` are major units (`0.3` is $0.30).
-	 * @default null
-	 */
-	cardFee?: DepositCardFee | null;
+	showWithdraw?: boolean;
 	/**
-	 * Preselect a rail by id (`bank`, `crypto`, `platform_balance`, or a saved card id). Continue stays disabled while that rail is not yet offered, rather than funding through another one.
-	 * @default ""
+	 * Show the Convert button.
+	 * @default true
 	 */
-	preferredMethodId?: string;
+	showConvert?: boolean;
 	/**
-	 * Emit `bankSelected` and stay on the amount screen instead of showing the wire fields — for hosts that run their own step (a verification, an onboarding) first. Because that host owns the rail, the row is then offered even before the account has instructions to show.
+	 * Disable the Deposit button while keeping it visible.
 	 * @default false
 	 */
-	deferBankToHost?: boolean;
+	depositDisabled?: boolean;
 	/**
-	 * Show an "I have deposited my funds" button on the crypto screen that emits `depositConfirmed`, so you can start watching for the transfer.
+	 * Disable the Accept button while keeping it visible.
 	 * @default false
 	 */
-	confirmCryptoDeposit?: boolean;
-	/**
-	 * Open straight onto a rail instead of the picker. `crypto` and `bank` need no amount; their back button emits `dismissed` because there is no picker behind them.
-	 * @default "amount"
-	 */
-	initialStep?: "amount" | "bank" | "crypto";
+	acceptDisabled?: boolean;
 	/**
-	 * The payer confirmed an amount and a rail. Fires for every rail, before any instructions render — the analytics/funnel hook.
+	 * Disable the Send button while keeping it visible.
+	 * @default false
 	 */
-	onDepositInitiated?: ((payload: { method: "card" | "bank" | "crypto" | "platform_balance"; amount: number; currency: string; paymentMethodId?: string | undefined; }) => void);
+	sendDisabled?: boolean;
 	/**
-	 * A saved card was chosen. Collect the payment on your side, then call `showStep({ step: "amount" })` to return the element to the picker.
+	 * Disable the Withdraw button while keeping it visible.
+	 * @default false
 	 */
-	onCardDepositRequested?: ((payload: { amount: number; currency: string; paymentMethodId: string; }) => void);
+	withdrawDisabled?: boolean;
 	/**
-	 * The "Add card" row was picked — open your card-collection flow.
+	 * Disable the Convert button while keeping it visible.
+	 * @default false
 	 */
-	onAddCardRequested?: ((payload: Record<string, never>) => void);
+	convertDisabled?: boolean;
 	/**
-	 * The bank rail was chosen while `deferBankToHost` is set — run your step, then show the fields yourself or call `showStep({ step: "bank" })`.
+	 * The Deposit button was pressed and the Wallet controller opened its deposit overlay.
 	 */
-	onBankSelected?: ((payload: Record<string, never>) => void);
+	onDepositRequested?: ((payload: Record<string, never>) => void);
 	/**
-	 * The platform-balance row was picked. It carries no amount — your own screen collects that.
+	 * The Accept button was pressed and the Wallet controller opened the corresponding Whop setup page.
 	 */
-	onPlatformBalanceSelected?: ((payload: Record<string, never>) => void);
+	onAcceptRequested?: ((payload: Record<string, never>) => void);
 	/**
-	 * The payer said they sent the crypto. `since` is a unix-seconds floor to start matching incoming transfers from (it looks slightly back in time, so a transfer sent moments before the click still matches).
+	 * The Send button was pressed and the Wallet controller opened its send overlay.
 	 */
-	onDepositConfirmed?: ((payload: { network: string; token: string; networkLabel: string; since: number; }) => void);
+	onSendRequested?: ((payload: Record<string, never>) => void);
 	/**
-	 * The visible screen changed.
+	 * The Withdraw button was pressed and the Wallet controller opened its withdraw overlay.
 	 */
-	onStepChanged?: ((payload: { step: "amount" | "bank" | "crypto"; }) => void);
+	onWithdrawRequested?: ((payload: Record<string, never>) => void);
 	/**
-	 * The payer backed out of a rail the element was opened directly onto — close the surface holding it.
+	 * The Convert button was pressed and the Wallet controller opened its convert overlay.
 	 */
-	onDismissed?: ((payload: Record<string, never>) => void);
+	onConvertRequested?: ((payload: Record<string, never>) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -334,125 +301,170 @@ export interface DepositElementCreateOptions {
 }
 
 /**
- * The overlay handle for "deposit". Returned by `createOverlay("deposit")`; drives the modal presentation imperatively.
- * @see https://docs.whop.com/elements/latest/wallet/deposit
+ * Consumer props for the "activity" element. Set at create (or as `<ActivityElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/activity
  */
-export interface DepositElementOverlayHandle {
+export interface ActivityElementProps {
 	/**
-	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 * Only show activity for this currency. Without it, activity from every currency is shown.
 	 */
-	open(): void;
+	currency?: string;
 	/**
-	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 * A scoped token for the read. An account needs `company:balance:read`, and a user needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
 	 */
-	close(): void;
+	accessToken?: string;
 	/**
-	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 * Show at most this many rows and stop paging, for a preview of recent activity. The list gains a See all activity control that reports `seeAllRequested` instead of navigating.
 	 */
-	destroy(): void;
+	maxItems?: number;
 	/**
-	 * Merges new props into the mounted element. In React, change the component props instead.
+	 * When off, card transaction rows render inert (no click, no hover) instead of firing `activitySelected`. Use it when you know the viewer isn't allowed to see those details.
+	 * @default true
 	 */
-	update(options: Partial<DepositElementProps>): void;
+	canOpenCardTransactionDetails?: boolean;
+	/**
+	 * Activity types selected when the element mounts or its account changes. The viewer can change them with the built-in filters.
+	 * @default []
+	 */
+	defaultLineTypes?: ("platform_balance_transfer_outgoing" | "payment_gross" | "withdrawal" | "topup" | "payment_dispute" | "payment_revshare" | "card_spend_authorization" | "airdrop" | "onchain_swap_target" | "payment_gross_reversal" | "payment_refund" | "payment_refund_reversal" | "payment_dispute_reversal" | "payment_dispute_adjustment" | "dispute_hold_adjustment" | "topup_reversal" | "platform_balance_payment" | "platform_balance_payment_refund" | "platform_balance_transfer_incoming" | "internal_balance_transfer_incoming" | "internal_balance_transfer_outgoing" | "onchain_wallet_transfer_incoming" | "onchain_wallet_transfer_outgoing" | "withdrawal_reversal" | "withdrawal_clawback" | "withdrawal_clawback_reversal" | "payment_revshare_refund" | "payment_revshare_reversal" | "payment_referral" | "payment_referral_reversal" | "application_fee_payout" | "airdrop_reversal" | "airdrop_link_created" | "airdrop_link_returned" | "card_spend_authorization_void" | "card_spend_refund" | "onchain_deposit" | "bank_transfer" | "currency_conversion_outgoing" | "currency_conversion_incoming" | "airdrop_link_redeemed" | "resolution_center_refund" | "withdrawal_reclassification" | "payment_revshare_payout" | "platform_affiliate_payment" | "platform_affiliate_payment_reversal" | "onboarding_reward" | "platform_covered_dispute" | "treasury_payin" | "passthrough_gmv" | "promo_reversal" | "misc_reversal" | "ad_spend_charge" | "ad_campaign_budget" | "ad_budget_release" | "ad_publisher_payout" | "ad_publisher_payout_received" | "affiliate_fee" | "application_fee" | "billing_percentage_fee" | "buyer_fee" | "cross_border_percentage_fee" | "dispute_alert_fee" | "fraud_prevention_fee" | "fx_percentage_fee" | "high_risk_merchant_fee" | "orchestration_percentage_fee" | "payment_dispute_fee" | "payment_processing_fixed_fee" | "payment_processing_percentage_fee" | "payout_fee" | "revshare_percentage_fee" | "sales_tax_fee" | "sales_tax_remittance" | "sales_tax_remittance_reversal" | "stripe_domestic_processing_fee" | "stripe_international_processing_fee" | "three_ds_fixed_fee" | "whop_processing_fee")[];
+	/**
+	 * Hide the filter chips, for a compact list that the viewer does not filter.
+	 * @default false
+	 */
+	hideFilters?: boolean;
 }
 
 /**
- * Consumer props for the "withdraw" element. Set at create (or as `<WithdrawElement />` JSX props), and updatable live via `update()`.
- * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ * The live handle for a mounted "activity" element. Returned by `create("activity")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/activity
  */
-export interface WithdrawElementProps {
+export interface ActivityElementHandle {
 	/**
-	 * Whether the confirmed payout was created successfully.
-	 * @default false
+	 * Re-fetch the account's activity from the first page. Call it after a mutation made elsewhere (a deposit, a send) so the list reflects it without waiting for the cache to expire.
 	 */
-	succeeded?: boolean;
+	refresh: () => Promise<void>;
 	/**
-	 * Saved payout methods with quotes for the current amount.
-	 * @default []
+	 * Set the date filter from outside the element, for example wiring a chart brush selection into the list. Pass `null` to clear it.
 	 */
-	methods?: WithdrawalMethod[];
+	setDateRange: (input: ActivityDateRangeOverride | null) => Promise<void>;
 	/**
-	 * Settled balance available to standard payout methods.
-	 * @default 0
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
 	 */
-	availableBalance?: number;
+	mount: (target: string | HTMLElement) => void;
 	/**
-	 * Pending balance that may be available to instant payout methods.
-	 * @default 0
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
 	 */
-	pendingBalance?: number;
+	destroy: () => void;
 	/**
-	 * The payout account's ISO 3166-1 alpha-2 country.
-	 * @default "US"
+	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	payoutCountry?: string;
+	update: (options: Partial<ActivityElementProps>) => void;
+}
+
+/**
+ * Options for `create("activity")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const activity = wallet.create("activity", {}); // this interface: props + on<Event> callbacks
+ * activity.mount("#wallet-activity");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/activity
+ */
+export interface ActivityElementCreateOptions {
 	/**
-	 * Payout methods available to add in the selected country, including required fields.
-	 * @default []
+	 * Only show activity for this currency. Without it, activity from every currency is shown.
 	 */
-	supportedMethods?: WithdrawalSupportedMethod[];
+	currency?: string;
 	/**
-	 * Whether supported payout methods are loading for the selected country.
-	 * @default false
+	 * A scoped token for the read. An account needs `company:balance:read`, and a user needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
 	 */
-	supportedMethodsLoading?: boolean;
+	accessToken?: string;
 	/**
-	 * Live standard and instant payout limits.
-	 * @default {"standard":{"maxAmount":0},"instant":{"maxAmount":0}}
+	 * Show at most this many rows and stop paging, for a preview of recent activity. The list gains a See all activity control that reports `seeAllRequested` instead of navigating.
 	 */
-	limits?: WithdrawalLimits;
+	maxItems?: number;
 	/**
-	 * Whether payout methods and limits are loading.
-	 * @default false
+	 * When off, card transaction rows render inert (no click, no hover) instead of firing `activitySelected`. Use it when you know the viewer isn't allowed to see those details.
+	 * @default true
 	 */
-	loading?: boolean;
+	canOpenCardTransactionDetails?: boolean;
 	/**
-	 * Whether the current amount is being repriced.
-	 * @default false
+	 * Activity types selected when the element mounts or its account changes. The viewer can change them with the built-in filters.
+	 * @default []
 	 */
-	quoteLoading?: boolean;
+	defaultLineTypes?: ("platform_balance_transfer_outgoing" | "payment_gross" | "withdrawal" | "topup" | "payment_dispute" | "payment_revshare" | "card_spend_authorization" | "airdrop" | "onchain_swap_target" | "payment_gross_reversal" | "payment_refund" | "payment_refund_reversal" | "payment_dispute_reversal" | "payment_dispute_adjustment" | "dispute_hold_adjustment" | "topup_reversal" | "platform_balance_payment" | "platform_balance_payment_refund" | "platform_balance_transfer_incoming" | "internal_balance_transfer_incoming" | "internal_balance_transfer_outgoing" | "onchain_wallet_transfer_incoming" | "onchain_wallet_transfer_outgoing" | "withdrawal_reversal" | "withdrawal_clawback" | "withdrawal_clawback_reversal" | "payment_revshare_refund" | "payment_revshare_reversal" | "payment_referral" | "payment_referral_reversal" | "application_fee_payout" | "airdrop_reversal" | "airdrop_link_created" | "airdrop_link_returned" | "card_spend_authorization_void" | "card_spend_refund" | "onchain_deposit" | "bank_transfer" | "currency_conversion_outgoing" | "currency_conversion_incoming" | "airdrop_link_redeemed" | "resolution_center_refund" | "withdrawal_reclassification" | "payment_revshare_payout" | "platform_affiliate_payment" | "platform_affiliate_payment_reversal" | "onboarding_reward" | "platform_covered_dispute" | "treasury_payin" | "passthrough_gmv" | "promo_reversal" | "misc_reversal" | "ad_spend_charge" | "ad_campaign_budget" | "ad_budget_release" | "ad_publisher_payout" | "ad_publisher_payout_received" | "affiliate_fee" | "application_fee" | "billing_percentage_fee" | "buyer_fee" | "cross_border_percentage_fee" | "dispute_alert_fee" | "fraud_prevention_fee" | "fx_percentage_fee" | "high_risk_merchant_fee" | "orchestration_percentage_fee" | "payment_dispute_fee" | "payment_processing_fixed_fee" | "payment_processing_percentage_fee" | "payout_fee" | "revshare_percentage_fee" | "sales_tax_fee" | "sales_tax_remittance" | "sales_tax_remittance_reversal" | "stripe_domestic_processing_fee" | "stripe_international_processing_fee" | "three_ds_fixed_fee" | "whop_processing_fee")[];
 	/**
-	 * Whether a new payout method is being saved.
+	 * Hide the filter chips, for a compact list that the viewer does not filter.
 	 * @default false
 	 */
-	savingMethod?: boolean;
+	hideFilters?: boolean;
 	/**
-	 * Whether the confirmed payout is being created.
-	 * @default false
+	 * A row was clicked. Open your own detail view or route for it; the element never navigates.
 	 */
-	submitting?: boolean;
+	onActivitySelected?: ((payload: { activity: LedgerActivity; }) => void);
 	/**
-	 * A host-side error to show inside the current screen.
-	 * @default ""
+	 * The pointer entered a row, or left one (`null`). Point something of your own at the same moment, like marking the row on a balance chart.
 	 */
-	error?: string;
+	onActivityHovered?: ((payload: { activity: LedgerActivity; } | null) => void);
 	/**
-	 * True when the last payout was refused because the bank could not confirm the account holder name. Shows a fix-or-confirm choice; confirming re-emits withdrawalRequested with acknowledgeBankWarning set. Set this back to false when handling each withdrawalRequested — the choice appears on the change to true, so a flag left true hides every later refusal.
-	 * @default false
+	 * The viewer pressed See all activity on a `maxItems` list. Open your own full activity screen; the element never navigates.
 	 */
-	bankWarning?: boolean;
+	onSeeAllRequested?: ((payload: Record<string, never>) => void);
 	/**
-	 * The most recently created method, selected when it appears in methods.
-	 * @default ""
+	 * The viewer changed the date filter through the filter chips rather than through `setDateRange`. Clear any range selection of your own, like a chart brush, that no longer matches.
 	 */
-	createdMethodId?: string;
+	onDateRangeChanged?: ((payload: { dateRange: { start: string; end: string; } | null; }) => void);
 	/**
-	 * Set when the payer backed out of Plaid Link or it failed to open. Unlocks manual entry on a rail that otherwise requires linking.
-	 * @default false
+	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
-	plaidUnavailable?: boolean;
+	onLoaderStart?: (() => void);
 	/**
-	 * Whether a bank link is in progress — the Plaid session is open, or the linked method is being saved.
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * Consumer props for the "activityDetail" element. Set at create (or as `<ActivityDetailElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/activityDetail
+ */
+export interface ActivityDetailElementProps {
+	/**
+	 * Optional prefetched ledger activity row. When provided, the element renders it without another request.
+	 * @default null
+	 */
+	activity?: LedgerActivity | null;
+	/**
+	 * Optional ledger activity ID to retrieve when no prefetched activity row is provided.
+	 * @default null
+	 */
+	activityId?: string | null;
+	/**
+	 * Optional card transaction ID (`citx_`) to retrieve and show as a card receipt — what a card table hands back when a row is pressed. Takes precedence over `activityId`, and is ignored when a prefetched row is passed.
+	 * @default null
+	 */
+	cardTransactionId?: string | null;
+	/**
+	 * Show the cardholder row on a card receipt. Company accounts only — a personal wallet has one cardholder, so the row never appears there. Reading the name needs `company:authorized_user:read`; without it the row reads Unavailable.
+	 * @default true
+	 */
+	showCardholder?: boolean;
+	/**
+	 * Show the report-an-issue action for eligible card transactions. The action emits an event for the host.
 	 * @default false
 	 */
-	linkingBank?: boolean;
+	showCardTransactionReportIssueAction?: boolean;
 }
 
 /**
- * The live handle for a mounted "withdraw" element. Returned by `create("withdraw")`; in React, the component's `ref`.
- * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ * The live handle for a mounted "activityDetail" element. Returned by `create("activityDetail")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/activityDetail
  */
-export interface WithdrawElementHandle {
+export interface ActivityDetailElementHandle {
 	/**
 	 * Mounts the element in `target` and starts loading. React components mount themselves.
 	 */
@@ -464,144 +476,1608 @@ export interface WithdrawElementHandle {
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update: (options: Partial<WithdrawElementProps>) => void;
+	update: (options: Partial<ActivityDetailElementProps>) => void;
 }
 
 /**
- * Options for `create("withdraw")`: the consumer props plus event callbacks and lifecycle hooks.
+ * Options for `create("activityDetail")`: the consumer props plus event callbacks and lifecycle hooks.
  * @example
  * ```ts
- * const withdraw = wallet.create("withdraw", {}); // this interface: props + on<Event> callbacks
- * withdraw.mount("#wallet-withdraw");
+ * const activityDetail = wallet.createOverlay("activityDetail", {}); // this interface: props + on<Event> callbacks
+ * activityDetail.open();
  * ```
- * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ * @see https://docs.whop.com/elements/latest/wallet/activityDetail
  */
-export interface WithdrawElementCreateOptions {
+export interface ActivityDetailElementCreateOptions {
 	/**
-	 * Whether the confirmed payout was created successfully.
+	 * Optional prefetched ledger activity row. When provided, the element renders it without another request.
+	 * @default null
+	 */
+	activity?: LedgerActivity | null;
+	/**
+	 * Optional ledger activity ID to retrieve when no prefetched activity row is provided.
+	 * @default null
+	 */
+	activityId?: string | null;
+	/**
+	 * Optional card transaction ID (`citx_`) to retrieve and show as a card receipt — what a card table hands back when a row is pressed. Takes precedence over `activityId`, and is ignored when a prefetched row is passed.
+	 * @default null
+	 */
+	cardTransactionId?: string | null;
+	/**
+	 * Show the cardholder row on a card receipt. Company accounts only — a personal wallet has one cardholder, so the row never appears there. Reading the name needs `company:authorized_user:read`; without it the row reads Unavailable.
+	 * @default true
+	 */
+	showCardholder?: boolean;
+	/**
+	 * Show the report-an-issue action for eligible card transactions. The action emits an event for the host.
 	 * @default false
 	 */
-	succeeded?: boolean;
+	showCardTransactionReportIssueAction?: boolean;
 	/**
-	 * Saved payout methods with quotes for the current amount.
-	 * @default []
+	 * The card row was clicked.
 	 */
-	methods?: WithdrawalMethod[];
+	onCardSelected?: ((payload: { cardId: string; }) => void);
 	/**
-	 * Settled balance available to standard payout methods.
-	 * @default 0
+	 * The cardholder row was clicked. Open your own profile surface for that user.
 	 */
-	availableBalance?: number;
+	onCardholderSelected?: ((payload: { userId: string; }) => void);
 	/**
-	 * Pending balance that may be available to instant payout methods.
-	 * @default 0
+	 * Report an issue was clicked. Open the host-owned card dispute flow.
 	 */
-	pendingBalance?: number;
+	onCardTransactionIssueRequested?: ((payload: { transactionId: string; }) => void);
 	/**
-	 * The payout account's ISO 3166-1 alpha-2 country.
-	 * @default "US"
+	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
-	payoutCountry?: string;
+	onLoaderStart?: (() => void);
 	/**
-	 * Payout methods available to add in the selected country, including required fields.
-	 * @default []
+	 * Runs after the element's first complete paint.
 	 */
-	supportedMethods?: WithdrawalSupportedMethod[];
+	onReady?: (() => void);
 	/**
-	 * Whether supported payout methods are loading for the selected country.
-	 * @default false
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
 	 */
-	supportedMethodsLoading?: boolean;
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * The overlay handle for "activityDetail". Returned by `createOverlay("activityDetail")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/activityDetail
+ */
+export interface ActivityDetailElementOverlayHandle {
 	/**
-	 * Live standard and instant payout limits.
-	 * @default {"standard":{"maxAmount":0},"instant":{"maxAmount":0}}
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
 	 */
-	limits?: WithdrawalLimits;
+	open(): void;
 	/**
-	 * Whether payout methods and limits are loading.
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy(): void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update(options: Partial<ActivityDetailElementProps>): void;
+}
+
+/**
+ * Consumer props for the "deposit" element. Set at create (or as `<DepositElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/deposit
+ */
+export interface DepositElementProps {
+	/**
+	 * A scoped token that lets the rails resolution read a personal (`user_`) account — needs `payout:account:read`, plus `payout:account:update` for the bank rail to provision. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the call carries the viewer's own session, which only answers same-origin; business accounts resolve without any credential.
+	 */
+	accessToken?: string;
+	/**
+	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero is ignored, as is one longer than 12 whole digits; the rest is rounded to the currency’s decimal places.
+	 * @default ""
+	 */
+	amount?: string;
+	/**
+	 * Offer the crypto rail when the account has a deposit address.
+	 * @default true
+	 */
+	showCrypto?: boolean;
+	/**
+	 * Offer the bank-transfer rail. Shown even before the account has bank details — choosing it then asks the viewer to verify their identity when that is what the account still owes, and reports the rail as not available yet when it is not.
+	 * @default true
+	 */
+	showBank?: boolean;
+	/**
+	 * Cards you already hold for this payer, rendered as funding rows. Choosing one emits `cardDepositRequested` with the amount — the element never collects a card payment.
+	 * @default []
+	 */
+	savedCards?: DepositSavedCard[];
+	/**
+	 * Add an "Add card" row that emits `addCardRequested` so you can open your own card-collection flow.
 	 * @default false
 	 */
-	loading?: boolean;
+	allowNewCard?: boolean;
 	/**
-	 * Whether the current amount is being repriced.
+	 * Offer a "Platform balance" row that emits `platformBalanceSelected` immediately, with no amount step.
 	 * @default false
 	 */
-	quoteLoading?: boolean;
+	showPlatformBalance?: boolean;
 	/**
-	 * Whether a new payout method is being saved.
+	 * Processing fees to preview under the amount when a card row is selected. `percentageFee` is in percentage POINTS (`2.9` is 2.9%); `fixedFee` and `radarFee` are major units (`0.3` is $0.30).
+	 * @default null
+	 */
+	cardFee?: DepositCardFee | null;
+	/**
+	 * Preselect a rail by id (`bank`, `crypto`, `platform_balance`, or a saved card id). Continue stays disabled while that rail is not yet offered, rather than funding through another one.
+	 * @default ""
+	 */
+	preferredMethodId?: string;
+	/**
+	 * Emit `bankSelected` and stay on the amount screen instead of showing the wire fields — for hosts that run their own step after the account already has a virtual bank account.
 	 * @default false
 	 */
-	savingMethod?: boolean;
+	deferBankToHost?: boolean;
 	/**
-	 * Whether the confirmed payout is being created.
+	 * Show an "I have deposited my funds" button on the crypto screen that emits `depositConfirmed`, so you can start watching for the transfer.
 	 * @default false
 	 */
-	submitting?: boolean;
+	confirmCryptoDeposit?: boolean;
 	/**
-	 * A host-side error to show inside the current screen.
+	 * Open straight onto a rail instead of the picker. `crypto` and `bank` need no amount; their back button emits `dismissed` because there is no picker behind them.
+	 * @default "amount"
+	 */
+	initialStep?: "amount" | "bank" | "crypto";
+}
+
+/**
+ * The live handle for a mounted "deposit" element. Returned by `create("deposit")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/deposit
+ */
+export interface DepositElementHandle {
+	/**
+	 * Move the element to a screen. `{ step: "amount" }` is how you hand control back after settling a card or platform-balance deposit on your side.
+	 */
+	showStep: (input: { step: "amount" | "bank" | "crypto"; }) => Promise<void>;
+	/**
+	 * Re-resolve the account's funding rails. Call it after anything on your side changes what the account can offer — finishing bank onboarding, for instance — so the new rail appears without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<DepositElementProps>) => void;
+}
+
+/**
+ * Options for `create("deposit")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const deposit = wallet.create("deposit", {}); // this interface: props + on<Event> callbacks
+ * deposit.mount("#wallet-deposit");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/deposit
+ */
+export interface DepositElementCreateOptions {
+	/**
+	 * A scoped token that lets the rails resolution read a personal (`user_`) account — needs `payout:account:read`, plus `payout:account:update` for the bank rail to provision. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the call carries the viewer's own session, which only answers same-origin; business accounts resolve without any credential.
+	 */
+	accessToken?: string;
+	/**
+	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero is ignored, as is one longer than 12 whole digits; the rest is rounded to the currency’s decimal places.
 	 * @default ""
 	 */
-	error?: string;
+	amount?: string;
 	/**
-	 * True when the last payout was refused because the bank could not confirm the account holder name. Shows a fix-or-confirm choice; confirming re-emits withdrawalRequested with acknowledgeBankWarning set. Set this back to false when handling each withdrawalRequested — the choice appears on the change to true, so a flag left true hides every later refusal.
+	 * Offer the crypto rail when the account has a deposit address.
+	 * @default true
+	 */
+	showCrypto?: boolean;
+	/**
+	 * Offer the bank-transfer rail. Shown even before the account has bank details — choosing it then asks the viewer to verify their identity when that is what the account still owes, and reports the rail as not available yet when it is not.
+	 * @default true
+	 */
+	showBank?: boolean;
+	/**
+	 * Cards you already hold for this payer, rendered as funding rows. Choosing one emits `cardDepositRequested` with the amount — the element never collects a card payment.
+	 * @default []
+	 */
+	savedCards?: DepositSavedCard[];
+	/**
+	 * Add an "Add card" row that emits `addCardRequested` so you can open your own card-collection flow.
 	 * @default false
 	 */
-	bankWarning?: boolean;
+	allowNewCard?: boolean;
 	/**
-	 * The most recently created method, selected when it appears in methods.
+	 * Offer a "Platform balance" row that emits `platformBalanceSelected` immediately, with no amount step.
+	 * @default false
+	 */
+	showPlatformBalance?: boolean;
+	/**
+	 * Processing fees to preview under the amount when a card row is selected. `percentageFee` is in percentage POINTS (`2.9` is 2.9%); `fixedFee` and `radarFee` are major units (`0.3` is $0.30).
+	 * @default null
+	 */
+	cardFee?: DepositCardFee | null;
+	/**
+	 * Preselect a rail by id (`bank`, `crypto`, `platform_balance`, or a saved card id). Continue stays disabled while that rail is not yet offered, rather than funding through another one.
 	 * @default ""
 	 */
-	createdMethodId?: string;
+	preferredMethodId?: string;
 	/**
-	 * Set when the payer backed out of Plaid Link or it failed to open. Unlocks manual entry on a rail that otherwise requires linking.
+	 * Emit `bankSelected` and stay on the amount screen instead of showing the wire fields — for hosts that run their own step after the account already has a virtual bank account.
 	 * @default false
 	 */
-	plaidUnavailable?: boolean;
+	deferBankToHost?: boolean;
 	/**
-	 * Whether a bank link is in progress — the Plaid session is open, or the linked method is being saved.
+	 * Show an "I have deposited my funds" button on the crypto screen that emits `depositConfirmed`, so you can start watching for the transfer.
 	 * @default false
 	 */
-	linkingBank?: boolean;
+	confirmCryptoDeposit?: boolean;
 	/**
-	 * The amount changed and should be repriced.
+	 * Open straight onto a rail instead of the picker. `crypto` and `bank` need no amount; their back button emits `dismissed` because there is no picker behind them.
+	 * @default "amount"
 	 */
-	onAmountChanged?: ((payload: { amount: number; }) => void);
+	initialStep?: "amount" | "bank" | "crypto";
 	/**
-	 * The add-method country changed and supported methods should be refreshed.
+	 * The payer confirmed an amount and a rail. Fires for every rail, before any instructions render — the analytics/funnel hook.
 	 */
-	onCountryChanged?: ((payload: { country: string; }) => void);
+	onDepositInitiated?: ((payload: { method: "bank" | "crypto" | "card" | "platform_balance"; amount: number; currency: string; paymentMethodId?: string | undefined; }) => void);
+	/**
+	 * A saved card was chosen. Collect the payment on your side, then call `showStep({ step: "amount" })` to return the element to the picker.
+	 */
+	onCardDepositRequested?: ((payload: { amount: number; currency: string; paymentMethodId: string; }) => void);
+	/**
+	 * The "Add card" row was picked — open your card-collection flow.
+	 */
+	onAddCardRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * The bank rail was chosen while `deferBankToHost` is set — run your step, then show the fields yourself or call `showStep({ step: "bank" })`.
+	 */
+	onBankSelected?: ((payload: Record<string, never>) => void);
+	/**
+	 * The viewer chose bank transfer before this account has a virtual bank account. The element stays on the amount screen and never navigates — mount your own verification, such as the `verifications` controller, in answer to this.
+	 */
+	onIdentityVerificationRequested?: ((payload: { accountId: string; }) => void);
+	/**
+	 * The platform-balance row was picked. It carries no amount — your own screen collects that.
+	 */
+	onPlatformBalanceSelected?: ((payload: Record<string, never>) => void);
+	/**
+	 * The payer said they sent the crypto. `since` is a unix-seconds floor to start matching incoming transfers from (it looks slightly back in time, so a transfer sent moments before the click still matches).
+	 */
+	onDepositConfirmed?: ((payload: { network: string; token: string; networkLabel: string; since: number; }) => void);
+	/**
+	 * The visible screen changed.
+	 */
+	onStepChanged?: ((payload: { step: "amount" | "bank" | "crypto"; }) => void);
+	/**
+	 * The payer backed out of a rail the element was opened directly onto — close the surface holding it.
+	 */
+	onDismissed?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * The overlay handle for "deposit". Returned by `createOverlay("deposit")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/deposit
+ */
+export interface DepositElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy(): void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update(options: Partial<DepositElementProps>): void;
+}
+
+/**
+ * Consumer props for the "convert" element. Set at create (or as `<ConvertElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/convert
+ */
+export interface ConvertElementProps {}
+
+/**
+ * The live handle for a mounted "convert" element. Returned by `create("convert")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/convert
+ */
+export interface ConvertElementHandle {
+	/**
+	 * Re-fetch the account balance after another surface changes it.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<ConvertElementProps>) => void;
+}
+
+/**
+ * Options for `create("convert")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const convert = wallet.create("convert", {}); // this interface: props + on<Event> callbacks
+ * convert.mount("#wallet-convert");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/convert
+ */
+export interface ConvertElementCreateOptions {
+	/**
+	 * The visible conversion step changed.
+	 */
+	onViewChanged?: ((payload: { view: "pending" | "input" | "review" | "success"; }) => void);
+	/**
+	 * A conversion completed or remains pending after the polling window. Refresh account balance and activity.
+	 */
+	onBalanceChanged?: ((payload: Record<string, never>) => void);
+	/**
+	 * The viewer finished or dismissed the conversion flow.
+	 */
+	onDone?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * The overlay handle for "convert". Returned by `createOverlay("convert")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/convert
+ */
+export interface ConvertElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy(): void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update(options: Partial<ConvertElementProps>): void;
+}
+
+/**
+ * Consumer props for the "withdraw" element. Set at create (or as `<WithdrawElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementProps {
+	/**
+	 * A scoped token for listing payout methods and creating the payout — needs `payout:withdraw_funds`, `payout:destination:read`, and `payout:create_destination` to add a bank. Omitted, the calls carry the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Whether the confirmed payout was created successfully.
+	 * @default false
+	 */
+	succeeded?: boolean;
+	/**
+	 * Saved payout methods with quotes for the current amount.
+	 * @default []
+	 */
+	methods?: WithdrawalMethod[];
+	/**
+	 * Settled balance available to standard payout methods.
+	 * @default 0
+	 */
+	availableBalance?: number;
+	/**
+	 * Pending balance that may be available to instant payout methods.
+	 * @default 0
+	 */
+	pendingBalance?: number;
+	/**
+	 * The payout account's ISO 3166-1 alpha-2 country.
+	 * @default "US"
+	 */
+	payoutCountry?: string;
+	/**
+	 * Payout methods available to add in the selected country, including required fields.
+	 * @default []
+	 */
+	supportedMethods?: WithdrawalSupportedMethod[];
+	/**
+	 * Whether supported payout methods are loading for the selected country.
+	 * @default false
+	 */
+	supportedMethodsLoading?: boolean;
+	/**
+	 * Live standard and instant payout limits.
+	 * @default {"standard":{"maxAmount":0},"instant":{"maxAmount":0}}
+	 */
+	limits?: WithdrawalLimits;
+	/**
+	 * Whether payout methods and limits are loading.
+	 * @default false
+	 */
+	loading?: boolean;
+	/**
+	 * Whether the current amount is being repriced.
+	 * @default false
+	 */
+	quoteLoading?: boolean;
+	/**
+	 * Whether this payout must use an exact provider-backed quote before confirmation.
+	 * @default false
+	 */
+	payoutQuoteRequired?: boolean;
+	/**
+	 * The exact short-lived payout quote returned for the current confirmation request.
+	 * @default null
+	 */
+	payoutQuote?: WithdrawalPayoutQuote | null;
+	/**
+	 * Whether an exact payout quote is being created.
+	 * @default false
+	 */
+	payoutQuoteLoading?: boolean;
+	/**
+	 * The error from the current exact payout quote request, if any.
+	 * @default ""
+	 */
+	payoutQuoteError?: string;
+	/**
+	 * Whether the last quote request was inconclusive and must be retried with the same request ID.
+	 * @default false
+	 */
+	payoutQuoteRetryRequired?: boolean;
+	/**
+	 * Whether the last payout result was inconclusive and must be retried exactly.
+	 * @default false
+	 */
+	withdrawalRetryRequired?: boolean;
+	/**
+	 * The exact unresolved payout request to retry after the element remounts.
+	 * @default null
+	 */
+	unresolvedWithdrawalRequest?: WithdrawalRequest | null;
+	/**
+	 * Whether a new payout method is being saved.
+	 * @default false
+	 */
+	savingMethod?: boolean;
+	/**
+	 * Whether the confirmed payout is being created.
+	 * @default false
+	 */
+	submitting?: boolean;
+	/**
+	 * A host-side error to show inside the current screen.
+	 * @default ""
+	 */
+	error?: string;
+	/**
+	 * True when the last payout was refused because the bank could not confirm the account holder name. Shows a fix-or-confirm choice; confirming re-emits withdrawalRequested with acknowledgeBankWarning set. Set this back to false when handling each withdrawalRequested — the choice appears on the change to true, so a flag left true hides every later refusal.
+	 * @default false
+	 */
+	bankWarning?: boolean;
+	/**
+	 * The most recently created method, selected when it appears in methods.
+	 * @default ""
+	 */
+	createdMethodId?: string;
+	/**
+	 * Set when the payer backed out of Plaid Link or it failed to open. Unlocks manual entry on a rail that otherwise requires linking.
+	 * @default false
+	 */
+	plaidUnavailable?: boolean;
+	/**
+	 * Whether a bank link is in progress — the Plaid session is open, or the linked method is being saved.
+	 * @default false
+	 */
+	linkingBank?: boolean;
+}
+
+/**
+ * The live handle for a mounted "withdraw" element. Returned by `create("withdraw")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementHandle {
+	/**
+	 * Re-fetch saved payout methods and limits. Call it after anything on your side changes what the account can pay out to.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<WithdrawElementProps>) => void;
+}
+
+/**
+ * Options for `create("withdraw")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const withdraw = wallet.create("withdraw", {}); // this interface: props + on<Event> callbacks
+ * withdraw.mount("#wallet-withdraw");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementCreateOptions {
+	/**
+	 * A scoped token for listing payout methods and creating the payout — needs `payout:withdraw_funds`, `payout:destination:read`, and `payout:create_destination` to add a bank. Omitted, the calls carry the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Whether the confirmed payout was created successfully.
+	 * @default false
+	 */
+	succeeded?: boolean;
+	/**
+	 * Saved payout methods with quotes for the current amount.
+	 * @default []
+	 */
+	methods?: WithdrawalMethod[];
+	/**
+	 * Settled balance available to standard payout methods.
+	 * @default 0
+	 */
+	availableBalance?: number;
+	/**
+	 * Pending balance that may be available to instant payout methods.
+	 * @default 0
+	 */
+	pendingBalance?: number;
+	/**
+	 * The payout account's ISO 3166-1 alpha-2 country.
+	 * @default "US"
+	 */
+	payoutCountry?: string;
+	/**
+	 * Payout methods available to add in the selected country, including required fields.
+	 * @default []
+	 */
+	supportedMethods?: WithdrawalSupportedMethod[];
+	/**
+	 * Whether supported payout methods are loading for the selected country.
+	 * @default false
+	 */
+	supportedMethodsLoading?: boolean;
+	/**
+	 * Live standard and instant payout limits.
+	 * @default {"standard":{"maxAmount":0},"instant":{"maxAmount":0}}
+	 */
+	limits?: WithdrawalLimits;
+	/**
+	 * Whether payout methods and limits are loading.
+	 * @default false
+	 */
+	loading?: boolean;
+	/**
+	 * Whether the current amount is being repriced.
+	 * @default false
+	 */
+	quoteLoading?: boolean;
+	/**
+	 * Whether this payout must use an exact provider-backed quote before confirmation.
+	 * @default false
+	 */
+	payoutQuoteRequired?: boolean;
+	/**
+	 * The exact short-lived payout quote returned for the current confirmation request.
+	 * @default null
+	 */
+	payoutQuote?: WithdrawalPayoutQuote | null;
+	/**
+	 * Whether an exact payout quote is being created.
+	 * @default false
+	 */
+	payoutQuoteLoading?: boolean;
+	/**
+	 * The error from the current exact payout quote request, if any.
+	 * @default ""
+	 */
+	payoutQuoteError?: string;
+	/**
+	 * Whether the last quote request was inconclusive and must be retried with the same request ID.
+	 * @default false
+	 */
+	payoutQuoteRetryRequired?: boolean;
+	/**
+	 * Whether the last payout result was inconclusive and must be retried exactly.
+	 * @default false
+	 */
+	withdrawalRetryRequired?: boolean;
+	/**
+	 * The exact unresolved payout request to retry after the element remounts.
+	 * @default null
+	 */
+	unresolvedWithdrawalRequest?: WithdrawalRequest | null;
+	/**
+	 * Whether a new payout method is being saved.
+	 * @default false
+	 */
+	savingMethod?: boolean;
+	/**
+	 * Whether the confirmed payout is being created.
+	 * @default false
+	 */
+	submitting?: boolean;
+	/**
+	 * A host-side error to show inside the current screen.
+	 * @default ""
+	 */
+	error?: string;
+	/**
+	 * True when the last payout was refused because the bank could not confirm the account holder name. Shows a fix-or-confirm choice; confirming re-emits withdrawalRequested with acknowledgeBankWarning set. Set this back to false when handling each withdrawalRequested — the choice appears on the change to true, so a flag left true hides every later refusal.
+	 * @default false
+	 */
+	bankWarning?: boolean;
+	/**
+	 * The most recently created method, selected when it appears in methods.
+	 * @default ""
+	 */
+	createdMethodId?: string;
+	/**
+	 * Set when the payer backed out of Plaid Link or it failed to open. Unlocks manual entry on a rail that otherwise requires linking.
+	 * @default false
+	 */
+	plaidUnavailable?: boolean;
+	/**
+	 * Whether a bank link is in progress — the Plaid session is open, or the linked method is being saved.
+	 * @default false
+	 */
+	linkingBank?: boolean;
+	/**
+	 * The amount changed and should be repriced.
+	 */
+	onAmountChanged?: ((payload: { amount: number; }) => void);
+	/**
+	 * The add-method country changed and supported methods should be refreshed.
+	 */
+	onCountryChanged?: ((payload: { country: string; }) => void);
+	/**
+	 * A supported payout method was selected and its exact required fields should be loaded.
+	 */
+	onSupportedMethodChanged?: ((payload: { country: string; supportedPayoutMethodId: string; destinationCurrency: string; }) => void);
+	/**
+	 * The payer submitted the dynamic add-payout-method form.
+	 */
+	onAddMethodRequested?: ((payload: WithdrawalCreateMethodInput) => void);
+	/**
+	 * The payer chose to link their bank through Plaid instead of typing details. Open Plaid Link on receipt.
+	 */
+	onPlaidLinkRequested?: ((payload: { country: string; supportedPayoutMethodId: string; destinationCurrency: string; }) => void);
+	/**
+	 * The newly added payout method finished its verification step.
+	 */
+	onMethodVerificationCompleted?: ((payload: Record<string, never>) => void);
+	/**
+	 * The payer requested to rename a saved payout method.
+	 */
+	onRenameMethodRequested?: ((payload: { methodId: string; }) => void);
+	/**
+	 * The payer requested to remove a saved payout method.
+	 */
+	onRemoveMethodRequested?: ((payload: { methodId: string; }) => void);
+	/**
+	 * The payer requested an exact short-lived quote before confirming a payout.
+	 */
+	onPayoutQuoteRequested?: ((payload: WithdrawalPayoutQuoteRequest) => void);
+	/**
+	 * The payer confirmed the payout. When the host is driving the flow, create the payout on receipt. When the element created it, this fires after success so the host can refresh balances — do not create a second payout.
+	 */
+	onWithdrawalRequested?: ((payload: WithdrawalRequest) => void);
+	/**
+	 * The payer finished reviewing a successful payout.
+	 */
+	onDone?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * The overlay handle for "withdraw". Returned by `createOverlay("withdraw")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy(): void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update(options: Partial<WithdrawElementProps>): void;
+}
+
+/**
+ * Consumer props for the "send" element. Set at create (or as `<SendElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementProps {
+	/**
+	 * A scoped token for the privileged read/write — needs `payout:transfer_funds` for direct transfers and `payout:withdraw_funds` for recipient lists (plus `company:authorized_user:read` and `member:basic:read` for recipient search, `airdrop_link:manage` for claim links). Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Overrides the recipient-picker header. Omitted, the header is "Choose recipient".
+	 */
+	title?: string;
+	/**
+	 * Off, only the team/other-account list shows — no search box. For a host that knows the viewer lacks `member:basic:read`.
+	 * @default true
+	 */
+	canSearchRecipients?: boolean;
+	/**
+	 * Off, the "Send via link" row is hidden. For a host that knows the viewer lacks `airdrop_link:manage`.
+	 * @default true
+	 */
+	canCreateLink?: boolean;
+	/**
+	 * Skip the picker and open straight onto this recipient's amount screen — for a "pay this person" action row. No back button is shown in that case, matching there being no picker behind it.
+	 * @default null
+	 */
+	initialRecipient?: SendRecipient | null;
+	/**
+	 * Preselect a currency in the amount screen's picker. Falls back to `currency`, then USD.
+	 * @default ""
+	 */
+	initialCurrency?: string;
+}
+
+/**
+ * The live handle for a mounted "send" element. Returned by `create("send")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementHandle {
+	/**
+	 * Re-fetch the account's balances and recipient list. Call it after anything on your side changes what it can offer.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<SendElementProps>) => void;
+}
+
+/**
+ * Options for `create("send")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const send = wallet.create("send", {}); // this interface: props + on<Event> callbacks
+ * send.mount("#wallet-send");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementCreateOptions {
+	/**
+	 * A scoped token for the privileged read/write — needs `payout:transfer_funds` for direct transfers and `payout:withdraw_funds` for recipient lists (plus `company:authorized_user:read` and `member:basic:read` for recipient search, `airdrop_link:manage` for claim links). Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Overrides the recipient-picker header. Omitted, the header is "Choose recipient".
+	 */
+	title?: string;
+	/**
+	 * Off, only the team/other-account list shows — no search box. For a host that knows the viewer lacks `member:basic:read`.
+	 * @default true
+	 */
+	canSearchRecipients?: boolean;
+	/**
+	 * Off, the "Send via link" row is hidden. For a host that knows the viewer lacks `airdrop_link:manage`.
+	 * @default true
+	 */
+	canCreateLink?: boolean;
+	/**
+	 * Skip the picker and open straight onto this recipient's amount screen — for a "pay this person" action row. No back button is shown in that case, matching there being no picker behind it.
+	 * @default null
+	 */
+	initialRecipient?: SendRecipient | null;
+	/**
+	 * Preselect a currency in the amount screen's picker. Falls back to `currency`, then USD.
+	 * @default ""
+	 */
+	initialCurrency?: string;
+	/**
+	 * The visible screen changed.
+	 */
+	onStepChanged?: ((payload: { step: "success" | "enter_amount" | "select_recipient" | "create_link" | "link_success"; }) => void);
+	/**
+	 * A transfer succeeded. Refresh anything on your side reading the account's balance or activity.
+	 */
+	onSendCompleted?: ((payload: { recipient: SendRecipient; amount: number; currency: string; }) => void);
+	/**
+	 * A claim link was created. Refresh anything on your side reading the account's balance.
+	 */
+	onLinkCreated?: ((payload: { claimUrl: string; amount: number; redeemableCount: number; }) => void);
+	/**
+	 * The viewer clicked "Done" on a success screen — close the surface holding it.
+	 */
+	onDone?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * The overlay handle for "send". Returned by `createOverlay("send")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy(): void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update(options: Partial<SendElementProps>): void;
+}
+
+/**
+ * Consumer props for the "cardDetails" element. Set at create (or as `<CardDetailsElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/cardDetails
+ */
+export interface CardDetailsElementProps {
+	/**
+	 * A scoped token for the card and its transactions — needs `payout:account:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Non-sensitive card metadata a host has already loaded. Supplying it saves the card face a list request; its authorized secrets are still fetched so the reveal stays instant.
+	 */
+	card?: { status: "active" | "frozen" | "canceled" | "invited" | "denied" | null; name: string | null; id: string; last4: string | null; billing: Billing | null; expiration_month: string | null; expiration_year: string | null; };
+	/**
+	 * The card this drawer describes, prefixed `icrd_`.
+	 * @default ""
+	 */
+	cardId?: string;
+	/**
+	 * How many recent transactions to list under the card.
+	 * @default 5
+	 */
+	latestCount?: number;
+	/**
+	 * Hide the latest-transactions list, for a host that shows its own beneath the drawer.
+	 * @default false
+	 */
+	hideTransactions?: boolean;
+	/**
+	 * Hide the overflow button, for a host with no card actions of its own to offer.
+	 * @default false
+	 */
+	hideMenuButton?: boolean;
+}
+
+/**
+ * The live handle for a mounted "cardDetails" element. Returned by `create("cardDetails")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/cardDetails
+ */
+export interface CardDetailsElementHandle {
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<CardDetailsElementProps>) => void;
+}
+
+/**
+ * Options for `create("cardDetails")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const cardDetails = wallet.createOverlay("cardDetails", {}); // this interface: props + on<Event> callbacks
+ * cardDetails.open();
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/cardDetails
+ */
+export interface CardDetailsElementCreateOptions {
+	/**
+	 * A scoped token for the card and its transactions — needs `payout:account:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Non-sensitive card metadata a host has already loaded. Supplying it saves the card face a list request; its authorized secrets are still fetched so the reveal stays instant.
+	 */
+	card?: { status: "active" | "frozen" | "canceled" | "invited" | "denied" | null; name: string | null; id: string; last4: string | null; billing: Billing | null; expiration_month: string | null; expiration_year: string | null; };
+	/**
+	 * The card this drawer describes, prefixed `icrd_`.
+	 * @default ""
+	 */
+	cardId?: string;
+	/**
+	 * How many recent transactions to list under the card.
+	 * @default 5
+	 */
+	latestCount?: number;
+	/**
+	 * Hide the latest-transactions list, for a host that shows its own beneath the drawer.
+	 * @default false
+	 */
+	hideTransactions?: boolean;
+	/**
+	 * Hide the overflow button, for a host with no card actions of its own to offer.
+	 * @default false
+	 */
+	hideMenuButton?: boolean;
+	/**
+	 * A transaction in the drawer was pressed.
+	 */
+	onTransactionSelected?: ((payload: { transactionId: string; }) => void);
+	/**
+	 * View all was pressed. Open your own full transaction surface — the drawer never navigates.
+	 */
+	onAllTransactionsRequested?: ((payload: { cardId: string; }) => void);
+	/**
+	 * Top up was pressed. Present your own funding surface, such as the wallet's deposit element.
+	 */
+	onTopUpRequested?: ((payload: { cardId: string; }) => void);
+	/**
+	 * Close was pressed. Dismiss the surface you opened the drawer in — the drawer never closes itself.
+	 */
+	onCloseRequested?: ((payload: { cardId: string; }) => void);
+	/**
+	 * The overflow button was pressed. Present your own card actions menu.
+	 */
+	onMenuRequested?: ((payload: { cardId: string; }) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * The overlay handle for "cardDetails". Returned by `createOverlay("cardDetails")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/cardDetails
+ */
+export interface CardDetailsElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy(): void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update(options: Partial<CardDetailsElementProps>): void;
+}
+
+/**
+ * Consumer props for the "verification" element. Set at create (or as `<VerificationElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/verification
+ */
+export interface VerificationElementProps {
+	/**
+	 * A scoped token for the read and for starting verification — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Which verification the button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+}
+
+/**
+ * The live handle for a mounted "verification" element. Returned by `create("verification")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/verification
+ */
+export interface VerificationElementHandle {
+	/**
+	 * Re-read the account. Call it when the viewer returns from verifying so the banner reflects the new state without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<VerificationElementProps>) => void;
+}
+
+/**
+ * Options for `create("verification")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const verification = wallet.create("verification", {}); // this interface: props + on<Event> callbacks
+ * verification.mount("#wallet-verification");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/verification
+ */
+export interface VerificationElementCreateOptions {
+	/**
+	 * A scoped token for the read and for starting verification — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Which verification the button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+	/**
+	 * The viewer pressed the verify button. The element never navigates — mount your own verification, such as the `verifications` controller, in answer to this.
+	 */
+	onVerificationRequested?: ((payload: { accountId: string; }) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * Consumer props for the "balances" sub-controller: the `create("balances")` options and the minted sub handle's `update()` payload (React: `<Balances>` props). Parent-injected props never appear here.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalancesSubOptions {
+	/**
+	 * A scoped token for balance breakdown and settlement reads. An account needs `company:balance:read`. Omitted, the viewer's same-origin session is used.
+	 */
+	accessToken?: string;
+	/**
+	 * Show this unit's holding balance page in place of the chart and list when a row is clicked. Off by default so a host that routes on `balanceSelected` is not covered by a second screen.
+	 * @default false
+	 */
+	openHoldingOnSelect?: boolean;
+}
+
+/**
+ * Consumer props for the "balances" sub-controller's "balance" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalanceElementProps {
+	/**
+	 * A scoped token for the reads. An account needs `company:balance:read` for the total and `stats:read` for the chart; a user's own balance needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`, and set a fresh one before it expires. Without it the reads use the viewer's own session, which only works same-origin.
+	 * @default ""
+	 */
+	accessToken?: string;
+	/**
+	 * The time range to open on. The buttons change it from there, or set this prop again to control it yourself.
+	 * @default "1M"
+	 */
+	range?: "1D" | "1W" | "1M" | "1Y" | "ALL";
+	/**
+	 * When the account was opened, as an ISO 8601 timestamp. `ALL` starts here instead of at its five-year default, so an account older than that keeps its full history.
+	 * @default ""
+	 */
+	openedAt?: string;
+	/**
+	 * Adds the account name to the label: `Total balance · Acme` normally, and `Acme balance on Jul 9` while the viewer reads a point. Without it the label is just `Total balance`.
+	 * @default ""
+	 */
+	accountName?: string;
+	/**
+	 * The selected range on the chart, as ISO 8601 timestamps. Set it to control the selection yourself, or `null` to clear the one the viewer made. Echo back what `rangeBrushed` reports, and clearing a filter elsewhere on your page clears the selection here too.
+	 * @default null
+	 */
+	brush?: { from: string; to: string; } | null;
+	/**
+	 * A moment to mark on the chart, as an ISO 8601 timestamp — the point something else on your page is pointing at, like the row under the pointer in an activity list. It reads like the viewer hovering that point themselves, and is ignored when it falls outside the window on screen or when they are reading the chart.
+	 * @default ""
+	 */
+	markedAt?: string;
+	/**
+	 * For a user, total their own money plus every account they own instead of their own money alone. Ignored for an account, which is a single account already.
+	 * @default false
+	 */
+	includeOwnedAccounts?: boolean;
+	/**
+	 * Hide the total and its change, leaving the chart and the range buttons.
+	 * @default false
+	 */
+	hideTotal?: boolean;
+	/**
+	 * Hide the chart, leaving the total and the range buttons.
+	 * @default false
+	 */
+	hideChart?: boolean;
+	/**
+	 * How tall the chart is drawn, in pixels.
+	 * @default 210
+	 */
+	height?: number;
+}
+
+/**
+ * The live handle for a mounted "balance" element. Returned by the "balances" sub handle's `create("balance")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalanceElementHandle {
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<BalanceElementProps>) => void;
+}
+
+/**
+ * Options for the "balances" sub handle's `create("balance")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalanceElementCreateOptions {
+	/**
+	 * A scoped token for the reads. An account needs `company:balance:read` for the total and `stats:read` for the chart; a user's own balance needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`, and set a fresh one before it expires. Without it the reads use the viewer's own session, which only works same-origin.
+	 * @default ""
+	 */
+	accessToken?: string;
+	/**
+	 * The time range to open on. The buttons change it from there, or set this prop again to control it yourself.
+	 * @default "1M"
+	 */
+	range?: "1D" | "1W" | "1M" | "1Y" | "ALL";
+	/**
+	 * When the account was opened, as an ISO 8601 timestamp. `ALL` starts here instead of at its five-year default, so an account older than that keeps its full history.
+	 * @default ""
+	 */
+	openedAt?: string;
+	/**
+	 * Adds the account name to the label: `Total balance · Acme` normally, and `Acme balance on Jul 9` while the viewer reads a point. Without it the label is just `Total balance`.
+	 * @default ""
+	 */
+	accountName?: string;
+	/**
+	 * The selected range on the chart, as ISO 8601 timestamps. Set it to control the selection yourself, or `null` to clear the one the viewer made. Echo back what `rangeBrushed` reports, and clearing a filter elsewhere on your page clears the selection here too.
+	 * @default null
+	 */
+	brush?: { from: string; to: string; } | null;
+	/**
+	 * A moment to mark on the chart, as an ISO 8601 timestamp — the point something else on your page is pointing at, like the row under the pointer in an activity list. It reads like the viewer hovering that point themselves, and is ignored when it falls outside the window on screen or when they are reading the chart.
+	 * @default ""
+	 */
+	markedAt?: string;
+	/**
+	 * For a user, total their own money plus every account they own instead of their own money alone. Ignored for an account, which is a single account already.
+	 * @default false
+	 */
+	includeOwnedAccounts?: boolean;
+	/**
+	 * Hide the total and its change, leaving the chart and the range buttons.
+	 * @default false
+	 */
+	hideTotal?: boolean;
+	/**
+	 * Hide the chart, leaving the total and the range buttons.
+	 * @default false
+	 */
+	hideChart?: boolean;
+	/**
+	 * How tall the chart is drawn, in pixels.
+	 * @default 210
+	 */
+	height?: number;
+	/**
+	 * The visible time range changed. Mirror it if something else on your page reads the same period.
+	 */
+	onRangeChanged?: ((payload: { range: "1D" | "1W" | "1M" | "1Y" | "ALL"; }) => void);
+	/**
+	 * The viewer dragged across the chart to select a range, or cleared the selection (`null`). Gives ISO 8601 timestamps plus the range they were read in, so you can filter your own views, like an activity list or a table, to the same period.
+	 */
+	onRangeBrushed?: ((payload: { from: string; to: string; range: "1D" | "1W" | "1M" | "1Y" | "ALL"; } | null) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * Consumer props for the "balances" sub-controller's "breakdown" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BreakdownElementProps {
+	/**
+	 * Off, the element performs no reads and renders a zero balance.
+	 * @default true
+	 */
+	enabled?: boolean;
+	/**
+	 * Show amounts in the selected holding. Turn this off to value the same balance breakdown in USD.
+	 * @default true
+	 */
+	showSourceCurrency?: boolean;
+	/**
+	 * Show the currency title and total above the rows. Turn this off when the surface around it already shows them.
+	 * @default true
+	 */
+	showTotal?: boolean;
+	/**
+	 * Draw the surrounding page padding. Turn this off when the surface around it already provides it.
+	 * @default true
+	 */
+	padded?: boolean;
+}
+
+/**
+ * The live handle for a mounted "breakdown" element. Returned by the "balances" sub handle's `create("breakdown")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BreakdownElementHandle {
+	/**
+	 * Re-fetch the balance after the host moves money.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<BreakdownElementProps>) => void;
+}
+
+/**
+ * Options for the "balances" sub handle's `create("breakdown")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BreakdownElementCreateOptions {
+	/**
+	 * Off, the element performs no reads and renders a zero balance.
+	 * @default true
+	 */
+	enabled?: boolean;
+	/**
+	 * Show amounts in the selected holding. Turn this off to value the same balance breakdown in USD.
+	 * @default true
+	 */
+	showSourceCurrency?: boolean;
+	/**
+	 * Show the currency title and total above the rows. Turn this off when the surface around it already shows them.
+	 * @default true
+	 */
+	showTotal?: boolean;
+	/**
+	 * Draw the surrounding page padding. Turn this off when the surface around it already provides it.
+	 * @default true
+	 */
+	padded?: boolean;
+	/**
+	 * A balance row or its matching bar segment was clicked. The host can open details for `available`, `pending`, `reserve`, or `debt`.
+	 */
+	onBreakdownSelected?: ((payload: { category: "pending" | "available" | "debt" | "reserve"; }) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * Consumer props for the "balances" sub-controller's "settlement" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface SettlementElementProps {
+	/**
+	 * Off, the Element performs no read and renders an empty details state.
+	 * @default true
+	 */
+	enabled?: boolean;
+	/**
+	 * Show amounts in the selected holding. Turn this off to value the details in USD.
+	 * @default true
+	 */
+	showSourceCurrency?: boolean;
+}
+
+/**
+ * The live handle for a mounted "settlement" element. Returned by the "balances" sub handle's `create("settlement")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface SettlementElementHandle {
+	/**
+	 * Re-fetch settlement and reserve details.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<SettlementElementProps>) => void;
+}
+
+/**
+ * Options for the "balances" sub handle's `create("settlement")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface SettlementElementCreateOptions {
+	/**
+	 * Off, the Element performs no read and renders an empty details state.
+	 * @default true
+	 */
+	enabled?: boolean;
+	/**
+	 * Show amounts in the selected holding. Turn this off to value the details in USD.
+	 * @default true
+	 */
+	showSourceCurrency?: boolean;
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * The overlay handle for the "balances" sub-controller's "settlement" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface SettlementElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy(): void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update(options: Partial<SettlementElementProps>): void;
+}
+
+/**
+ * Consumer props for the "balances" sub-controller's "list" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface ListElementProps {
+	/**
+	 * A scoped token for the read. An account needs `company:balance:read`; a user's holdings or owned-account list needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * For a user's `user_…` account, list their personal balance followed by every owned account the backend returns instead of listing the holdings inside their personal account. Ignored for an account.
+	 * @default false
+	 */
+	includeOwnedAccounts?: boolean;
+	/**
+	 * Show each row in the currency it is held in (€4.20, 0.00000009 cbBTC) and put the dollar value underneath. Off by default, so every row is in dollars.
+	 * @default false
+	 */
+	showSourceCurrency?: boolean;
+	/**
+	 * Keep the dollar value under a holding shown in its own currency. Only applies when `showSourceCurrency` is on.
+	 * @default true
+	 */
+	showUsdEquivalent?: boolean;
+	/**
+	 * Keep the personal row when `includeOwnedAccounts` is on. Turn it off if your app has no personal account to open.
+	 * @default true
+	 */
+	showPersonalAccount?: boolean;
+	/**
+	 * Show at most this many holding rows, largest first. When there are more, the list gains a Show all balances control that expands the rest in place. Without it every holding is listed.
+	 */
+	maxItems?: number;
+}
+
+/**
+ * The live handle for a mounted "list" element. Returned by the "balances" sub handle's `create("list")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface ListElementHandle {
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<ListElementProps>) => void;
+}
+
+/**
+ * Options for the "balances" sub handle's `create("list")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface ListElementCreateOptions {
 	/**
-	 * A supported payout method was selected and its exact required fields should be loaded.
+	 * A scoped token for the read. An account needs `company:balance:read`; a user's holdings or owned-account list needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
 	 */
-	onSupportedMethodChanged?: ((payload: { country: string; supportedPayoutMethodId: string; destinationCurrency: string; }) => void);
+	accessToken?: string;
 	/**
-	 * The payer submitted the dynamic add-payout-method form.
+	 * For a user's `user_…` account, list their personal balance followed by every owned account the backend returns instead of listing the holdings inside their personal account. Ignored for an account.
+	 * @default false
 	 */
-	onAddMethodRequested?: ((payload: WithdrawalCreateMethodInput) => void);
+	includeOwnedAccounts?: boolean;
 	/**
-	 * The payer chose to link their bank through Plaid instead of typing details. Open Plaid Link on receipt.
+	 * Show each row in the currency it is held in (€4.20, 0.00000009 cbBTC) and put the dollar value underneath. Off by default, so every row is in dollars.
+	 * @default false
 	 */
-	onPlaidLinkRequested?: ((payload: { country: string; supportedPayoutMethodId: string; destinationCurrency: string; }) => void);
+	showSourceCurrency?: boolean;
 	/**
-	 * The newly added payout method finished its verification step.
+	 * Keep the dollar value under a holding shown in its own currency. Only applies when `showSourceCurrency` is on.
+	 * @default true
 	 */
-	onMethodVerificationCompleted?: ((payload: Record<string, never>) => void);
+	showUsdEquivalent?: boolean;
 	/**
-	 * The payer requested to rename a saved payout method.
+	 * Keep the personal row when `includeOwnedAccounts` is on. Turn it off if your app has no personal account to open.
+	 * @default true
 	 */
-	onRenameMethodRequested?: ((payload: { methodId: string; }) => void);
+	showPersonalAccount?: boolean;
 	/**
-	 * The payer requested to remove a saved payout method.
+	 * Show at most this many holding rows, largest first. When there are more, the list gains a Show all balances control that expands the rest in place. Without it every holding is listed.
 	 */
-	onRemoveMethodRequested?: ((payload: { methodId: string; }) => void);
+	maxItems?: number;
 	/**
-	 * The payer confirmed the final payout details. Create the payout on receipt.
+	 * A holding row was clicked, with `includeOwnedAccounts` off. `holding` is `usd` for the combined dollar row, otherwise the holding symbol (`cbBTC`, `EUR`), and `kind` tells you which of the three it is so you can route without classifying symbols yourself. The element never navigates.
 	 */
-	onWithdrawalRequested?: ((payload: WithdrawalRequest) => void);
+	onBalanceSelected?: ((payload: { holding: string; kind: "usd" | "cash" | "asset"; }) => void);
 	/**
-	 * The payer finished reviewing a successful payout.
+	 * An account row was clicked, with `includeOwnedAccounts` on. `accountId` is the personal `user_…` tag or an owned `biz_…` tag, and `kind` lets you route without inspecting it. The element never navigates.
 	 */
-	onDone?: ((payload: Record<string, never>) => void);
+	onAccountSelected?: ((payload: { accountId: string; kind: "business" | "personal"; }) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -617,66 +2093,85 @@ export interface WithdrawElementCreateOptions {
 }
 
 /**
- * The overlay handle for "withdraw". Returned by `createOverlay("withdraw")`; drives the modal presentation imperatively.
- * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ * The "balances" sub-handle, minted by `handle.create("balances", …)`. Mounts the sub-controller's elements and carries its actions.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface WithdrawElementOverlayHandle {
+export interface BalancesSubHandle {
 	/**
-	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 * An account's balance and a chart of how it changed. The total and its change sit at the top, the chart below that, and the time range buttons at the bottom. The viewer can read individual points on the chart and switch the time range themselves.
 	 */
-	open(): void;
+	create(name: "balance", options?: BalanceElementCreateOptions): BalanceElementHandle;
 	/**
-	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 * One currency's total split into available, pending, reserve, and negative balances. Zero-value rows disappear, and the surface deliberately contains no money-movement buttons so the host owns those actions.
 	 */
-	close(): void;
+	create(name: "breakdown", options?: BreakdownElementCreateOptions): BreakdownElementHandle;
 	/**
-	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 * The account balance details shown by Whop's dashboard: available funds, pending settlement dates, reserve terms, and any negative balance. It opens as a 550px modal and uses the balances handle's account, currency, and credential.
 	 */
-	destroy(): void;
+	createOverlay(name: "settlement", options?: SettlementElementCreateOptions): SettlementElementOverlayHandle;
 	/**
-	 * Merges new props into the mounted element. In React, change the component props instead.
+	 * The holdings behind an account's balance. Every currency and token gets its own row, showing its name and its value in dollars, largest first. Rows can report which one the viewer tapped, so you can open your own screen for it. When `openHoldingOnSelect` is on, a row click shows that holding's balance page in place of this unit's chart and list.
 	 */
-	update(options: Partial<WithdrawElementProps>): void;
+	create(name: "list", options?: ListElementCreateOptions): ListElementHandle;
+	/**
+	 * Merges new props and callbacks into the sub-controller.
+	 */
+	update(options: Partial<BalancesSubOptions>): void;
+	/**
+	 * Destroys the sub-controller and its elements, then frees its exclusive slot. A later `create("balances")` starts fresh.
+	 */
+	destroy(): void;
 }
 
 /**
- * Consumer props for the "send" element. Set at create (or as `<SendElement />` JSX props), and updatable live via `update()`.
- * @see https://docs.whop.com/elements/latest/wallet/send
+ * Consumer props for the "cards" sub-controller: the `create("cards")` options and the minted sub handle's `update()` payload (React: `<Cards>` props). Parent-injected props never appear here.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface SendElementProps {
+export interface CardsSubOptions {
 	/**
-	 * A scoped token for the privileged read/write — needs `payout:withdraw_funds` (plus `company:authorized_user:read` and `member:basic:read` for recipient search, `airdrop_link:manage` for claim links). Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 * A scoped token for the card reads. Card rows need `payout:account:read`; cardholder names also need `company:authorized_user:read`. Omitted, the viewer's same-origin session is used, which only answers same-origin.
 	 */
 	accessToken?: string;
+}
+
+/**
+ * Consumer props for the "cards" sub-controller's "cards" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface CardsElementProps {
 	/**
-	 * Off, only the team/other-account list shows — no search box. For a host that knows the viewer lacks `member:basic:read`.
-	 * @default true
+	 * A scoped token for the privileged read and verification start — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
 	 */
-	canSearchRecipients?: boolean;
+	accessToken?: string;
 	/**
-	 * Off, the "Send via link" row is hidden. For a host that knows the viewer lacks `airdrop_link:manage`.
+	 * Off, the element fetches nothing and keeps the title and "+" button visible with an empty body — for a host that only wants to fetch once some precondition (card issuing being active for this account, say) is true.
 	 * @default true
 	 */
-	canCreateLink?: boolean;
+	enabled?: boolean;
 	/**
-	 * Skip the picker and open straight onto this recipient's amount screen — for a "pay this person" action row. No back button is shown in that case, matching there being no picker behind it.
+	 * Cap the rows shown, most recently issued first. `null` shows every active card.
 	 * @default null
 	 */
-	initialRecipient?: SendRecipient | null;
+	limit?: number | null;
 	/**
-	 * Preselect a currency in the amount screen's picker. Falls back to `currency`, then USD.
-	 * @default ""
+	 * Render the title as plain, unclickable text instead of a click target. Off by default, in which case clicking the title emits `viewAllSelected` for you to route to the full cards list — the element never navigates.
+	 * @default false
 	 */
-	initialCurrency?: string;
+	disableRedirect?: boolean;
+	/**
+	 * Hide the "+" button. Off by default, in which case clicking it emits `addCardRequested`.
+	 * @default false
+	 */
+	hideAddButton?: boolean;
 }
 
 /**
- * The live handle for a mounted "send" element. Returned by `create("send")`; in React, the component's `ref`.
- * @see https://docs.whop.com/elements/latest/wallet/send
+ * The live handle for a mounted "cards" element. Returned by the "cards" sub handle's `create("cards")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface SendElementHandle {
+export interface CardsElementHandle {
 	/**
-	 * Re-fetch the account's balances and recipient list. Call it after anything on your side changes what it can offer.
+	 * Re-fetch the account's cards. Call it after a mutation made elsewhere (rename, freeze, cancel, a new card) so the list reflects it without waiting for the cache to expire.
 	 */
 	refresh: () => Promise<void>;
 	/**
@@ -690,59 +2185,54 @@ export interface SendElementHandle {
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update: (options: Partial<SendElementProps>) => void;
+	update: (options: Partial<CardsElementProps>) => void;
 }
 
 /**
- * Options for `create("send")`: the consumer props plus event callbacks and lifecycle hooks.
- * @example
- * ```ts
- * const send = wallet.create("send", {}); // this interface: props + on<Event> callbacks
- * send.mount("#wallet-send");
- * ```
- * @see https://docs.whop.com/elements/latest/wallet/send
+ * Options for the "cards" sub handle's `create("cards")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface SendElementCreateOptions {
+export interface CardsElementCreateOptions {
 	/**
-	 * A scoped token for the privileged read/write — needs `payout:withdraw_funds` (plus `company:authorized_user:read` and `member:basic:read` for recipient search, `airdrop_link:manage` for claim links). Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 * A scoped token for the privileged read and verification start — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * Off, only the team/other-account list shows — no search box. For a host that knows the viewer lacks `member:basic:read`.
+	 * Off, the element fetches nothing and keeps the title and "+" button visible with an empty body — for a host that only wants to fetch once some precondition (card issuing being active for this account, say) is true.
 	 * @default true
 	 */
-	canSearchRecipients?: boolean;
+	enabled?: boolean;
 	/**
-	 * Off, the "Send via link" row is hidden. For a host that knows the viewer lacks `airdrop_link:manage`.
-	 * @default true
+	 * Cap the rows shown, most recently issued first. `null` shows every active card.
+	 * @default null
 	 */
-	canCreateLink?: boolean;
+	limit?: number | null;
 	/**
-	 * Skip the picker and open straight onto this recipient's amount screen — for a "pay this person" action row. No back button is shown in that case, matching there being no picker behind it.
-	 * @default null
+	 * Render the title as plain, unclickable text instead of a click target. Off by default, in which case clicking the title emits `viewAllSelected` for you to route to the full cards list — the element never navigates.
+	 * @default false
 	 */
-	initialRecipient?: SendRecipient | null;
+	disableRedirect?: boolean;
 	/**
-	 * Preselect a currency in the amount screen's picker. Falls back to `currency`, then USD.
-	 * @default ""
+	 * Hide the "+" button. Off by default, in which case clicking it emits `addCardRequested`.
+	 * @default false
 	 */
-	initialCurrency?: string;
+	hideAddButton?: boolean;
 	/**
-	 * The visible screen changed.
+	 * A card row was clicked. Open your own card details for it — the element never navigates.
 	 */
-	onStepChanged?: ((payload: { step: "success" | "enter_amount" | "select_recipient" | "create_link" | "link_success"; }) => void);
+	onCardSelected?: ((payload: { cardId: string; }) => void);
 	/**
-	 * A transfer succeeded. Refresh anything on your side reading the account's balance or activity.
+	 * The title was clicked. Only fires when `disableRedirect` is false.
 	 */
-	onSendCompleted?: ((payload: { recipient: SendRecipient; amount: number; currency: string; }) => void);
+	onViewAllSelected?: ((payload: Record<string, never>) => void);
 	/**
-	 * A claim link was created. Refresh anything on your side reading the account's balance.
+	 * The "+" button was clicked. Only fires when `hideAddButton` is false.
 	 */
-	onLinkCreated?: ((payload: { claimUrl: string; amount: number; redeemableCount: number; }) => void);
+	onAddCardRequested?: ((payload: Record<string, never>) => void);
 	/**
-	 * The viewer clicked "Done" on a success screen — close the surface holding it.
+	 * The viewer pressed the verify button on an account with no card program. The element starts the hosted session and leaves for it itself — this fires alongside, so a host can record the trip or show its own state.
 	 */
-	onDone?: ((payload: Record<string, never>) => void);
+	onVerificationRequested?: ((payload: { accountId: string; }) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -758,66 +2248,128 @@ export interface SendElementCreateOptions {
 }
 
 /**
- * The overlay handle for "send". Returned by `createOverlay("send")`; drives the modal presentation imperatively.
- * @see https://docs.whop.com/elements/latest/wallet/send
+ * Consumer props for the "cards" sub-controller's "cardsTable" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface SendElementOverlayHandle {
+export interface CardsTableElementProps {
 	/**
-	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 * A scoped token for the privileged reads. Card rows need `payout:account:read`; cardholder names also need `company:authorized_user:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
 	 */
-	open(): void;
+	accessToken?: string;
 	/**
-	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 * Off, the element does not fetch and renders its shell with no card rows.
+	 * @default true
 	 */
-	close(): void;
+	enabled?: boolean;
+	/**
+	 * Hide the create virtual card button. Off by default.
+	 * @default false
+	 */
+	hideCreateButton?: boolean;
+	/**
+	 * Show last month's spend. Turn this off when the viewer may see cards but not account financials.
+	 * @default true
+	 */
+	showFinancials?: boolean;
+}
+
+/**
+ * The live handle for a mounted "cardsTable" element. Returned by the "cards" sub handle's `create("cardsTable")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface CardsTableElementHandle {
+	/**
+	 * Re-fetch the cards and cardholders after the host creates, freezes, cancels, or renames a card.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
 	/**
 	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
 	 */
-	destroy(): void;
+	destroy: () => void;
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update(options: Partial<SendElementProps>): void;
+	update: (options: Partial<CardsTableElementProps>) => void;
 }
 
 /**
- * Consumer props for the "cards" element. Set at create (or as `<CardsElement />` JSX props), and updatable live via `update()`.
- * @see https://docs.whop.com/elements/latest/wallet/cards
+ * Options for the "cards" sub handle's `create("cardsTable")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface CardsElementProps {
+export interface CardsTableElementCreateOptions {
 	/**
-	 * A scoped token for the privileged read and verification start — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
+	 * A scoped token for the privileged reads. Card rows need `payout:account:read`; cardholder names also need `company:authorized_user:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * Off, the element fetches nothing and keeps the title and "+" button visible with an empty body — for a host that only wants to fetch once some precondition (card issuing being active for this account, say) is true.
+	 * Off, the element does not fetch and renders its shell with no card rows.
 	 * @default true
 	 */
 	enabled?: boolean;
 	/**
-	 * Cap the rows shown, most recently issued first. `null` shows every active card.
-	 * @default null
+	 * Hide the create virtual card button. Off by default.
+	 * @default false
 	 */
-	limit?: number | null;
+	hideCreateButton?: boolean;
 	/**
-	 * Render the title as plain, unclickable text instead of a click target. Off by default, in which case clicking the title emits `viewAllSelected` for you to route to the full cards list — the element never navigates.
-	 * @default false
+	 * Show last month's spend. Turn this off when the viewer may see cards but not account financials.
+	 * @default true
 	 */
-	disableRedirect?: boolean;
+	showFinancials?: boolean;
 	/**
-	 * Hide the "+" button. Off by default, in which case clicking it emits `addCardRequested`.
-	 * @default false
+	 * A row was clicked. Open the host-owned card details experience for this card.
 	 */
-	hideAddButton?: boolean;
+	onCardSelected?: ((payload: { cardId: string; }) => void);
+	/**
+	 * The create virtual card button was clicked.
+	 */
+	onCreateCardRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
 }
 
 /**
- * The live handle for a mounted "cards" element. Returned by `create("cards")`; in React, the component's `ref`.
- * @see https://docs.whop.com/elements/latest/wallet/cards
+ * Consumer props for the "cards" sub-controller's "cardsChart" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface CardsElementHandle {
+export interface CardsChartElementProps {
 	/**
-	 * Re-fetch the account's cards. Call it after a mutation made elsewhere (rename, freeze, cancel, a new card) so the list reflects it without waiting for the cache to expire.
+	 * A scoped token for card transaction reads. Needs `payout:account:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Off, the chart performs no reads and renders an empty plot.
+	 * @default true
+	 */
+	enabled?: boolean;
+	/**
+	 * The initial reporting window: `7d`, `1m`, `3m`, `ytd`, or `1y`.
+	 * @default "1m"
+	 */
+	period?: "7d" | "1m" | "3m" | "ytd" | "1y";
+}
+
+/**
+ * The live handle for a mounted "cardsChart" element. Returned by the "cards" sub handle's `create("cardsChart")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface CardsChartElementHandle {
+	/**
+	 * Re-fetch the selected spend window.
 	 */
 	refresh: () => Promise<void>;
 	/**
@@ -831,59 +2383,36 @@ export interface CardsElementHandle {
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update: (options: Partial<CardsElementProps>) => void;
+	update: (options: Partial<CardsChartElementProps>) => void;
 }
 
 /**
- * Options for `create("cards")`: the consumer props plus event callbacks and lifecycle hooks.
- * @example
- * ```ts
- * const cards = wallet.create("cards", {}); // this interface: props + on<Event> callbacks
- * cards.mount("#wallet-cards");
- * ```
- * @see https://docs.whop.com/elements/latest/wallet/cards
+ * Options for the "cards" sub handle's `create("cardsChart")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface CardsElementCreateOptions {
+export interface CardsChartElementCreateOptions {
 	/**
-	 * A scoped token for the privileged read and verification start — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
+	 * A scoped token for card transaction reads. Needs `payout:account:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * Off, the element fetches nothing and keeps the title and "+" button visible with an empty body — for a host that only wants to fetch once some precondition (card issuing being active for this account, say) is true.
+	 * Off, the chart performs no reads and renders an empty plot.
 	 * @default true
 	 */
 	enabled?: boolean;
 	/**
-	 * Cap the rows shown, most recently issued first. `null` shows every active card.
-	 * @default null
-	 */
-	limit?: number | null;
-	/**
-	 * Render the title as plain, unclickable text instead of a click target. Off by default, in which case clicking the title emits `viewAllSelected` for you to route to the full cards list — the element never navigates.
-	 * @default false
-	 */
-	disableRedirect?: boolean;
-	/**
-	 * Hide the "+" button. Off by default, in which case clicking it emits `addCardRequested`.
-	 * @default false
-	 */
-	hideAddButton?: boolean;
-	/**
-	 * A card row was clicked. Open your own card details for it — the element never navigates.
-	 */
-	onCardSelected?: ((payload: { cardId: string; }) => void);
-	/**
-	 * The title was clicked. Only fires when `disableRedirect` is false.
+	 * The initial reporting window: `7d`, `1m`, `3m`, `ytd`, or `1y`.
+	 * @default "1m"
 	 */
-	onViewAllSelected?: ((payload: Record<string, never>) => void);
+	period?: "7d" | "1m" | "3m" | "ytd" | "1y";
 	/**
-	 * The "+" button was clicked. Only fires when `hideAddButton` is false.
+	 * The viewer selected a new reporting window. The chart has already updated itself.
 	 */
-	onAddCardRequested?: ((payload: Record<string, never>) => void);
+	onPeriodChanged?: ((payload: { period: "7d" | "1m" | "3m" | "ytd" | "1y"; }) => void);
 	/**
-	 * The viewer pressed the verify button on an account with no card program. The element starts the hosted session and leaves for it itself — this fires alongside, so a host can record the trip or show its own state.
+	 * The viewer selected or cleared a daily bar. Dates use `YYYY-MM-DD` in UTC.
 	 */
-	onVerificationRequested?: ((payload: { accountId: string; }) => void);
+	onDateSelected?: ((payload: { date: string | null; }) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -899,73 +2428,46 @@ export interface CardsElementCreateOptions {
 }
 
 /**
- * Consumer props for the "balances" sub-controller: the `create("balances")` options and the minted sub handle's `update()` payload (React: `<Balances>` props). Parent-injected props never appear here.
- * @see https://docs.whop.com/elements/latest/wallet/overview
- */
-export interface BalancesSubOptions {}
-
-/**
- * Consumer props for the "balances" sub-controller's "balance" element.
+ * Consumer props for the "cards" sub-controller's "whopCard" element.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface BalanceElementProps {
+export interface WhopCardElementProps {
 	/**
-	 * A scoped token for the reads. An account needs `company:balance:read` for the total and `stats:read` for the chart; a user's own balance needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`, and set a fresh one before it expires. Without it the reads use the viewer's own session, which only works same-origin.
-	 * @default ""
+	 * A scoped token for card access. Omitted calls carry the viewer session when same-origin. Secrets are returned only when the API authorizes the viewer.
 	 */
 	accessToken?: string;
 	/**
-	 * The time range to open on. The buttons change it from there, or set this prop again to control it yourself.
-	 * @default "1M"
-	 */
-	range?: "1D" | "1W" | "1M" | "1Y" | "ALL";
-	/**
-	 * When the account was opened, as an ISO 8601 timestamp. `ALL` starts here instead of at its five-year default, so an account older than that keeps its full history.
-	 * @default ""
-	 */
-	openedAt?: string;
-	/**
-	 * Adds the account name to the label: `Total balance · Acme` normally, and `Acme balance on Jul 9` while the viewer reads a point. Without it the label is just `Total balance`.
-	 * @default ""
-	 */
-	accountName?: string;
-	/**
-	 * The selected range on the chart, as ISO 8601 timestamps. Set it to control the selection yourself, or `null` to clear the one the viewer made. Echo back what `rangeBrushed` reports, and clearing a filter elsewhere on your page clears the selection here too.
-	 * @default null
-	 */
-	brush?: { from: string; to: string; } | null;
-	/**
-	 * A moment to mark on the chart, as an ISO 8601 timestamp — the point something else on your page is pointing at, like the row under the pointer in an activity list. It reads like the viewer hovering that point themselves, and is ignored when it falls outside the window on screen or when they are reading the chart.
+	 * Issued card ID, prefixed `icrd_`.
 	 * @default ""
 	 */
-	markedAt?: string;
+	cardId?: string;
 	/**
-	 * For a user, total their own money plus every account they own instead of their own money alone. Ignored for an account, which is a single account already.
+	 * Hide the View details and Lock card buttons. The card itself remains clickable to reveal details.
 	 * @default false
 	 */
-	includeOwnedAccounts?: boolean;
+	hideControls?: boolean;
 	/**
-	 * Hide the total and its change, leaving the chart and the range buttons.
+	 * Disable the lock control while keeping it visible. Useful when a host has temporarily frozen card actions.
 	 * @default false
 	 */
-	hideTotal?: boolean;
+	disableLock?: boolean;
 	/**
-	 * Hide the chart, leaving the total and the range buttons.
+	 * Hide the Add to Apple Wallet button. It is shown for active and locked cards by default.
 	 * @default false
 	 */
-	hideChart?: boolean;
+	hideAppleWalletButton?: boolean;
 	/**
-	 * How tall the chart is drawn, in pixels.
-	 * @default 210
+	 * Direct-mode integration option. Emits `lockRequested` without updating the card so a first-party host can retain its confirmation flow.
+	 * @default false
 	 */
-	height?: number;
+	deferLockToHost?: boolean;
 }
 
 /**
- * The live handle for a mounted "balance" element. Returned by the "balances" sub handle's `create("balance")`.
+ * The live handle for a mounted "whopCard" element. Returned by the "cards" sub handle's `create("whopCard")`.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface BalanceElementHandle {
+export interface WhopCardElementHandle {
 	/**
 	 * Mounts the element in `target` and starts loading. React components mount themselves.
 	 */
@@ -977,72 +2479,59 @@ export interface BalanceElementHandle {
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update: (options: Partial<BalanceElementProps>) => void;
+	update: (options: Partial<WhopCardElementProps>) => void;
 }
 
 /**
- * Options for the "balances" sub handle's `create("balance")`: the consumer props plus event callbacks and lifecycle hooks.
+ * Options for the "cards" sub handle's `create("whopCard")`: the consumer props plus event callbacks and lifecycle hooks.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface BalanceElementCreateOptions {
+export interface WhopCardElementCreateOptions {
 	/**
-	 * A scoped token for the reads. An account needs `company:balance:read` for the total and `stats:read` for the chart; a user's own balance needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`, and set a fresh one before it expires. Without it the reads use the viewer's own session, which only works same-origin.
-	 * @default ""
+	 * A scoped token for card access. Omitted calls carry the viewer session when same-origin. Secrets are returned only when the API authorizes the viewer.
 	 */
 	accessToken?: string;
 	/**
-	 * The time range to open on. The buttons change it from there, or set this prop again to control it yourself.
-	 * @default "1M"
-	 */
-	range?: "1D" | "1W" | "1M" | "1Y" | "ALL";
-	/**
-	 * When the account was opened, as an ISO 8601 timestamp. `ALL` starts here instead of at its five-year default, so an account older than that keeps its full history.
-	 * @default ""
-	 */
-	openedAt?: string;
-	/**
-	 * Adds the account name to the label: `Total balance · Acme` normally, and `Acme balance on Jul 9` while the viewer reads a point. Without it the label is just `Total balance`.
+	 * Issued card ID, prefixed `icrd_`.
 	 * @default ""
 	 */
-	accountName?: string;
+	cardId?: string;
 	/**
-	 * The selected range on the chart, as ISO 8601 timestamps. Set it to control the selection yourself, or `null` to clear the one the viewer made. Echo back what `rangeBrushed` reports, and clearing a filter elsewhere on your page clears the selection here too.
-	 * @default null
+	 * Hide the View details and Lock card buttons. The card itself remains clickable to reveal details.
+	 * @default false
 	 */
-	brush?: { from: string; to: string; } | null;
+	hideControls?: boolean;
 	/**
-	 * A moment to mark on the chart, as an ISO 8601 timestamp — the point something else on your page is pointing at, like the row under the pointer in an activity list. It reads like the viewer hovering that point themselves, and is ignored when it falls outside the window on screen or when they are reading the chart.
-	 * @default ""
+	 * Disable the lock control while keeping it visible. Useful when a host has temporarily frozen card actions.
+	 * @default false
 	 */
-	markedAt?: string;
+	disableLock?: boolean;
 	/**
-	 * For a user, total their own money plus every account they own instead of their own money alone. Ignored for an account, which is a single account already.
+	 * Hide the Add to Apple Wallet button. It is shown for active and locked cards by default.
 	 * @default false
 	 */
-	includeOwnedAccounts?: boolean;
+	hideAppleWalletButton?: boolean;
 	/**
-	 * Hide the total and its change, leaving the chart and the range buttons.
+	 * Direct-mode integration option. Emits `lockRequested` without updating the card so a first-party host can retain its confirmation flow.
 	 * @default false
 	 */
-	hideTotal?: boolean;
+	deferLockToHost?: boolean;
 	/**
-	 * Hide the chart, leaving the total and the range buttons.
-	 * @default false
+	 * Fires after details are revealed or hidden.
 	 */
-	hideChart?: boolean;
+	onDetailsChanged?: ((payload: { cardId: string; revealed: boolean; }) => void);
 	/**
-	 * How tall the chart is drawn, in pixels.
-	 * @default 210
+	 * Fires instead of updating when `deferLockToHost` is true.
 	 */
-	height?: number;
+	onLockRequested?: ((payload: { cardId: string; locked: boolean; }) => void);
 	/**
-	 * The visible time range changed. Mirror it if something else on your page reads the same period.
+	 * Fires after the Cards REST API successfully locks or unlocks the card.
 	 */
-	onRangeChanged?: ((payload: { range: "1D" | "1W" | "1M" | "1Y" | "ALL"; }) => void);
+	onLockChanged?: ((payload: { cardId: string; locked: boolean; }) => void);
 	/**
-	 * The viewer dragged across the chart to select a range, or cleared the selection (`null`). Gives ISO 8601 timestamps plus the range they were read in, so you can filter your own views, like an activity list or a table, to the same period.
+	 * Fires when the viewer presses Add to Apple Wallet. The host owns the resulting Apple Wallet flow.
 	 */
-	onRangeBrushed?: ((payload: { from: string; to: string; range: "1D" | "1W" | "1M" | "1Y" | "ALL"; } | null) => void);
+	onAppleWalletRequested?: ((payload: { cardId: string; }) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -1058,41 +2547,55 @@ export interface BalanceElementCreateOptions {
 }
 
 /**
- * Consumer props for the "balances" sub-controller's "list" element.
+ * Consumer props for the "cards" sub-controller's "cardTransactions" element.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface ListElementProps {
+export interface CardTransactionsElementProps {
 	/**
-	 * A scoped token for the read. An account needs `company:balance:read`; a user's holdings or owned-account list needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 * A scoped token for the reads. Rows and card labels need `payout:account:read`; cardholder names also need `company:authorized_user:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * For a user's `user_…` account, list their personal balance followed by every owned account the backend returns instead of listing the holdings inside their personal account. Ignored for an account.
-	 * @default false
+	 * Off, the table performs no reads and renders empty.
+	 * @default true
 	 */
-	includeOwnedAccounts?: boolean;
+	enabled?: boolean;
 	/**
-	 * Show each row in the currency it is held in (€4.20, 0.00000009 cbBTC) and put the dollar value underneath. Off by default, so every row is in dollars.
-	 * @default false
+	 * Restrict the table to these cards. Empty shows every card on the account.
+	 * @default []
 	 */
-	showSourceCurrency?: boolean;
+	cardIds?: string[];
 	/**
-	 * Keep the dollar value under a holding shown in its own currency. Only applies when `showSourceCurrency` is on.
-	 * @default true
+	 * Restrict the table to these cardholders. Empty shows every cardholder on the account.
+	 * @default []
 	 */
-	showUsdEquivalent?: boolean;
+	cardholderIds?: string[];
 	/**
-	 * Keep the personal row when `includeOwnedAccounts` is on. Turn it off if your app has no personal account to open.
+	 * Restrict the table to these statuses — `completed`, `pending`, `declined` or `reversed`. Anything else is ignored. Empty shows every status.
+	 * @default []
+	 */
+	statuses?: string[];
+	/**
+	 * Show the cardholder column and its filter. Off for an account whose cards all belong to one person.
 	 * @default true
 	 */
-	showPersonalAccount?: boolean;
+	showCardholders?: boolean;
+	/**
+	 * How many transactions to read per page.
+	 * @default 50
+	 */
+	pageSize?: number;
 }
 
 /**
- * The live handle for a mounted "list" element. Returned by the "balances" sub handle's `create("list")`.
+ * The live handle for a mounted "cardTransactions" element. Returned by the "cards" sub handle's `create("cardTransactions")`.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface ListElementHandle {
+export interface CardTransactionsElementHandle {
+	/**
+	 * Re-read the transactions, for a host that just changed something on the account.
+	 */
+	refresh: () => Promise<void>;
 	/**
 	 * Mounts the element in `target` and starts loading. React components mount themselves.
 	 */
@@ -1104,46 +2607,52 @@ export interface ListElementHandle {
 	/**
 	 * Merges new props into the mounted element. In React, change the component props instead.
 	 */
-	update: (options: Partial<ListElementProps>) => void;
+	update: (options: Partial<CardTransactionsElementProps>) => void;
 }
 
 /**
- * Options for the "balances" sub handle's `create("list")`: the consumer props plus event callbacks and lifecycle hooks.
+ * Options for the "cards" sub handle's `create("cardTransactions")`: the consumer props plus event callbacks and lifecycle hooks.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface ListElementCreateOptions {
+export interface CardTransactionsElementCreateOptions {
 	/**
-	 * A scoped token for the read. An account needs `company:balance:read`; a user's holdings or owned-account list needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 * A scoped token for the reads. Rows and card labels need `payout:account:read`; cardholder names also need `company:authorized_user:read`. Omitted, calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * For a user's `user_…` account, list their personal balance followed by every owned account the backend returns instead of listing the holdings inside their personal account. Ignored for an account.
-	 * @default false
+	 * Off, the table performs no reads and renders empty.
+	 * @default true
 	 */
-	includeOwnedAccounts?: boolean;
+	enabled?: boolean;
 	/**
-	 * Show each row in the currency it is held in (€4.20, 0.00000009 cbBTC) and put the dollar value underneath. Off by default, so every row is in dollars.
-	 * @default false
+	 * Restrict the table to these cards. Empty shows every card on the account.
+	 * @default []
 	 */
-	showSourceCurrency?: boolean;
+	cardIds?: string[];
 	/**
-	 * Keep the dollar value under a holding shown in its own currency. Only applies when `showSourceCurrency` is on.
-	 * @default true
+	 * Restrict the table to these cardholders. Empty shows every cardholder on the account.
+	 * @default []
 	 */
-	showUsdEquivalent?: boolean;
+	cardholderIds?: string[];
 	/**
-	 * Keep the personal row when `includeOwnedAccounts` is on. Turn it off if your app has no personal account to open.
+	 * Restrict the table to these statuses — `completed`, `pending`, `declined` or `reversed`. Anything else is ignored. Empty shows every status.
+	 * @default []
+	 */
+	statuses?: string[];
+	/**
+	 * Show the cardholder column and its filter. Off for an account whose cards all belong to one person.
 	 * @default true
 	 */
-	showPersonalAccount?: boolean;
+	showCardholders?: boolean;
 	/**
-	 * A holding row was clicked, with `includeOwnedAccounts` off. `holding` is `usd` for the combined dollar row, otherwise the holding symbol (`cbBTC`, `EUR`), and `kind` tells you which of the three it is so you can route without classifying symbols yourself. The element never navigates.
+	 * How many transactions to read per page.
+	 * @default 50
 	 */
-	onBalanceSelected?: ((payload: { holding: string; kind: "usd" | "cash" | "asset"; }) => void);
+	pageSize?: number;
 	/**
-	 * An account row was clicked, with `includeOwnedAccounts` on. `accountId` is the personal `user_…` tag or an owned `biz_…` tag, and `kind` lets you route without inspecting it. The element never navigates.
+	 * A row was pressed. Open your own detail surface in answer to this — the element never navigates.
 	 */
-	onAccountSelected?: ((payload: { accountId: string; kind: "personal" | "business"; }) => void);
+	onTransactionSelected?: ((payload: { transactionId: string; }) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -1159,24 +2668,36 @@ export interface ListElementCreateOptions {
 }
 
 /**
- * The "balances" sub-handle, minted by `handle.create("balances", …)`. Mounts the sub-controller's elements and carries its actions.
+ * The "cards" sub-handle, minted by `handle.create("cards", …)`. Mounts the sub-controller's elements and carries its actions.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface BalancesSubHandle {
+export interface CardsSubHandle {
 	/**
-	 * An account's balance and a chart of how it changed. The total and its change sit at the top, the chart below that, and the time range buttons at the bottom. The viewer can read individual points on the chart and switch the time range themselves.
+	 * Lists the account's active issued cards, most recently issued first. Needs an `accessToken`. The title and rows are click targets that emit events instead of navigating — a host wires up its own routing and card-detail UI.
 	 */
-	create(name: "balance", options?: BalanceElementCreateOptions): BalanceElementHandle;
+	create(name: "cards", options?: CardsElementCreateOptions): CardsElementHandle;
 	/**
-	 * The holdings behind an account's balance. Every currency and token gets its own row, showing its name and its value in dollars, largest first. Rows can report which one the viewer tapped, so you can open your own screen for it.
+	 * A sortable table of every issued card on an account, including cardholder, last month's spend, limit, and creation date. Rows and the create button emit events so the host owns card details and issuance flows.
 	 */
-	create(name: "list", options?: ListElementCreateOptions): ListElementHandle;
+	create(name: "cardsTable", options?: CardsTableElementCreateOptions): CardsTableElementHandle;
+	/**
+	 * A business account's card spend over time, using the same interactive bar chart as Whop's cards dashboard. The period picker changes the mounted chart and emits an event so the host can persist the selection.
+	 */
+	create(name: "cardsChart", options?: CardsChartElementCreateOptions): CardsChartElementHandle;
+	/**
+	 * Renders one issued Whop Card. The element prefetches authorized secrets immediately after it mounts with a card ID, but keeps them masked until the viewer clicks it or selects `View details`. The API remains the permission authority. Includes lock and unlock controls by default.
+	 */
+	create(name: "whopCard", options?: WhopCardElementCreateOptions): WhopCardElementHandle;
+	/**
+	 * Every card transaction on an account, as the sortable table the dashboard shows: date, merchant, amount, cashback, status, card and cardholder, with filters for status, card and cardholder. A host can seed any of those three so the table opens on a narrowed view the reader can still widen. Card and cardholder narrow the read itself; search and status narrow the rows already loaded, so the count and total describe the current view rather than the account's lifetime. Selecting a row reports it — the element never opens a drawer of its own.
+	 */
+	create(name: "cardTransactions", options?: CardTransactionsElementCreateOptions): CardTransactionsElementHandle;
 	/**
 	 * Merges new props and callbacks into the sub-controller.
 	 */
-	update(options: Partial<BalancesSubOptions>): void;
+	update(options: Partial<CardsSubOptions>): void;
 	/**
-	 * Destroys the sub-controller and its elements, then frees its exclusive slot. A later `create("balances")` starts fresh.
+	 * Destroys the sub-controller and its elements, then frees its exclusive slot. A later `create("cards")` starts fresh.
 	 */
 	destroy(): void;
 }
@@ -1186,42 +2707,70 @@ export interface BalancesSubHandle {
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
 export interface WalletHandle {
+	/**
+	 * The outstanding-action banners from Whop's balance dashboard — identity verification, deposits, tax, and the rest — in the same order the API returns them. An account with nothing outstanding renders nothing at all, so the element can sit permanently in a layout. Copy comes from the API. Pressing Verify starts a hosted identity session and leaves for it; Add money asks the Wallet controller to open deposit; every other button follows the action's own link. Needs an `accessToken`. A failed read renders nothing rather than an error — a banner should never become the loudest thing on someone else's page.
+	 */
+	create(name: "required-actions", options?: RequiredActionsElementCreateOptions): RequiredActionsElementHandle;
+	/**
+	 * The account action row from Whop's balance dashboard. Deposit, Send, Withdraw, and Convert open the Wallet controller's built-in overlays. Accept opens Whop's checkout-link creator for a business account or company creation for a personal account. Each button also emits its requested event so the embedding page can observe the action.
+	 */
+	create(name: "actions", options?: ActionsElementCreateOptions): ActionsElementHandle;
 	/**
 	 * An account's ledger activity: every movement of money in or out, newest first. The list pages as the viewer scrolls, and rows report which one was tapped instead of navigating, so you can open your own detail screen.
 	 */
 	create(name: "activity", options?: ActivityElementCreateOptions): ActivityElementHandle;
 	/**
-	 * Funds a Whop account. Renders an amount field and the account's live funding rails — crypto (a per-network deposit address with its QR) and bank transfer (the wire fields for each settlement currency) — resolved from the account ID with no credentials, so it works on any page. Cards and platform balance are opt-in: pass `savedCards`, `allowNewCard`, or `showPlatformBalance` and the element collects the amount and the choice, then emits `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` and waits for you to call `showStep({ step: 'amount' })` when your own screen is done.
+	 * A standalone detail drawer for one movement. Point it at a prefetched financial-activity row, a ledger activity ID, or a card transaction ID — a prefetched row takes precedence, otherwise the element retrieves the record itself. A card transaction opens the card receipt: merchant, amount, status, the card it was charged to, its cardholder on a company account, the settlement date, category, currency conversion and cashback.
+	 */
+	createOverlay(name: "activityDetail", options?: ActivityDetailElementCreateOptions): ActivityDetailElementOverlayHandle;
+	/**
+	 * Funds a Whop account. Renders an amount field and the account's live funding rails — crypto (a per-network deposit address with its QR) and bank transfer (the wire fields for each settlement currency). A business account's rails resolve with no credentials, so they work on any page; a personal (`user_`) account only reveals its rails to itself, so pass `accessToken` for it — omitted, the viewer's own same-origin session covers it. Cards and platform balance are opt-in: pass `savedCards`, `allowNewCard`, or `showPlatformBalance` and the element collects the amount and the choice, then emits `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` and waits for you to call `showStep({ step: 'amount' })` when your own screen is done.
 	 */
 	create(name: "deposit", options?: DepositElementCreateOptions): DepositElementHandle;
 	/**
-	 * Funds a Whop account. Renders an amount field and the account's live funding rails — crypto (a per-network deposit address with its QR) and bank transfer (the wire fields for each settlement currency) — resolved from the account ID with no credentials, so it works on any page. Cards and platform balance are opt-in: pass `savedCards`, `allowNewCard`, or `showPlatformBalance` and the element collects the amount and the choice, then emits `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` and waits for you to call `showStep({ step: 'amount' })` when your own screen is done.
+	 * Funds a Whop account. Renders an amount field and the account's live funding rails — crypto (a per-network deposit address with its QR) and bank transfer (the wire fields for each settlement currency). A business account's rails resolve with no credentials, so they work on any page; a personal (`user_`) account only reveals its rails to itself, so pass `accessToken` for it — omitted, the viewer's own same-origin session covers it. Cards and platform balance are opt-in: pass `savedCards`, `allowNewCard`, or `showPlatformBalance` and the element collects the amount and the choice, then emits `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` and waits for you to call `showStep({ step: 'amount' })` when your own screen is done.
 	 */
 	createOverlay(name: "deposit", options?: DepositElementCreateOptions): DepositElementOverlayHandle;
 	/**
-	 * Collects a payout amount and saved payout method, groups standard and instant delivery choices with live fees and arrival estimates, collects a new payout method when needed, and presents a confirmation screen before emitting the final payout request.
+	 * Converts an account's USD balance to Gold or Coinbase Wrapped Bitcoin, and back, through Whop's public swaps API. A cross-origin mount needs an `accessToken` scoped to `company:balance:read` plus `crypto_wallet:swap` or `crypto_wallet:manage`.
+	 */
+	create(name: "convert", options?: ConvertElementCreateOptions): ConvertElementHandle;
+	/**
+	 * Converts an account's USD balance to Gold or Coinbase Wrapped Bitcoin, and back, through Whop's public swaps API. A cross-origin mount needs an `accessToken` scoped to `company:balance:read` plus `crypto_wallet:swap` or `crypto_wallet:manage`.
+	 */
+	createOverlay(name: "convert", options?: ConvertElementCreateOptions): ConvertElementOverlayHandle;
+	/**
+	 * Collects a payout amount and saved payout method, groups standard and instant delivery choices with live fees and arrival estimates, and collects a new payout method when needed. When the host does not drive the flow, the element lists methods and creates the payout itself — pass `accessToken` (or rely on the viewer's same-origin session). A host that already talks to the payouts API can still supply methods, limits, and loading flags; confirming then emits `withdrawalRequested` for that host to create.
 	 */
 	create(name: "withdraw", options?: WithdrawElementCreateOptions): WithdrawElementHandle;
 	/**
-	 * Collects a payout amount and saved payout method, groups standard and instant delivery choices with live fees and arrival estimates, collects a new payout method when needed, and presents a confirmation screen before emitting the final payout request.
+	 * Collects a payout amount and saved payout method, groups standard and instant delivery choices with live fees and arrival estimates, and collects a new payout method when needed. When the host does not drive the flow, the element lists methods and creates the payout itself — pass `accessToken` (or rely on the viewer's same-origin session). A host that already talks to the payouts API can still supply methods, limits, and loading flags; confirming then emits `withdrawalRequested` for that host to create.
 	 */
 	createOverlay(name: "withdraw", options?: WithdrawElementCreateOptions): WithdrawElementOverlayHandle;
 	/**
-	 * Sends money from an account to a recipient — a user, another account, or a public claim link anyone can redeem. Renders its own recipient search resolved from the account ID with no credentials beyond the account's own token. Needs an `accessToken` scoped to `payout:withdraw_funds`; account recipient search additionally needs `company:authorized_user:read` and `member:basic:read`, and account claim links need `airdrop_link:manage` — a host without one of those scopes should turn off the matching prop rather than leave a row that will 403.
+	 * Sends money from an account to a recipient — a user, another account, or a public claim link anyone can redeem. Direct transfers use the source account's configured fiat or crypto rail. Renders its own recipient search resolved from the account ID with no credentials beyond the account's own token. Needs an `accessToken` scoped to `payout:transfer_funds` for direct transfers and `payout:withdraw_funds` for recipient lists; account recipient search additionally needs `company:authorized_user:read` and `member:basic:read`, and account claim links need `airdrop_link:manage` — a host without one of those scopes should turn off the matching prop rather than leave a row that will 403.
 	 */
 	create(name: "send", options?: SendElementCreateOptions): SendElementHandle;
 	/**
-	 * Sends money from an account to a recipient — a user, another account, or a public claim link anyone can redeem. Renders its own recipient search resolved from the account ID with no credentials beyond the account's own token. Needs an `accessToken` scoped to `payout:withdraw_funds`; account recipient search additionally needs `company:authorized_user:read` and `member:basic:read`, and account claim links need `airdrop_link:manage` — a host without one of those scopes should turn off the matching prop rather than leave a row that will 403.
+	 * Sends money from an account to a recipient — a user, another account, or a public claim link anyone can redeem. Direct transfers use the source account's configured fiat or crypto rail. Renders its own recipient search resolved from the account ID with no credentials beyond the account's own token. Needs an `accessToken` scoped to `payout:transfer_funds` for direct transfers and `payout:withdraw_funds` for recipient lists; account recipient search additionally needs `company:authorized_user:read` and `member:basic:read`, and account claim links need `airdrop_link:manage` — a host without one of those scopes should turn off the matching prop rather than leave a row that will 403.
 	 */
 	createOverlay(name: "send", options?: SendElementCreateOptions): SendElementOverlayHandle;
 	/**
-	 * Lists the account's active issued cards, most recently issued first. Needs an `accessToken`. The title and rows are click targets that emit events instead of navigating — a host wires up its own routing and card-detail UI.
+	 * One card and what has been spent on it: the card itself, what it has spent against its limit, and its latest transactions. Opens as a drawer. The card face, its reveal and its lock come from the `whopCard` element composed inside, so a host gets one surface rather than assembling three. Pressing a transaction, or asking for the full list, reports the request — the drawer never navigates.
 	 */
-	create(name: "cards", options?: CardsElementCreateOptions): CardsElementHandle;
+	createOverlay(name: "cardDetails", options?: CardDetailsElementCreateOptions): CardDetailsElementOverlayHandle;
+	/**
+	 * A banner asking the account holder to verify their identity, shown only while verification is outstanding — an account that has already verified renders nothing at all, so the element can sit permanently in a layout. The headline and body come from the API, so they track the account's actual state: an unstarted account is invited to unlock cards and payouts, one under review reads as pending, and a failed or flagged one says so. Pressing the button reports `verificationRequested` and stays put, so the host mounts its own verification — the `verifications` controller's `kyc` element, say. Needs an `accessToken`. A failed read renders nothing rather than an error — a nudge should never become the loudest thing on the page.
+	 */
+	create(name: "verification", options?: VerificationElementCreateOptions): VerificationElementHandle;
 	/**
-	 * Two views of an account's money. The balance view shows the total, a chart of how it changed, and a picker for the time range. The list view shows the holdings that make up that total, valued in dollars.
+	 * Three views of an account's money. The balance view shows the total, a chart of how it changed, and a picker for the time range. The list view shows the holdings that make up that total, valued in dollars. The breakdown view splits one currency into available, pending, reserve, and negative amounts without money-movement controls. When `openHoldingOnSelect` is on, a list row replaces this unit's canvas — the chart and the list — with that holding's balance page instead of only reporting the click.
 	 */
 	create(name: "balances", options?: BalancesSubOptions): BalancesSubHandle;
+	/**
+	 * An account's card surfaces, mounted from one place: the compact issued-card list, the full sortable roster, the spend chart, and a single revealable card. Mount the faces the page needs — they share the account and the credential this unit is minted with, so a page showing a chart above a roster wires them once.
+	 */
+	create(name: "cards", options?: CardsSubOptions): CardsSubHandle;
 	/**
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
@@ -1251,6 +2800,28 @@ export interface ActivityDateRangeOverride {
 	displayPostedBefore?: string | undefined;
 }
 
+/**
+ * Declared from the app's `Money`, referenced by a host-capability surface.
+ */
+export interface Money {
+	/**
+	 * Three-letter ISO 4217 currency code, lowercase.
+	 */
+	currency: string;
+	/**
+	 * The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
+	 */
+	amount: string;
+	/**
+	 * How many decimal places the amount CARRIES — the precision the charge itself runs at.
+	 */
+	decimals: number;
+	/**
+	 * How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
+	 */
+	display_decimals: number;
+}
+
 /**
  * Declared from the app's `LedgerActivity`, referenced by a host-capability surface.
  */
@@ -1263,11 +2834,15 @@ export interface LedgerActivity {
 	/**
 	 * The ledger line category this activity was posted under.
 	 */
-	line_type: "ad_budget_release" | "ad_campaign_budget" | "ad_publisher_payout" | "ad_publisher_payout_received" | "ad_spend_charge" | "affiliate_fee" | "airdrop" | "airdrop_link_created" | "airdrop_link_redeemed" | "airdrop_link_returned" | "airdrop_reversal" | "application_fee" | "application_fee_payout" | "bank_transfer" | "billing_percentage_fee" | "buyer_fee" | "card_spend_authorization" | "card_spend_authorization_void" | "card_spend_refund" | "company_referral" | "cross_border_percentage_fee" | "currency_conversion_incoming" | "currency_conversion_outgoing" | "dispute_alert_fee" | "dispute_hold_adjustment" | "dispute_representment_fee" | "fraud_prevention_fee" | "fx_percentage_fee" | "high_risk_merchant_fee" | "installment_default" | "internal_balance_transfer_incoming" | "internal_balance_transfer_outgoing" | "internal_withdrawal" | "internal_withdrawal_reversal" | "legacy_crypto_payment" | "legacy_payment" | "legacy_payment_refund" | "license_sale" | "license_sale_commission" | "license_sale_revenue" | "misc_purchase" | "misc_refund" | "misc_reversal" | "onchain_deposit" | "onchain_swap_target" | "onchain_wallet_transfer_incoming" | "onchain_wallet_transfer_outgoing" | "orchestration_percentage_fee" | "passthrough_gmv" | "payment_dispute" | "payment_dispute_adjustment" | "payment_dispute_fee" | "payment_dispute_reversal" | "payment_gross" | "payment_gross_reversal" | "payment_processing_fixed_fee" | "payment_processing_percentage_fee" | "payment_referral" | "payment_referral_reversal" | "payment_refund" | "payment_refund_reversal" | "payment_revshare" | "payment_revshare_payout" | "payment_revshare_refund" | "payment_revshare_reversal" | "payout_fee" | "platform_affiliate_payment" | "platform_affiliate_payment_reversal" | "platform_balance_payment" | "platform_balance_payment_refund" | "platform_balance_transfer_incoming" | "platform_balance_transfer_outgoing" | "platform_covered_dispute" | "promo_reversal" | "referral_bonus" | "resolution_center_refund" | "revshare_percentage_fee" | "sales_tax_fee" | "sales_tax_remittance" | "sales_tax_remittance_reversal" | "software_rental_revshare" | "software_rental_transaction" | "stripe_domestic_processing_fee" | "stripe_international_processing_fee" | "three_ds_fixed_fee" | "topup" | "topup_fee" | "topup_reversal" | "treasury_payin" | "whop_processing_fee" | "withdrawal" | "withdrawal_clawback" | "withdrawal_clawback_reversal" | "withdrawal_reclassification" | "withdrawal_reversal";
+	line_type: "platform_balance_transfer_outgoing" | "payment_gross" | "withdrawal" | "topup" | "payment_dispute" | "payment_revshare" | "card_spend_authorization" | "airdrop" | "onchain_swap_target" | "payment_gross_reversal" | "payment_refund" | "payment_refund_reversal" | "payment_dispute_reversal" | "payment_dispute_adjustment" | "dispute_hold_adjustment" | "topup_reversal" | "platform_balance_payment" | "platform_balance_payment_refund" | "platform_balance_transfer_incoming" | "internal_balance_transfer_incoming" | "internal_balance_transfer_outgoing" | "onchain_wallet_transfer_incoming" | "onchain_wallet_transfer_outgoing" | "withdrawal_reversal" | "withdrawal_clawback" | "withdrawal_clawback_reversal" | "payment_revshare_refund" | "payment_revshare_reversal" | "payment_referral" | "payment_referral_reversal" | "application_fee_payout" | "airdrop_reversal" | "airdrop_link_created" | "airdrop_link_returned" | "card_spend_authorization_void" | "card_spend_refund" | "onchain_deposit" | "bank_transfer" | "currency_conversion_outgoing" | "currency_conversion_incoming" | "airdrop_link_redeemed" | "resolution_center_refund" | "withdrawal_reclassification" | "payment_revshare_payout" | "platform_affiliate_payment" | "platform_affiliate_payment_reversal" | "onboarding_reward" | "platform_covered_dispute" | "treasury_payin" | "passthrough_gmv" | "promo_reversal" | "misc_reversal" | "ad_spend_charge" | "ad_campaign_budget" | "ad_budget_release" | "ad_publisher_payout" | "ad_publisher_payout_received" | "affiliate_fee" | "application_fee" | "billing_percentage_fee" | "buyer_fee" | "cross_border_percentage_fee" | "dispute_alert_fee" | "fraud_prevention_fee" | "fx_percentage_fee" | "high_risk_merchant_fee" | "orchestration_percentage_fee" | "payment_dispute_fee" | "payment_processing_fixed_fee" | "payment_processing_percentage_fee" | "payout_fee" | "revshare_percentage_fee" | "sales_tax_fee" | "sales_tax_remittance" | "sales_tax_remittance_reversal" | "stripe_domestic_processing_fee" | "stripe_international_processing_fee" | "three_ds_fixed_fee" | "whop_processing_fee" | "balance_reservation" | "balance_reservation_reversal" | "card_interchange" | "card_load_deposit" | "card_load_transfer" | "card_unload_deposit" | "card_unload_transfer" | "company_referral" | "connected_account_negative_balance" | "dispute_representment_fee" | "external_card_load_deposit" | "installment_default" | "internal_withdrawal" | "internal_withdrawal_complete" | "internal_withdrawal_fee" | "internal_withdrawal_fee_reversal" | "internal_withdrawal_in_transit" | "internal_withdrawal_in_transit_reversal" | "internal_withdrawal_markup_fee" | "internal_withdrawal_markup_fee_payout" | "internal_withdrawal_markup_fee_payout_reversal" | "internal_withdrawal_markup_fee_reversal" | "internal_withdrawal_reversal" | "legacy_crypto_payment" | "legacy_payment" | "legacy_payment_refund" | "license_sale" | "license_sale_commission" | "license_sale_revenue" | "marketplace_affiliate_fee" | "misc_purchase" | "misc_refund" | "onchain_swap_source" | "onchain_withdrawal" | "payment_referral_refund" | "platform_balance_transfer_fee" | "platform_earning" | "referral_bonus" | "software_rental_revshare" | "software_rental_transaction" | "swap_fee" | "topup_fee" | "withdrawal_fee" | "withdrawal_fee_reversal" | "withdrawal_markup_fee" | "withdrawal_markup_fee_payout" | "withdrawal_markup_fee_payout_reversal" | "withdrawal_markup_fee_reversal" | "withdrawal_topup_adjustment" | "deposit" | "wallet_transfer_incoming" | "wallet_transfer_outgoing" | "swap_source" | "swap_target";
 	/**
 	 * Signed amount in the currency's smallest precision units.
 	 */
 	amount: string;
+	/**
+	 * Dollar value of this movement as a decimal string, signed like `amount`. Converted from the posted amount at the rate that was live when the line posted — the same pricing the wallet balance chart and the financial reports use — so a crypto row carries its dollar value too. `null` for a currency Whop holds no exchange rate for.
+	 */
+	usd_amount: string | null;
 	/**
 	 * Currency for this ledger activity.
 	 */
@@ -1277,13 +2852,9 @@ export interface LedgerActivity {
 	 */
 	posted_at: string;
 	/**
-	 * ISO 8601 timestamp these funds became (or are scheduled to become) withdrawable: the posted time for already-settled funds, or 00:00:00 UTC on the scheduled release date for pending funds. Present only on inflows entering the balance (payments, top-ups, incoming transfers/affiliate); null on withdrawals, refunds, disputes and on-chain rows. The available_after/before filters window on its UTC settlement date.
+	 * ISO 8601 timestamp these funds became (or are scheduled to become) withdrawable: the posted time for already-settled funds, or 00:00:00 UTC on the scheduled release date for pending funds. Present only on inflows entering the balance (payments, top-ups, incoming transfers/affiliate); null on payouts, refunds, disputes and on-chain rows. The available_after/before filters window on its UTC settlement date.
 	 */
 	available_at: string | null;
-	/**
-	 * When the activity record was created.
-	 */
-	created_at: string | null;
 	/**
 	 * Resource associated with this ledger activity.
 	 */
@@ -1291,7 +2862,43 @@ export interface LedgerActivity {
 	/**
 	 * Source of this ledger activity.
 	 */
-	source: { object: string; id: string; status?: string | null | undefined; reason?: string | null | undefined; claim_url?: string | null | undefined; amount_float?: number | null | undefined; created_at?: string | null | undefined; estimated_arrival?: string | null | undefined; payer_name?: string | null | undefined; payout_token_nickname?: string | null | undefined; tx_hash?: string | null | undefined; sender_address?: string | null | undefined; chain?: string | null | undefined; from_amount?: string | null | undefined; from_currency?: string | null | undefined; to_amount?: string | null | undefined; to_currency?: string | null | undefined; payout_destination?: { payer_name?: string | null | undefined; icon_url?: string | null | undefined; } | null | undefined; [key: string]: unknown; } | null;
+	source: { object: string; id: string; status?: string | null | undefined; payment_amount?: Money | null | undefined; payment_method_type?: string | null | undefined; payment_processor?: string | null | undefined; card_brand?: string | null | undefined; reason?: string | null | undefined; notes?: string | null | undefined; risk_review_hold?: boolean | null | undefined; claim_url?: string | null | undefined; amount_float?: number | null | undefined; created_at?: string | null | undefined; estimated_arrival?: string | null | undefined; payer_name?: string | null | undefined; payout_token_nickname?: string | null | undefined; tx_hash?: string | null | undefined; sender_address?: string | null | undefined; chain?: string | null | undefined; from_amount?: string | null | undefined; from_currency?: string | null | undefined; to_amount?: string | null | undefined; to_currency?: string | null | undefined; payout_destination?: { payer_name?: string | null | undefined; icon_url?: string | null | undefined; } | null | undefined; [key: string]: unknown; } | null;
+	/**
+	 * Payment related to this ledger activity. Included when rich resource hydration is enabled and the movement is tied to a payment.
+	 */
+	payment?: { object: "payment"; id: string; amount: Money | null; payment_method_type: string | null; payment_processor: string | null; card_brand: string | null; card_last4: string | null; user: { id: string; name: string; email: string | null; } | null; product: { id: string; name: string; } | null; plan: { id: string; name: string | null; } | null; created_at: string; } | null | undefined;
+	/**
+	 * Payment ID for any payment-related activity, including refunds and disputes.
+	 */
+	payment_id?: string | null | undefined;
+	/**
+	 * ID of the customer associated with the payment.
+	 */
+	user_id?: string | null | undefined;
+	/**
+	 * Display name of the customer associated with the payment.
+	 */
+	user_name?: string | null | undefined;
+	/**
+	 * Email of the customer associated with the payment. Requires member:email:read.
+	 */
+	user_email?: string | null | undefined;
+	/**
+	 * ID of the product associated with the payment, when applicable.
+	 */
+	product_id?: string | null | undefined;
+	/**
+	 * Name of the product associated with the payment, when applicable.
+	 */
+	product_name?: string | null | undefined;
+	/**
+	 * ID of the plan associated with the payment, when applicable.
+	 */
+	plan_id?: string | null | undefined;
+	/**
+	 * Name of the plan associated with the payment, when applicable.
+	 */
+	plan_name?: string | null | undefined;
 	/**
 	 * The viewer account that owns this row's ledger. Present only when the response aggregates owned accounts (include_owned_accounts=true); omitted otherwise.
 	 */
@@ -1363,6 +2970,7 @@ export interface WithdrawalQuote {
 	exchangeRate: number;
 	minLimit: number;
 	maxLimit?: number | null | undefined;
+	instantUnavailableReason?: "minimum_crypto_sales_not_met" | null | undefined;
 	standard?: WithdrawalQuoteSpeed | null | undefined;
 	instant?: WithdrawalQuoteSpeed | null | undefined;
 }
@@ -1372,12 +2980,14 @@ export interface WithdrawalQuote {
  */
 export interface WithdrawalMethod {
 	id: string;
+	createdAt?: string | null | undefined;
 	nickname?: string | null | undefined;
 	accountReference?: string | null | undefined;
 	payerName?: string | null | undefined;
 	destinationCurrency: string;
 	isDefault: boolean;
 	iconUrl?: string | null | undefined;
+	name?: string | null | undefined;
 	deliveryType: string;
 	supportsStandard: boolean;
 	supportsInstant: boolean;
@@ -1422,8 +3032,50 @@ export interface WithdrawalSupportedMethod {
  * Declared from the app's `WithdrawalLimits`, referenced by a host-capability surface.
  */
 export interface WithdrawalLimits {
-	standard: { maxAmount: number; errorMessage?: string | null | undefined; };
-	instant: { maxAmount: number; dailyAmountRemaining?: number | null | undefined; errorMessage?: string | null | undefined; };
+	standard: { maxAmount: number; errorCode?: string | null | undefined; errorMessage?: string | null | undefined; };
+	instant: { maxAmount: number; dailyAmountRemaining?: number | null | undefined; errorCode?: string | null | undefined; errorMessage?: string | null | undefined; };
+}
+
+/**
+ * Declared from the app's `WithdrawalMoney`, referenced by a host-capability surface.
+ */
+export interface WithdrawalMoney {
+	currency: string;
+	amount: string;
+	decimals: number;
+	display_decimals: number;
+}
+
+/**
+ * Declared from the app's `WithdrawalPayoutQuote`, referenced by a host-capability surface.
+ */
+export interface WithdrawalPayoutQuote {
+	requestId: string;
+	payoutMethodId: string;
+	speed: "standard" | "instant";
+	id: string;
+	amount: WithdrawalMoney;
+	fee: WithdrawalMoney;
+	netAmount: WithdrawalMoney;
+	destinationAmount: WithdrawalMoney;
+	exchangeRate: number;
+	expiresAt: string;
+	quoteToken: string;
+}
+
+/**
+ * Declared from the app's `WithdrawalRequest`, referenced by a host-capability surface.
+ */
+export interface WithdrawalRequest {
+	amount: number;
+	currency: string;
+	payoutMethodId: string;
+	presentedFee: number;
+	quoteId?: string | undefined;
+	quoteToken?: string | undefined;
+	speed: "standard" | "instant";
+	notes?: string | undefined;
+	acknowledgeBankWarning?: boolean | undefined;
 }
 
 /**
@@ -1438,16 +3090,14 @@ export interface WithdrawalCreateMethodInput {
 }
 
 /**
- * Declared from the app's `WithdrawalRequest`, referenced by a host-capability surface.
+ * Declared from the app's `WithdrawalPayoutQuoteRequest`, referenced by a host-capability surface.
  */
-export interface WithdrawalRequest {
+export interface WithdrawalPayoutQuoteRequest {
+	requestId: string;
 	amount: number;
 	currency: string;
 	payoutMethodId: string;
-	presentedFee: number;
 	speed: "standard" | "instant";
-	notes?: string | undefined;
-	acknowledgeBankWarning?: boolean | undefined;
 }
 
 /**
@@ -1460,3 +3110,34 @@ export interface SendRecipient {
 	profilePicUrl: string | null;
 	kind: "business" | "user" | "email";
 }
+
+/**
+ * The billing address.
+ * Declared from the app's `Billing`, referenced by a host-capability surface.
+ */
+export interface Billing {
+	/**
+	 * Billing city.
+	 */
+	city: string | null;
+	/**
+	 * Billing country code.
+	 */
+	country_code: string | null;
+	/**
+	 * Street address line 1.
+	 */
+	line1: string | null;
+	/**
+	 * Street address line 2.
+	 */
+	line2: string | null;
+	/**
+	 * Billing postal code.
+	 */
+	postal_code: string | null;
+	/**
+	 * Billing region or state.
+	 */
+	region: string | null;
+}