> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# ActivityElement

> L'activité du registre d'un compte : chaque mouvement d'argent entrant ou sortant, du plus récent au plus ancien. La liste se pagine au fil du défilement de l'utilisateur, et les lignes signalent laquelle a été touchée au lieu de naviguer, afin que vous puissiez ouvrir votre propre écran de détail.

> [!NOTE]
>
> Cette page documente `@whop/elements@1.10.0` et `@whop/elements-react@1.10.0`.

*Depuis `v1.0.0`.*

Se monte à l'intérieur de [`Wallet`](https://docs.whop.com/fr/elements/latest/wallet/overview). `accountId` et `accessToken` en proviennent. Transmettez les props et les callbacks via les options de création ou les props React. Conservez le handle créé, ou la `ref` React, pour appeler `refresh()` et `setDateRange()`.

Se monte n'importe où dans votre hiérarchie de vues. Prend un `accountId` et charge ses propres données ; transmettez aussi une closure et vous recevrez la ligne touchée par l'utilisateur.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <ActivityElement onActivitySelected={(e) => console.log(e)} onActivityHovered={(e) => console.log(e)} onSeeAllRequested={(e) => console.log(e)} onDateRangeChanged={(e) => console.log(e)} />
      </Wallet>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const wallet = window.WhopElements().wallet.create({ /* options */ });
  wallet.create('activity', {
    onActivitySelected: (e) => console.log(e),
    onActivityHovered: (e) => console.log(e),
    onSeeAllRequested: (e) => console.log(e),
    onDateRangeChanged: (e) => console.log(e)
  }).mount('#wallet-activity');
</script>
```

```swift Swift theme={null}
import SwiftUI
import WhopElements

// WhopSDK.configure(tokenProvider:) runs once at app launch. See Getting started.
struct ActivityScreen: View {
    var body: some View {
        ScrollView {
            ActivityElement(
                accountId: "biz_xxxx"
            ) { activity in
                print(activity.title, activity.amount)
            }
            .padding()
        }
    }
}
```

Données d'exemple. [Ouvrir le Playground](https://docs.whop.com/fr/elements/latest/wallet/overview#playground).

[ActivityElement exécuté sur un simulateur iPhone](https://app.revyl.ai/embed/7289cae9-8eaf-4d14-a771-fb05c879c6c5?controls=0)

## Props

**currency** `string`

N'affiche que l'activité dans cette devise. Sans elle, l'activité de toutes les devises est affichée.

**accessToken** `string`

Un jeton à portée limitée pour la lecture. Un compte nécessite `company:balance:read`, et un utilisateur `user:balance:read`. Générez-le sur votre serveur avec `POST /api/v1/access_tokens`. Sans lui, la lecture utilise la propre session de l'utilisateur, qui ne fonctionne qu'en same-origin.

**maxItems** `number`

Affiche au maximum ce nombre de lignes et arrête la pagination, pour un aperçu de l'activité récente. La liste gagne une commande See all activity qui signale `seeAllRequested` au lieu de naviguer.

**canOpenCardTransactionDetails** `boolean`

Lorsqu'il est désactivé, les lignes de transactions par carte s'affichent inertes (ni clic, ni survol) au lieu de déclencher `activitySelected`. Utilisez-le lorsque vous savez que l'utilisateur n'est pas autorisé à voir ces détails. Par défaut : `true`.

**defaultLineTypes** `string[]`

Types d'activité sélectionnés lorsque l'élément est monté ou que son compte change. L'utilisateur peut les modifier avec les filtres intégrés. Par défaut : `[]`.

**valeurs**

Chaque élément est l'une des valeurs `"withdrawal"`, `"ad_affiliate_payout_received"`, `"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"`, `"billing_percentage_fee"`, `"buyer_fee"`, `"card_spend_authorization"`, `"card_spend_authorization_void"`, `"card_spend_refund"`, `"cashback"`, `"cross_border_percentage_fee"`, `"currency_conversion_incoming"`, `"currency_conversion_outgoing"`, `"dispute_alert_fee"`, `"dispute_hold_adjustment"`, `"economic_intelligence_percentage_fee"`, `"fraud_prevention_fee"`, `"fx_percentage_fee"`, `"high_risk_merchant_fee"`, `"internal_balance_transfer_incoming"`, `"internal_balance_transfer_outgoing"`, `"levels_rebate"`, `"misc_reversal"`, `"onboarding_reward"`, `"onchain_deposit"`, `"onchain_internal_transfer_incoming"`, `"onchain_internal_transfer_outgoing"`, `"onchain_swap_target"`, `"onchain_wallet_transfer_incoming"`, `"onchain_wallet_transfer_outgoing"`, `"orchestration_percentage_fee"`, `"partner_grant_reward"`, `"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_refund"`, `"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"`, `"platform_credits_granted"`, `"platform_credits_payment"`, `"platform_credits_payment_refund"`, `"platform_markup_fee"`, `"platform_markup_fee_payout"`, `"promo_reversal"`, `"resolution_center_refund"`, `"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"`, `"topup"`, `"topup_reversal"`, `"treasury_payin"`, `"whop_processing_fee"`, `"withdrawal_clawback"`, `"withdrawal_clawback_reversal"`, `"withdrawal_reclassification"` ou `"withdrawal_reversal"`.

**hideFilters** `boolean`

Masque les puces de filtre, pour une liste compacte que l'utilisateur ne filtre pas. Par défaut : `false`.

## Événements

Transmettez les callbacks dans les options de création ou dans les props React.

### `onActivitySelected`

Une ligne a été cliquée. Ouvrez votre propre vue ou route de détail pour celle-ci ; l'élément ne navigue jamais.

**payload** `object`

**propriétés**

**activity** `LedgerActivity` *required*

**propriétés**

**object** `"ledger_activity"` *required*

**id** `string` *required*

ID de l'activité du registre.

**line\_type** `string` *required*

La catégorie de ligne du registre sous laquelle cette activité a été comptabilisée.

**valeurs**

L'une des valeurs `"withdrawal"`, `"accelerated_settlement_fee"`, `"account_settlement"`, `"ad_affiliate_payout"`, `"ad_affiliate_payout_received"`, `"ad_balance_funding_receipt"`, `"ad_budget_release"`, `"ad_campaign_budget"`, `"ad_funding_disbursement"`, `"ad_income_expense"`, `"ad_income_receipt"`, `"ad_network_cost"`, `"ad_network_settlement"`, `"ad_publisher_payout"`, `"ad_publisher_payout_received"`, `"ad_spend_charge"`, `"ad_spend_margin"`, `"ad_spend_purchase"`, `"ads_card_spread"`, `"affiliate_fee"`, `"aggregated_fee"`, `"airdrop"`, `"airdrop_expense"`, `"airdrop_expense_reversal"`, `"airdrop_link_canceled"`, `"airdrop_link_claimed"`, `"airdrop_link_created"`, `"airdrop_link_funded"`, `"airdrop_link_redeemed"`, `"airdrop_link_returned"`, `"airdrop_reversal"`, `"application_fee"`, `"application_fee_payable"`, `"application_fee_payout"`, `"bad_debt_expense"`, `"bad_debt_offset"`, `"balance_reservation"`, `"balance_reservation_hold"`, `"balance_reservation_release"`, `"balance_reservation_reversal"`, `"billing_percentage_fee"`, `"buyer_fee"`, `"card_interchange"`, `"card_interchange_receivable"`, `"card_load_deposit"`, `"card_load_transfer"`, `"card_spend_authorization"`, `"card_spend_authorization_hold"`, `"card_spend_authorization_void"`, `"card_spend_authorization_void_release"`, `"card_spend_capture"`, `"card_spend_capture_offset"`, `"card_spend_refund"`, `"card_spend_refund_offset"`, `"card_unload_deposit"`, `"card_unload_transfer"`, `"cashback"`, `"cashback_expense"`, `"cashback_funding"`, `"clawback_fee"`, `"clawback_receivable"`, `"clawback_receivable_reversal"`, `"clawback_receivable_settlement"`, `"clawback_receivable_settlement_reversal"`, `"company_referral"`, `"connected_account_clawback"`, `"connected_account_negative_balance"`, `"cross_border_percentage_fee"`, `"currency_conversion_incoming"`, `"currency_conversion_outgoing"`, `"dispute_alert_fee"`, `"dispute_hold_adjustment"`, `"dispute_hold_blocked"`, `"dispute_management_fee"`, `"dispute_payable_clearing"`, `"dispute_payable_reversal"`, `"dispute_representment_fee"`, `"dispute_settlement"`, `"dispute_settlement_reversal"`, `"dispute_unreconciled_clearing"`, `"dispute_unreconciled_reversal"`, `"economic_intelligence_percentage_fee"`, `"external_account_connection_fee"`, `"external_card_load_deposit"`, `"external_card_load_offset"`, `"fraud_prevention_fee"`, `"fx_gain_loss"`, `"fx_markup"`, `"fx_percentage_fee"`, `"fx_settlement_gain_loss"`, `"high_risk_merchant_fee"`, `"identity_verification_fee"`, `"installment_default"`, `"internal_balance_transfer_incoming"`, `"internal_balance_transfer_outgoing"`, `"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_payable"`, `"internal_withdrawal_payable_reversal"`, `"internal_withdrawal_reversal"`, `"legacy_crypto_payment"`, `"legacy_payment"`, `"legacy_payment_refund"`, `"levels_points_ads"`, `"levels_points_burned"`, `"levels_points_card"`, `"levels_points_issued"`, `"levels_points_partner"`, `"levels_points_trading"`, `"levels_rebate"`, `"license_sale"`, `"license_sale_commission"`, `"license_sale_revenue"`, `"marketing_expense"`, `"marketplace_affiliate_fee"`, `"misc_purchase"`, `"misc_refund"`, `"misc_reversal"`, `"onboarding_reward"`, `"onchain_deposit"`, `"onchain_deposit_offset"`, `"onchain_internal_transfer_incoming"`, `"onchain_internal_transfer_outgoing"`, `"onchain_platform_transfer_incoming"`, `"onchain_platform_transfer_outgoing"`, `"onchain_swap_offset"`, `"onchain_swap_source"`, `"onchain_swap_target"`, `"onchain_wallet_transfer_incoming"`, `"onchain_wallet_transfer_outgoing"`, `"onchain_withdrawal"`, `"onchain_withdrawal_offset"`, `"orchestration_percentage_fee"`, `"partner_grant_reward"`, `"passthrough_gmv"`, `"passthrough_gmv_offset"`, `"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_receivable_clearing"`, `"payment_receivable_reversal"`, `"payment_receivable_settlement"`, `"payment_referral"`, `"payment_referral_payable"`, `"payment_referral_refund"`, `"payment_referral_reversal"`, `"payment_refund"`, `"payment_refund_fee"`, `"payment_refund_reversal"`, `"payment_return_fee"`, `"payment_revshare"`, `"payment_revshare_payout"`, `"payment_revshare_refund"`, `"payment_revshare_reversal"`, `"payment_unreconciled_clearing"`, `"payment_unreconciled_reversal"`, `"payout_fee"`, `"payout_receivable"`, `"payout_subsidy"`, `"payout_unreconciled_clearing"`, `"platform_affiliate_payment"`, `"platform_affiliate_payment_reversal"`, `"platform_balance_payment"`, `"platform_balance_payment_refund"`, `"platform_balance_transfer_fee"`, `"platform_balance_transfer_incoming"`, `"platform_balance_transfer_outgoing"`, `"platform_covered_dispute"`, `"platform_credits_granted"`, `"platform_credits_payment"`, `"platform_credits_payment_refund"`, `"platform_earning"`, `"platform_earning_settlement"`, `"platform_earning_unreconciled_clearing"`, `"platform_markup_fee"`, `"platform_markup_fee_payout"`, `"promo_reversal"`, `"psp_accelerated_settlement_fee"`, `"psp_account_debit"`, `"psp_account_updater_fee"`, `"psp_adjusted_processing_fee"`, `"psp_authentication_fee"`, `"psp_bank_pull_clearing"`, `"psp_bank_pull_settlement"`, `"psp_billing_fee"`, `"psp_clawback_fee"`, `"psp_clawback_settlement"`, `"psp_clawback_settlement_reversal"`, `"psp_collection_settlement"`, `"psp_commission_fee"`, `"psp_connect_fee"`, `"psp_correction"`, `"psp_currency_conversion_incoming"`, `"psp_currency_conversion_outgoing"`, `"psp_currency_conversion_receivable"`, `"psp_currency_conversion_receivable_clearing"`, `"psp_dispute_alert_fee"`, `"psp_dispute_fee"`, `"psp_dispute_management_fee"`, `"psp_dispute_payable"`, `"psp_external_account_connection_fee"`, `"psp_fixed_fee"`, `"psp_fx_adjustment"`, `"psp_gateway_fee"`, `"psp_identity_verification_fee"`, `"psp_interchange_fee"`, `"psp_invoice_tax_fee"`, `"psp_invoicing_fee"`, `"psp_markup_fee"`, `"psp_network_token_fee"`, `"psp_optimization_fee"`, `"psp_payin_clearing"`, `"psp_payin_settlement"`, `"psp_payment_method_fee"`, `"psp_payment_receivable"`, `"psp_payout_consolidation"`, `"psp_payout_deposit"`, `"psp_payout_fee"`, `"psp_payout_receivable"`, `"psp_payout_receivable_clearing"`, `"psp_payout_settlement"`, `"psp_payout_settlement_reversal"`, `"psp_pool_clearing"`, `"psp_pool_dispute_settlement"`, `"psp_pool_refund_clearing"`, `"psp_pool_refund_settlement"`, `"psp_pool_settlement"`, `"psp_processing_fee"`, `"psp_receivable_pooled"`, `"psp_recipient_wallet_load"`, `"psp_refund_fee"`, `"psp_refund_payable"`, `"psp_reserve_hold"`, `"psp_reserve_release"`, `"psp_risk_fee"`, `"psp_scheme_fee"`, `"psp_service_fee"`, `"psp_tax_filing_fee"`, `"psp_tax_service_fee"`, `"psp_terminal_fee"`, `"psp_transfer_settlement"`, `"psp_transfer_settlement_reversal"`, `"psp_treasury_fee"`, `"psp_variable_fee"`, `"psp_withholding_tax"`, `"recipient_wallet_load"`, `"referral_bonus"`, `"refund_payable_clearing"`, `"refund_payable_reversal"`, `"refund_settlement"`, `"refund_settlement_reversal"`, `"refund_unreconciled_clearing"`, `"refund_unreconciled_reversal"`, `"resolution_center_refund"`, `"revshare_percentage_fee"`, `"sales_tax_collected"`, `"sales_tax_collected_reversal"`, `"sales_tax_fee"`, `"sales_tax_remittance"`, `"sales_tax_remittance_reversal"`, `"sales_tax_remitted"`, `"settlement_rounding_variance"`, `"settlement_shortfall_loss"`, `"software_rental_revshare"`, `"software_rental_transaction"`, `"stripe_domestic_processing_fee"`, `"stripe_international_processing_fee"`, `"swap_fee"`, `"tax_filing_fee"`, `"three_ds_fixed_fee"`, `"topup"`, `"topup_fee"`, `"topup_reversal"`, `"trading_account_deposit"`, `"trading_account_deposit_offset"`, `"trading_account_withdrawal"`, `"trading_account_withdrawal_offset"`, `"treasury_fee"`, `"treasury_payin"`, `"treasury_payin_receivable"`, `"whop_processing_fee"`, `"whop_swap_fee_received"`, `"withdrawal_clawback"`, `"withdrawal_clawback_reversal"`, `"withdrawal_fee"`, `"withdrawal_fee_reversal"`, `"withdrawal_markup_fee"`, `"withdrawal_markup_fee_payout"`, `"withdrawal_markup_fee_payout_reversal"`, `"withdrawal_markup_fee_reversal"`, `"withdrawal_payable"`, `"withdrawal_payable_clearing"`, `"withdrawal_payable_clearing_reversal"`, `"withdrawal_payable_reversal"`, `"withdrawal_reclassification"`, `"withdrawal_reversal"`, `"withdrawal_topup_adjustment"`, `"deposit"`, `"wallet_transfer_incoming"`, `"wallet_transfer_outgoing"`, `"swap_source"` ou `"swap_target"`.

**amount** `string` *required*

Montant signé, dans la plus petite unité de précision de la devise.

**usd\_amount** `string | null` *required*

Valeur en dollars de ce mouvement sous forme de chaîne décimale, signée comme `amount`. Convertie à partir du montant comptabilisé au taux en vigueur au moment de la comptabilisation de la ligne — la même tarification que celle utilisée par le graphique de solde du wallet et les rapports financiers —, de sorte qu'une ligne crypto porte aussi sa valeur en dollars. `null` pour une devise pour laquelle Whop ne dispose d'aucun taux de change.

**currency** `object` *required*

Devise de cette activité du registre.

**propriétés**

**code** `string` *required*

**precision** `string` *required*

**posted\_at** `string` *required*

Date à laquelle l'activité a été comptabilisée dans le registre.

**available\_at** `string | null` *required*

Horodatage ISO 8601 auquel cette activité affecte les fonds disponibles : 00:00:00 UTC à la date de libération prévue pour les crédits et débits d'un compartiment de libération de fonds en attente ; l'heure de comptabilisation pour les crédits et débits des fonds disponibles réglés, y compris les remboursements, les litiges et les versements. Null pour les activités hors de ces circuits, y compris les lignes on-chain. Les filtres available\_after/before utilisent sa date UTC ; l'activité par défaut exclut certains mouvements, notamment les réserves facultatives.

**resource** `object | null` *required*

Ressource associée à cette activité du registre.

**forme 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**forme 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**forme 3**

**object** `"bounty"` *required*

**id** `string` *required*

**title** `string` *required*

**status** `string` *required*

**forme 4**

**object** `"ledger_account"` *required*

**id** `string` *required*

**owner** `object | null` *required*

**forme 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**forme 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**forme 5**

**object** `"payment_method"` *required*

**id** `string` *required*

**payment\_method\_type** `string | null` *required*

**gateway\_type** `string | null` *required*

**card** `object | null` *required*

**propriétés**

**brand** `string | null` *required*

**last4** `string | null` *required*

**exp\_month** `number | null` *required*

**exp\_year** `number | null` *required*

**bank** `object | null` *required*

**propriétés**

**bank\_name** `string | null` *required*

**account\_name** `string | null` *required*

**last4** `string | null` *required*

**account\_type** `string | null` *required*

**email\_identifier** `string | null` *required*

**forme 6**

**object** `"payout_method"` *required*

**id** `string` *required*

**nickname** `string | null` *required*

**institution\_name** `string | null` *required*

**account\_reference** `string | null` *required*

**provider** `string | null` *required*

**destination\_currency\_code** `string | null` *required*

**forme 7**

**object** `"card_transaction"` *required*

**id** `string` *required*

**card\_id** `string | null` *required*

**merchant\_name** `string | null` *required*

**merchant\_icon\_url** `string | null` *required*

**merchant\_category** `string | null` *required*

**status** `string | null` *required*

**usd\_amount** `string | null` *required*

**local\_amount** `string | null` *required*

**local\_currency** `string | null` *required*

**cashback\_usd** `string | null` *required*

**levels\_points** `string | null` *required*

**authorized\_at** `string | null` *required*

**posted\_at** `string | null` *required*

**declined\_reason** `string | null` *required*

**source** `object | null` *required*

Source de cette activité du registre. Les frais de majoration de la plateforme utilisent l'objet platform\_fee et l'ID de l'activité du registre.

**propriétés**

**object** `string` *required*

**id** `string` *required*

**fee\_kind** `string | null`

L'une des valeurs `"deposit"`, `"transfer"`, `"card_spend"`, `"payout"`, `"swap"` ou `null`.

**status** `string | null`

**payment\_amount** `Money | null`

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**payment\_method\_type** `string | null`

**payment\_processor** `string | null`

**card\_brand** `string | null`

**reason** `string | null`

**notes** `string | null`

**risk\_review\_hold** `boolean | null`

**claim\_url** `string | null`

**amount\_float** `number | null`

**payout\_amount** `Money | null`

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**fee\_amount** `Money | null`

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**fee\_type** `"exclusive" | "inclusive" | null`

**created\_by\_user** `UserSummary | null`

**propriétés**

**id** `string` *required*

ID d'utilisateur, préfixé par `user_`.

**username** `string` *required*

Nom d'utilisateur public.

**name** `string | null` *required*

Nom affiché.

**profile\_picture** `UserProfilePicture` *required*

Conteneur de l'avatar ; son `url` est toujours présent et utilise un placeholder généré lorsque l'utilisateur n'a défini aucune photo.

**propriétés**

**url** `string` *required*

URL de l'image d'avatar. Toujours présente — un placeholder généré lorsque l'utilisateur n'a défini aucune photo.

**trace\_code** `string | null`

**created\_at** `string | null`

**estimated\_arrival** `string | null`

**payer\_name** `string | null`

**payout\_token\_nickname** `string | null`

**tx\_hash** `string | null`

**sender\_address** `string | null`

**chain** `string | null`

**from\_amount** `string | null`

**from\_currency** `string | null`

**to\_amount** `string | null`

**to\_currency** `string | null`

**payout\_destination** `object | null`

**propriétés**

**payer\_name** `string | null`

**icon\_url** `string | null`

**security\_answer** `string | null`

**\[key: string]** `unknown` *required*

**payment** `object | null`

Paiement lié à cette activité du registre. Inclus lorsque l'hydratation enrichie des ressources est activée et que le mouvement est lié à un paiement.

**propriétés**

**object** `"payment"` *required*

**id** `string` *required*

**amount** `Money | null` *required*

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**payment\_method\_type** `string | null` *required*

**payment\_processor** `string | null` *required*

**card\_brand** `string | null` *required*

**card\_last4** `string | null` *required*

**user** `object | null` *required*

**propriétés**

**id** `string` *required*

**name** `string` *required*

**email** `string | null` *required*

**product** `object | null` *required*

**propriétés**

**id** `string` *required*

**name** `string` *required*

**plan** `object | null` *required*

**propriétés**

**id** `string` *required*

**name** `string | null` *required*

**created\_at** `string` *required*

**payment\_id** `string | null`

ID du paiement pour toute activité liée à un paiement, y compris les remboursements et les litiges.

**user\_id** `string | null`

ID du client associé au paiement.

**user\_name** `string | null`

Nom affiché du client associé au paiement.

**user\_email** `string | null`

E-mail du client associé au paiement. Nécessite member:email:read.

**product\_id** `string | null`

ID du produit associé au paiement, le cas échéant.

**product\_name** `string | null`

Nom du produit associé au paiement, le cas échéant.

**plan\_id** `string | null`

ID de la variante associée au paiement, le cas échéant.

**plan\_name** `string | null`

Nom de la variante associée au paiement, le cas échéant.

**account** `object`

Le compte de l'utilisateur propriétaire du registre de cette ligne. Présent uniquement lorsque la réponse agrège les comptes détenus (include\_owned\_accounts=true) ; omis sinon.

**forme 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**forme 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**ledger\_account\_id** `string | null`

Le compte de registre (un identifiant ldgr\_) auquel appartient cette ligne. Présent uniquement lorsque la réponse agrège les comptes détenus (include\_owned\_accounts=true) ; omis sinon. Associez-le à `account` pour limiter les panneaux et les liens du tableau de bord à l'entreprise propriétaire.

### `onActivityHovered`

Le pointeur est entré dans une ligne, ou en est sorti (`null`). Pointez au même moment un élément qui vous est propre, par exemple en marquant la ligne sur un graphique de solde.

**payload** `object | null`

**propriétés**

**activity** `LedgerActivity` *required*

**propriétés**

**object** `"ledger_activity"` *required*

**id** `string` *required*

ID de l'activité du registre.

**line\_type** `string` *required*

La catégorie de ligne du registre sous laquelle cette activité a été comptabilisée.

**valeurs**

L'une des valeurs `"withdrawal"`, `"accelerated_settlement_fee"`, `"account_settlement"`, `"ad_affiliate_payout"`, `"ad_affiliate_payout_received"`, `"ad_balance_funding_receipt"`, `"ad_budget_release"`, `"ad_campaign_budget"`, `"ad_funding_disbursement"`, `"ad_income_expense"`, `"ad_income_receipt"`, `"ad_network_cost"`, `"ad_network_settlement"`, `"ad_publisher_payout"`, `"ad_publisher_payout_received"`, `"ad_spend_charge"`, `"ad_spend_margin"`, `"ad_spend_purchase"`, `"ads_card_spread"`, `"affiliate_fee"`, `"aggregated_fee"`, `"airdrop"`, `"airdrop_expense"`, `"airdrop_expense_reversal"`, `"airdrop_link_canceled"`, `"airdrop_link_claimed"`, `"airdrop_link_created"`, `"airdrop_link_funded"`, `"airdrop_link_redeemed"`, `"airdrop_link_returned"`, `"airdrop_reversal"`, `"application_fee"`, `"application_fee_payable"`, `"application_fee_payout"`, `"bad_debt_expense"`, `"bad_debt_offset"`, `"balance_reservation"`, `"balance_reservation_hold"`, `"balance_reservation_release"`, `"balance_reservation_reversal"`, `"billing_percentage_fee"`, `"buyer_fee"`, `"card_interchange"`, `"card_interchange_receivable"`, `"card_load_deposit"`, `"card_load_transfer"`, `"card_spend_authorization"`, `"card_spend_authorization_hold"`, `"card_spend_authorization_void"`, `"card_spend_authorization_void_release"`, `"card_spend_capture"`, `"card_spend_capture_offset"`, `"card_spend_refund"`, `"card_spend_refund_offset"`, `"card_unload_deposit"`, `"card_unload_transfer"`, `"cashback"`, `"cashback_expense"`, `"cashback_funding"`, `"clawback_fee"`, `"clawback_receivable"`, `"clawback_receivable_reversal"`, `"clawback_receivable_settlement"`, `"clawback_receivable_settlement_reversal"`, `"company_referral"`, `"connected_account_clawback"`, `"connected_account_negative_balance"`, `"cross_border_percentage_fee"`, `"currency_conversion_incoming"`, `"currency_conversion_outgoing"`, `"dispute_alert_fee"`, `"dispute_hold_adjustment"`, `"dispute_hold_blocked"`, `"dispute_management_fee"`, `"dispute_payable_clearing"`, `"dispute_payable_reversal"`, `"dispute_representment_fee"`, `"dispute_settlement"`, `"dispute_settlement_reversal"`, `"dispute_unreconciled_clearing"`, `"dispute_unreconciled_reversal"`, `"economic_intelligence_percentage_fee"`, `"external_account_connection_fee"`, `"external_card_load_deposit"`, `"external_card_load_offset"`, `"fraud_prevention_fee"`, `"fx_gain_loss"`, `"fx_markup"`, `"fx_percentage_fee"`, `"fx_settlement_gain_loss"`, `"high_risk_merchant_fee"`, `"identity_verification_fee"`, `"installment_default"`, `"internal_balance_transfer_incoming"`, `"internal_balance_transfer_outgoing"`, `"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_payable"`, `"internal_withdrawal_payable_reversal"`, `"internal_withdrawal_reversal"`, `"legacy_crypto_payment"`, `"legacy_payment"`, `"legacy_payment_refund"`, `"levels_points_ads"`, `"levels_points_burned"`, `"levels_points_card"`, `"levels_points_issued"`, `"levels_points_partner"`, `"levels_points_trading"`, `"levels_rebate"`, `"license_sale"`, `"license_sale_commission"`, `"license_sale_revenue"`, `"marketing_expense"`, `"marketplace_affiliate_fee"`, `"misc_purchase"`, `"misc_refund"`, `"misc_reversal"`, `"onboarding_reward"`, `"onchain_deposit"`, `"onchain_deposit_offset"`, `"onchain_internal_transfer_incoming"`, `"onchain_internal_transfer_outgoing"`, `"onchain_platform_transfer_incoming"`, `"onchain_platform_transfer_outgoing"`, `"onchain_swap_offset"`, `"onchain_swap_source"`, `"onchain_swap_target"`, `"onchain_wallet_transfer_incoming"`, `"onchain_wallet_transfer_outgoing"`, `"onchain_withdrawal"`, `"onchain_withdrawal_offset"`, `"orchestration_percentage_fee"`, `"partner_grant_reward"`, `"passthrough_gmv"`, `"passthrough_gmv_offset"`, `"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_receivable_clearing"`, `"payment_receivable_reversal"`, `"payment_receivable_settlement"`, `"payment_referral"`, `"payment_referral_payable"`, `"payment_referral_refund"`, `"payment_referral_reversal"`, `"payment_refund"`, `"payment_refund_fee"`, `"payment_refund_reversal"`, `"payment_return_fee"`, `"payment_revshare"`, `"payment_revshare_payout"`, `"payment_revshare_refund"`, `"payment_revshare_reversal"`, `"payment_unreconciled_clearing"`, `"payment_unreconciled_reversal"`, `"payout_fee"`, `"payout_receivable"`, `"payout_subsidy"`, `"payout_unreconciled_clearing"`, `"platform_affiliate_payment"`, `"platform_affiliate_payment_reversal"`, `"platform_balance_payment"`, `"platform_balance_payment_refund"`, `"platform_balance_transfer_fee"`, `"platform_balance_transfer_incoming"`, `"platform_balance_transfer_outgoing"`, `"platform_covered_dispute"`, `"platform_credits_granted"`, `"platform_credits_payment"`, `"platform_credits_payment_refund"`, `"platform_earning"`, `"platform_earning_settlement"`, `"platform_earning_unreconciled_clearing"`, `"platform_markup_fee"`, `"platform_markup_fee_payout"`, `"promo_reversal"`, `"psp_accelerated_settlement_fee"`, `"psp_account_debit"`, `"psp_account_updater_fee"`, `"psp_adjusted_processing_fee"`, `"psp_authentication_fee"`, `"psp_bank_pull_clearing"`, `"psp_bank_pull_settlement"`, `"psp_billing_fee"`, `"psp_clawback_fee"`, `"psp_clawback_settlement"`, `"psp_clawback_settlement_reversal"`, `"psp_collection_settlement"`, `"psp_commission_fee"`, `"psp_connect_fee"`, `"psp_correction"`, `"psp_currency_conversion_incoming"`, `"psp_currency_conversion_outgoing"`, `"psp_currency_conversion_receivable"`, `"psp_currency_conversion_receivable_clearing"`, `"psp_dispute_alert_fee"`, `"psp_dispute_fee"`, `"psp_dispute_management_fee"`, `"psp_dispute_payable"`, `"psp_external_account_connection_fee"`, `"psp_fixed_fee"`, `"psp_fx_adjustment"`, `"psp_gateway_fee"`, `"psp_identity_verification_fee"`, `"psp_interchange_fee"`, `"psp_invoice_tax_fee"`, `"psp_invoicing_fee"`, `"psp_markup_fee"`, `"psp_network_token_fee"`, `"psp_optimization_fee"`, `"psp_payin_clearing"`, `"psp_payin_settlement"`, `"psp_payment_method_fee"`, `"psp_payment_receivable"`, `"psp_payout_consolidation"`, `"psp_payout_deposit"`, `"psp_payout_fee"`, `"psp_payout_receivable"`, `"psp_payout_receivable_clearing"`, `"psp_payout_settlement"`, `"psp_payout_settlement_reversal"`, `"psp_pool_clearing"`, `"psp_pool_dispute_settlement"`, `"psp_pool_refund_clearing"`, `"psp_pool_refund_settlement"`, `"psp_pool_settlement"`, `"psp_processing_fee"`, `"psp_receivable_pooled"`, `"psp_recipient_wallet_load"`, `"psp_refund_fee"`, `"psp_refund_payable"`, `"psp_reserve_hold"`, `"psp_reserve_release"`, `"psp_risk_fee"`, `"psp_scheme_fee"`, `"psp_service_fee"`, `"psp_tax_filing_fee"`, `"psp_tax_service_fee"`, `"psp_terminal_fee"`, `"psp_transfer_settlement"`, `"psp_transfer_settlement_reversal"`, `"psp_treasury_fee"`, `"psp_variable_fee"`, `"psp_withholding_tax"`, `"recipient_wallet_load"`, `"referral_bonus"`, `"refund_payable_clearing"`, `"refund_payable_reversal"`, `"refund_settlement"`, `"refund_settlement_reversal"`, `"refund_unreconciled_clearing"`, `"refund_unreconciled_reversal"`, `"resolution_center_refund"`, `"revshare_percentage_fee"`, `"sales_tax_collected"`, `"sales_tax_collected_reversal"`, `"sales_tax_fee"`, `"sales_tax_remittance"`, `"sales_tax_remittance_reversal"`, `"sales_tax_remitted"`, `"settlement_rounding_variance"`, `"settlement_shortfall_loss"`, `"software_rental_revshare"`, `"software_rental_transaction"`, `"stripe_domestic_processing_fee"`, `"stripe_international_processing_fee"`, `"swap_fee"`, `"tax_filing_fee"`, `"three_ds_fixed_fee"`, `"topup"`, `"topup_fee"`, `"topup_reversal"`, `"trading_account_deposit"`, `"trading_account_deposit_offset"`, `"trading_account_withdrawal"`, `"trading_account_withdrawal_offset"`, `"treasury_fee"`, `"treasury_payin"`, `"treasury_payin_receivable"`, `"whop_processing_fee"`, `"whop_swap_fee_received"`, `"withdrawal_clawback"`, `"withdrawal_clawback_reversal"`, `"withdrawal_fee"`, `"withdrawal_fee_reversal"`, `"withdrawal_markup_fee"`, `"withdrawal_markup_fee_payout"`, `"withdrawal_markup_fee_payout_reversal"`, `"withdrawal_markup_fee_reversal"`, `"withdrawal_payable"`, `"withdrawal_payable_clearing"`, `"withdrawal_payable_clearing_reversal"`, `"withdrawal_payable_reversal"`, `"withdrawal_reclassification"`, `"withdrawal_reversal"`, `"withdrawal_topup_adjustment"`, `"deposit"`, `"wallet_transfer_incoming"`, `"wallet_transfer_outgoing"`, `"swap_source"` ou `"swap_target"`.

**amount** `string` *required*

Montant signé, dans la plus petite unité de précision de la devise.

**usd\_amount** `string | null` *required*

Valeur en dollars de ce mouvement sous forme de chaîne décimale, signée comme `amount`. Convertie à partir du montant comptabilisé au taux en vigueur au moment de la comptabilisation de la ligne — la même tarification que celle utilisée par le graphique de solde du wallet et les rapports financiers —, de sorte qu'une ligne crypto porte aussi sa valeur en dollars. `null` pour une devise pour laquelle Whop ne dispose d'aucun taux de change.

**currency** `object` *required*

Devise de cette activité du registre.

**propriétés**

**code** `string` *required*

**precision** `string` *required*

**posted\_at** `string` *required*

Date à laquelle l'activité a été comptabilisée dans le registre.

**available\_at** `string | null` *required*

Horodatage ISO 8601 auquel cette activité affecte les fonds disponibles : 00:00:00 UTC à la date de libération prévue pour les crédits et débits d'un compartiment de libération de fonds en attente ; l'heure de comptabilisation pour les crédits et débits des fonds disponibles réglés, y compris les remboursements, les litiges et les versements. Null pour les activités hors de ces circuits, y compris les lignes on-chain. Les filtres available\_after/before utilisent sa date UTC ; l'activité par défaut exclut certains mouvements, notamment les réserves facultatives.

**resource** `object | null` *required*

Ressource associée à cette activité du registre.

**forme 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**forme 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**forme 3**

**object** `"bounty"` *required*

**id** `string` *required*

**title** `string` *required*

**status** `string` *required*

**forme 4**

**object** `"ledger_account"` *required*

**id** `string` *required*

**owner** `object | null` *required*

**forme 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**forme 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**forme 5**

**object** `"payment_method"` *required*

**id** `string` *required*

**payment\_method\_type** `string | null` *required*

**gateway\_type** `string | null` *required*

**card** `object | null` *required*

**propriétés**

**brand** `string | null` *required*

**last4** `string | null` *required*

**exp\_month** `number | null` *required*

**exp\_year** `number | null` *required*

**bank** `object | null` *required*

**propriétés**

**bank\_name** `string | null` *required*

**account\_name** `string | null` *required*

**last4** `string | null` *required*

**account\_type** `string | null` *required*

**email\_identifier** `string | null` *required*

**forme 6**

**object** `"payout_method"` *required*

**id** `string` *required*

**nickname** `string | null` *required*

**institution\_name** `string | null` *required*

**account\_reference** `string | null` *required*

**provider** `string | null` *required*

**destination\_currency\_code** `string | null` *required*

**forme 7**

**object** `"card_transaction"` *required*

**id** `string` *required*

**card\_id** `string | null` *required*

**merchant\_name** `string | null` *required*

**merchant\_icon\_url** `string | null` *required*

**merchant\_category** `string | null` *required*

**status** `string | null` *required*

**usd\_amount** `string | null` *required*

**local\_amount** `string | null` *required*

**local\_currency** `string | null` *required*

**cashback\_usd** `string | null` *required*

**levels\_points** `string | null` *required*

**authorized\_at** `string | null` *required*

**posted\_at** `string | null` *required*

**declined\_reason** `string | null` *required*

**source** `object | null` *required*

Source de cette activité du registre. Les frais de majoration de la plateforme utilisent l'objet platform\_fee et l'ID de l'activité du registre.

**propriétés**

**object** `string` *required*

**id** `string` *required*

**fee\_kind** `string | null`

L'une des valeurs `"deposit"`, `"transfer"`, `"card_spend"`, `"payout"`, `"swap"` ou `null`.

**status** `string | null`

**payment\_amount** `Money | null`

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**payment\_method\_type** `string | null`

**payment\_processor** `string | null`

**card\_brand** `string | null`

**reason** `string | null`

**notes** `string | null`

**risk\_review\_hold** `boolean | null`

**claim\_url** `string | null`

**amount\_float** `number | null`

**payout\_amount** `Money | null`

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**fee\_amount** `Money | null`

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**fee\_type** `"exclusive" | "inclusive" | null`

**created\_by\_user** `UserSummary | null`

**propriétés**

**id** `string` *required*

ID d'utilisateur, préfixé par `user_`.

**username** `string` *required*

Nom d'utilisateur public.

**name** `string | null` *required*

Nom affiché.

**profile\_picture** `UserProfilePicture` *required*

Conteneur de l'avatar ; son `url` est toujours présent et utilise un placeholder généré lorsque l'utilisateur n'a défini aucune photo.

**propriétés**

**url** `string` *required*

URL de l'image d'avatar. Toujours présente — un placeholder généré lorsque l'utilisateur n'a défini aucune photo.

**trace\_code** `string | null`

**created\_at** `string | null`

**estimated\_arrival** `string | null`

**payer\_name** `string | null`

**payout\_token\_nickname** `string | null`

**tx\_hash** `string | null`

**sender\_address** `string | null`

**chain** `string | null`

**from\_amount** `string | null`

**from\_currency** `string | null`

**to\_amount** `string | null`

**to\_currency** `string | null`

**payout\_destination** `object | null`

**propriétés**

**payer\_name** `string | null`

**icon\_url** `string | null`

**security\_answer** `string | null`

**\[key: string]** `unknown` *required*

**payment** `object | null`

Paiement lié à cette activité du registre. Inclus lorsque l'hydratation enrichie des ressources est activée et que le mouvement est lié à un paiement.

**propriétés**

**object** `"payment"` *required*

**id** `string` *required*

**amount** `Money | null` *required*

**propriétés**

**currency** `string` *required*

Code de devise ISO 4217 à trois lettres, en minuscules.

**amount** `string` *required*

Le montant en unités principales, sous forme de chaîne décimale exacte — `"10.00"` correspond à dix dollars. Une chaîne, afin qu'aucun flottant ne l'arrondisse en transit.

**decimals** `number` *required*

Le nombre de décimales que le montant COMPORTE — la précision à laquelle le débit lui-même s'effectue.

**display\_decimals** `number` *required*

Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez-le pour formater le nombre dans votre propre locale.

**payment\_method\_type** `string | null` *required*

**payment\_processor** `string | null` *required*

**card\_brand** `string | null` *required*

**card\_last4** `string | null` *required*

**user** `object | null` *required*

**propriétés**

**id** `string` *required*

**name** `string` *required*

**email** `string | null` *required*

**product** `object | null` *required*

**propriétés**

**id** `string` *required*

**name** `string` *required*

**plan** `object | null` *required*

**propriétés**

**id** `string` *required*

**name** `string | null` *required*

**created\_at** `string` *required*

**payment\_id** `string | null`

ID du paiement pour toute activité liée à un paiement, y compris les remboursements et les litiges.

**user\_id** `string | null`

ID du client associé au paiement.

**user\_name** `string | null`

Nom affiché du client associé au paiement.

**user\_email** `string | null`

E-mail du client associé au paiement. Nécessite member:email:read.

**product\_id** `string | null`

ID du produit associé au paiement, le cas échéant.

**product\_name** `string | null`

Nom du produit associé au paiement, le cas échéant.

**plan\_id** `string | null`

ID de la variante associée au paiement, le cas échéant.

**plan\_name** `string | null`

Nom de la variante associée au paiement, le cas échéant.

**account** `object`

Le compte de l'utilisateur propriétaire du registre de cette ligne. Présent uniquement lorsque la réponse agrège les comptes détenus (include\_owned\_accounts=true) ; omis sinon.

**forme 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**forme 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**ledger\_account\_id** `string | null`

Le compte de registre (un identifiant ldgr\_) auquel appartient cette ligne. Présent uniquement lorsque la réponse agrège les comptes détenus (include\_owned\_accounts=true) ; omis sinon. Associez-le à `account` pour limiter les panneaux et les liens du tableau de bord à l'entreprise propriétaire.

### `onSeeAllRequested`

L'utilisateur a appuyé sur See all activity dans une liste `maxItems`. Ouvrez votre propre écran d'activité complète ; l'élément ne navigue jamais.

### `onDateRangeChanged`

L'utilisateur a modifié le filtre de date via les puces de filtre plutôt que via `setDateRange`. Effacez toute sélection de plage qui vous est propre, comme une sélection (brush) sur un graphique, qui ne correspond plus.

**payload** `object`

**propriétés**

**dateRange** `object | null` *required*

**propriétés**

**start** `string` *required*

**end** `string` *required*

### `onLoaderStart`

S'exécute après le premier affichage du squelette de chargement et avant `onReady`.

### `onReady`

S'exécute après le premier affichage complet de l'élément.

### `onError`

S'exécute lorsque l'élément ne parvient pas à se charger ou plante. L'affichage de repli reste visible. Utilisez `code` pour une gestion programmatique. `sourceKey` identifie une source d'état hôte en échec.

**e** `object`

**propriétés**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Méthodes

Appelez-les sur le handle renvoyé par `create`, ou via une `ref` React.

### `refresh`

Récupère à nouveau l'activité du compte à partir de la première page. Appelez-la après une mutation effectuée ailleurs (un dépôt, un envoi) pour que la liste la reflète sans attendre l'expiration du cache.

**Renvoie** `Promise<void>`

### `setDateRange`

Définit le filtre de date depuis l'extérieur de l'élément, par exemple en reliant une sélection (brush) d'un graphique à la liste. Transmettez `null` pour l'effacer.

**Paramètres**

**input** `ActivityDateRangeOverride | null` *required*

**propriétés**

**start** `string` *required*

**end** `string` *required*

**includeTime** `boolean`

**postedAfter** `string`

**postedBefore** `string`

**displayPostedAfter** `string`

**displayPostedBefore** `string`

**Renvoie** `Promise<void>`

### `mount`

Monte l'élément dans `target` et démarre le chargement. Les composants React se montent eux-mêmes.

**Paramètres**

**target** `string | HTMLElement` *required*

### `destroy`

Supprime l'élément et libère son frame et ses abonnements. Vous pouvez l'appeler plusieurs fois. React supprime l'élément automatiquement.

### `update`

Fusionne de nouvelles props dans l'élément monté. Avec React, modifiez plutôt les props du composant.

**Paramètres**

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

## Style

Stylisez ces parties via `appearance.classes`. Utilisez le camel case ou le kebab case pour les noms de propriétés et incluez les unités. Les feuilles de style de la page ne peuvent pas atteindre le frame de l'élément. Le framework valide chaque déclaration avant de l'injecter.

| Classe | Cible |
| - | - |
| `.whop-ActivityRow` | Une ligne d'activité du registre — son icône, son titre, son horodatage et son montant |
| `.whop-ActivitySurface` | Le flux d'activité — titre, filtres et jusqu'à l'ensemble des lignes récupérées |

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

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

Avec React, transmettez `appearance` à `<Wallet>`. Définissez-la globalement avec `WhopElements({ appearance })`.

## Paramètres

**accountId** `String` *required*

Le registre à lister. Utilisez un ID de compte préfixé par `biz_` ou un ID d'utilisateur préfixé par `user_`. Les deux fonctionnent directement, car le flux lit l'ID sans résoudre d'abord un registre.

**showsTitle** `Bool`

Affiche le titre intégré « Activity ». Par défaut : `true`. Désactivez-le lorsque votre écran en a déjà un.

**onActivitySelected** `((WalletActivity) -\> Void)?`

Appelée avec la ligne touchée par l'utilisateur. La vue ne navigue jamais : redirigez donc vers votre propre écran de détail.

## `WalletActivity`

Ce que renvoie une sélection :

* `id: String` : stable pour chaque ligne
* `title: String` / `subtitle: String` : les deux lignes de la ligne
* `amount: Decimal` : signé, négatif pour l'argent sortant
* `currencyCode: String`
* `postedAt: Date`
* `isIncoming: Bool`

## États

Affiche une liste squelette pendant le chargement de la première page, `No activity found` lorsque le registre n'a aucun mouvement, et le message d'échec avec un bouton `Try again` lorsque la lecture échoue. Si une page ultérieure échoue, les lignes déjà chargées restent à l'écran et un `Try again` apparaît en bas.

## Bon à savoir

* **Placez-le dans un conteneur défilant.** Le flux est un `LazyVStack` qui se pagine lorsque sa dernière ligne apparaît : en dehors d'une `ScrollView`, il affiche la première page et n'en charge jamais d'autre.
* Accepte directement les tags `biz_…` et `user_…` : contrairement aux autres vues du wallet, il n'a donc jamais à résoudre d'abord un registre.

> [!NOTE]
>
> Appelez `WhopSDK.configure(tokenProvider:)` une seule fois au lancement. Les vues attendent le jeton. Consultez [Premiers pas](https://docs.whop.com/fr/elements/latest/getting-started.md). Appliquez un thème avec `.whopTheme(_:)`.
