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

# API Activité financière

> Une ligne d'activité financière est un mouvement unique d'argent entrant ou sortant du solde d'un compte ou d'un utilisateur : un paiement, un versement, un remboursement, un transfert, un dépôt on-chain, un swap ou une transaction par carte.

Chaque ligne comporte un `resource` et une `source` typés afin que vous puissiez présenter l'événement et créer un lien vers celui-ci sans requêtes supplémentaires.

Utilisez l'API Activité financière pour créer un relevé ou un flux de transactions pour un compte ou un utilisateur, et les rapports financiers pour résumer l'activité du solde, les revenus et les soldes sur une période donnée, puis décomposer le total d'un rapport selon ses composantes.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister l'activité financière](https://docs.whop.com/fr/api-reference/ledgers/list-financial-activity.md) | GET `/financial_activity` |
| [Obtenir un rapport financier](https://docs.whop.com/fr/api-reference/ledgers/get-financial-report.md) | GET `/financial_reports` |
| [Obtenir la ventilation d'un rapport financier](https://docs.whop.com/fr/api-reference/ledgers/get-financial-report-breakdown.md) | GET `/financial_reports/breakdown` |

## Attributs

**id** `string` *required*

ID de l'activité du registre.

**account** `account or user`

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

**amount** `string` *required*

Montant signé dans les plus petites unités de précision de la devise.

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

Horodatage ISO 8601 du moment où cette activité affecte les fonds disponibles : 00:00:00 UTC à la date de libération prévue pour les crédits et débits se trouvant dans un compartiment de libération de fonds en attente ; l'heure de comptabilisation pour les crédits et débits sur des fonds disponibles réglés, y compris les remboursements, litiges et versements. Null pour les activités hors de ces cas, 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 (opt-in).

**currency** `object` *required*

Devise de cette activité du registre.

> [accordion] Propriétés
>
> **code** `string` *required*
>
> Code de devise.
>
> **precision** `string` *required*
>
> Facteur de précision de la devise, par exemple `100000000` pour l'USD.

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

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

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

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

**object** `string` *required*

**payment** `payment | 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.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du paiement, préfixé par `pay_`.
>
> **amount** `object | null` *required*
>
> Total prélevé par le paiement.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre dans votre propre locale.
>
> **card\_brand** `string | null` *required*
>
> Marque de la carte, lorsque le client a payé par carte.
>
> **card\_last4** `string | null` *required*
>
> Quatre derniers chiffres de la carte, lorsque le client a payé par carte.
>
> **created\_at** `string` *required*
>
> Date de création du paiement.
>
> **object** `string` *required*
>
> **payment\_method\_type** `string | null` *required*
>
> Mode de paiement utilisé par le client, comme `card` ou `paypal`.
>
> **payment\_processor** `string | null` *required*
>
> Processeur qui a traité le paiement, comme `stripe`.
>
> **plan** `object | null` *required*
>
> Variante associée au paiement, le cas échéant.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID de la variante, préfixé par `plan_`.
> >
> > **name** `string | null` *required*
> >
> > Nom de la variante.
>
> **product** `object | null` *required*
>
> Produit associé au paiement, le cas échéant.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID du produit, préfixé par `prod_`.
> >
> > **name** `string` *required*
> >
> > Nom du produit.
>
> **user** `object | null` *required*
>
> Client associé au paiement. L'e-mail nécessite member:email:read.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID du client, préfixé par `user_`.
> >
> > **email** `string | null` *required*
> >
> > E-mail du client, ou null sans member:email:read.
> >
> > **name** `string` *required*
> >
> > Nom d'affichage du client.

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

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

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

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

Date de comptabilisation de l'activité dans le registre.

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

**resource** `account or user or bounty or ledger_account or payment_method or payout_method or card_transaction | null` *required*

Ressource associée à cette activité du registre.

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

> [accordion] Propriétés
>
> **id** `string` *required*
>
> **amount\_float** `number | null`
>
> Montant du versement sous forme de nombre décimal dans la devise de destination (sources payout uniquement ; nécessite payout:withdrawal:read).
>
> **card\_brand** `string | null`
>
> Marque de carte utilisée par la source de paiement.
>
> **chain** `string | null`
>
> Chaîne sur laquelle le dépôt est arrivé, par exemple plasma (sources onchain\_transaction uniquement).
>
> **claim\_url** `string | null`
>
> L'URL de réclamation de l'airdrop. Null sauf si l'appelant peut gérer les liens de réclamation sur le compte de financement ou effectuer des retraits depuis le solde personnel de financement.
>
> **created\_at** `string | null`
>
> Date de création du versement sous forme d'horodatage ISO 8601 (sources payout uniquement ; nécessite payout:withdrawal:read).
>
> **created\_by\_user** `object | null`
>
> Utilisateur ayant demandé le retrait. Null pour les retraits générés par le système ou sans payout:withdrawal:read.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID de l'utilisateur, préfixé par `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nom d'affichage.
> >
> > **profile\_picture** `object` *required*
> >
> > Conteneur de l'avatar. Son `url` est toujours présente, et correspond à une image de substitution générée lorsque l'utilisateur n'a défini aucune photo.
> >
> > > [accordion] Propriétés
> > >
> > > **url** `string` *required*
> > >
> > > URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image de substitution générée lorsque l'utilisateur n'a défini aucune photo.
> >
> > **username** `string` *required*
> >
> > Nom d'utilisateur public.
>
> **estimated\_arrival** `string | null`
>
> Arrivée estimée sous forme d'horodatage ISO 8601 (sources payout uniquement ; nécessite payout:withdrawal:read).
>
> **fee\_amount** `object | null`
>
> Total des frais de retrait, frais de majoration compris. Nécessite payout:withdrawal:read.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre dans votre propre locale.
>
> **fee\_kind** `string | null`
>
> Action ayant généré des frais de majoration de la plateforme : deposit, swap, transfer, card\_spend ou payout. Présent pour platform\_markup\_fee et platform\_markup\_fee\_payout, y compris lorsque include\_resource vaut false. Null lorsque l'action d'origine n'est pas disponible ; omis pour les autres types de source.
>
> Options disponibles : `payout`, `transfer`, `deposit`, `swap`, `card_spend`
>
> **fee\_type** `string | null`
>
> Indique si les frais de retrait sont inclus ou exclus. Nécessite payout:withdrawal:read.
>
> Options disponibles : `exclusive`, `inclusive`
>
> **from\_amount** `string | null`
>
> Montant converti depuis from\_currency sous forme de chaîne décimale (sources swap uniquement).
>
> **from\_currency** `string | null`
>
> Code de devise source de la conversion, en minuscules (sources swap uniquement).
>
> **notes** `string | null`
>
> Mémo joint à la source transfer, payout ou bank\_deposit, ou null si aucun n'a été fourni (pour les sources payout, nécessite payout:withdrawal:read).
>
> **object** `string` *required*
>
> **payer\_name** `string | null`
>
> Pour les sources payout, le nom de l'entité qui traite le versement (nécessite payout:withdrawal:read). Pour les sources bank\_deposit, le nom du compte ayant envoyé le dépôt.
>
> **payment\_amount** `object | null`
>
> Total prélevé par la source de paiement.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre dans votre propre locale.
>
> **payment\_method\_type** `string | null`
>
> Moyen de paiement utilisé par la source de paiement. Pour les sources bank\_deposit, le réseau de virement : `wire`, `ach` ou `rtp`.
>
> **payment\_processor** `string | null`
>
> Processeur utilisé par la source de paiement.
>
> **payout\_amount** `object | null`
>
> Montant principal du retrait envoyé à la destination, hors frais, dans la devise du retrait. Nécessite payout:withdrawal:read.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre dans votre propre locale.
>
> **payout\_destination** `object | null`
>
> Informations d'affichage de la destination du versement (sources payout uniquement).
>
> > [accordion] Propriétés
> >
> > **icon\_url** `string | null`
> >
> > **payer\_name** `string | null`
> >
> > **security\_answer** `string | null`
> >
> > La réponse de sécurité définie par le marchand lors de l'ajout de ce mode de versement (par exemple un virement Interac), nécessaire pour réclamer le versement. null lorsque la destination n'a pas de réponse personnalisée. Nécessite payout:destination:read.
>
> **payout\_token\_nickname** `string | null`
>
> Surnom enregistré de la destination du versement (sources payout uniquement).
>
> **reason** `string | null`
>
> Raison de l'activité. Pour les sources transfer, il s'agit du motif du transfert, par exemple pool\_top\_up ou bounty\_return. Pour les sources payout, il explique pourquoi le versement a été annulé, refusé ou a échoué (nécessite payout:withdrawal:read) ; null tant que le versement se déroule normalement.
>
> **risk\_review\_hold** `boolean | null`
>
> Indique si ce versement est actuellement retenu pour un examen manuel des risques (sources payout uniquement ; nécessite payout:withdrawal:read).
>
> **sender\_address** `string | null`
>
> Pour les sources onchain\_transaction, l'adresse du portefeuille expéditeur ou l'identifiant du fournisseur d'onramp. Pour les sources bank\_deposit, les quatre derniers chiffres du compte bancaire expéditeur, comme `••••1547`.
>
> **status** `string | null`
>
> Statut du cycle de vie. Pour les sources payout, il s'agit du statut du versement (nécessite payout:withdrawal:read) ; pour les sources airdrop\_link, du statut du lien de réclamation (sans restriction) ; pour les sources de paiement et de rechargement, du statut lisible du paiement, comme succeeded/pending/failed (sans restriction) ; pour les sources bank\_deposit, il vaut succeeded, reversal\_in\_progress ou reversed (sans restriction).
>
> **to\_amount** `string | null`
>
> Montant reçu en to\_currency sous forme de chaîne décimale (sources swap uniquement).
>
> **to\_currency** `string | null`
>
> Code de devise cible de la conversion, en minuscules (sources swap uniquement).
>
> **trace\_code** `string | null`
>
> Référence de traçage bancaire du retrait. Nécessite payout:withdrawal:read.
>
> **tx\_hash** `string | null`
>
> Hash de la transaction on-chain (sources onchain\_transaction et swap uniquement).

**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 du solde du portefeuille et les rapports financiers — de sorte qu'une ligne crypto comporte aussi sa valeur en dollars. `null` pour une devise pour laquelle Whop ne dispose d'aucun taux de change.

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

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

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

ID du client associé au paiement.

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

Nom d'affichage du client associé au paiement.

```json LedgerActivity theme={null}
{
	"id": "line_cGF5bWVudF9ncm9zczpsaTpwZXRhbHBvc3Q6YWM6bGVkZ2VyOmxlOjE6djppazpyZWNlaXB0",
	"object": "ledger_activity",
	"line_type": "payment_gross",
	"amount": "4800000000",
	"usd_amount": "48.0",
	"currency": {
		"code": "usd",
		"precision": "100000000"
	},
	"posted_at": "2026-06-14T18:49:49Z",
	"available_at": "2026-06-17T00:00:00Z",
	"resource": {
		"id": "user_4Hk2mZ9qLpXa",
		"object": "user",
		"name": "Jordan Avery",
		"username": "jordanavery",
		"profile_picture_url": "https://cdn.whop.com/users/jordan-avery.png"
	},
	"source": {
		"id": "pay_8QcR2mZ9qLpXa",
		"object": "payment"
	},
	"account": {
		"id": "biz_9dCwK2mZ9qLpXa",
		"object": "account",
		"title": "Acme Studios",
		"route": "acme-studios",
		"logo_url": "https://cdn.whop.com/companies/acme-studios.png"
	},
	"ledger_account_id": "ldgr_7bQx2mZ9qLpXa"
}
```

## Glossaire des types de ligne

Chaque ligne d'activité comporte un `line_type` qui désigne l'événement financier qu'elle représente. Transmettez un ou plusieurs `line_types` à [Lister l'activité financière](https://docs.whop.com/fr/api-reference/ledgers/list-financial-activity.md) pour filtrer le flux sur des événements précis — soit sous forme de paramètres `line_types[]` répétés, soit sous forme d'une seule valeur séparée par des virgules (`line_types=payment_gross,payment_refund`). Les types de ligne inconnus renvoient une erreur `400`.

Le terme moyen de paiement local (Local Payment Method, LPM) désigne un moyen autre que la carte, notamment les prélèvements bancaires, les virements bancaires et les portefeuilles électroniques.

### Catégories

Au lieu de lister des types de ligne individuels, vous pouvez transmettre un raccourci de catégorie. Une catégorie se développe en tous les types de ligne qu'elle contient.

| Catégorie | Se développe en |
| - | - |
| `fees` | Tous les types de ligne de frais de traitement — chaque entrée de la section [Frais](#fees) ci-dessous. |

### Paiements

| Type de ligne | Description |
| - | - |
| `payment_gross` | Une vente par carte ou LPM réglée dans le portefeuille — le montant brut avant frais. |
| `topup` | Fonds que le compte a ajoutés à son propre solde de portefeuille, plutôt qu'une vente de produit. |
| `platform_balance_payment` | Un achat réglé avec le solde existant du portefeuille au lieu d'une carte externe ou d'un LPM. |
| `passthrough_gmv` | Valeur brute des marchandises (GMV) enregistrée pour un achat effectué via un processeur externe, comme Stripe Standard, PayPal ou Coinbase Commerce. |
| `installment_default` | Un prélèvement sur le portefeuille couvrant une échéance de paiement différé (Buy Now, Pay Later) impayée par un acheteur. |

### Remboursements

| Type de ligne | Description |
| - | - |
| `payment_refund` | Un remboursement d'un paiement par carte ou LPM, déduit du portefeuille. |
| `payment_refund_reversal` | Annule un `payment_refund`, en restituant les fonds au portefeuille. |
| `platform_balance_payment_refund` | Un remboursement d'un achat réglé avec le solde du portefeuille, restitué au solde de l'acheteur d'origine. |

### Litiges

| Type de ligne | Description |
| - | - |
| `payment_dispute` | Une rétrofacturation sur un paiement par carte ou LPM, débitée du portefeuille. |
| `payment_dispute_adjustment` | Un crédit ou un débit qui ajuste une rétrofacturation lorsque le montant contesté diffère du paiement d'origine (litiges partiels). |
| `payment_dispute_reversal` | Annule un `payment_dispute` après que le marchand a gagné le litige. |
| `platform_covered_dispute` | La part d'une rétrofacturation couverte par la marketplace de Whop lorsque la vente comportait des frais acheteur. Il peut s'agir d'un crédit ou d'un débit. |
| `dispute_hold_adjustment` | Place des fonds en blocage pour litige ou les en retire. Un débit applique le blocage, et un crédit le lève. |

### Réserves

| Type de ligne | Description |
| - | - |
| `psp_reserve_hold` | Un processeur de paiement retient une partie d'un règlement en réserve, rendant ces fonds indisponibles jusqu'à leur libération. |
| `psp_reserve_release` | Un processeur de paiement restitue au solde de règlement disponible des fonds de réserve précédemment retenus. |

### Versements

| Type de ligne | Description |
| - | - |
| `withdrawal` | Un versement des fonds du portefeuille vers un compte bancaire externe (le type de ligne conserve son nom historique). |
| `withdrawal_reversal` | Annule un versement annulé ou rejeté et restitue les fonds au portefeuille. |
| `withdrawal_clawback` | Un crédit sur le portefeuille qui récupère des fonds depuis le compte bancaire associé pour couvrir un solde négatif. |
| `withdrawal_clawback_reversal` | Annule un `withdrawal_clawback` lorsque la récupération échoue par la suite ou que la banque restitue les fonds. |
| `withdrawal_reclassification` | Restitue le montant net d'un versement au solde disponible du portefeuille lorsque Whop le reclasse en transfert interne. |

### Transferts

| Type de ligne | Description |
| - | - |
| `platform_balance_transfer_outgoing` | Un transfert de fonds du portefeuille vers un autre compte de la plateforme. |
| `platform_balance_transfer_incoming` | Un transfert de fonds vers le portefeuille depuis un autre compte de la plateforme. |
| `internal_balance_transfer_outgoing` | Un transfert sortant vers un autre portefeuille détenu par la même entité, par exemple du portefeuille principal vers un pool. Il n'est pas comptabilisé comme revenu. |
| `internal_balance_transfer_incoming` | Un transfert entrant depuis un autre portefeuille détenu par la même entité, par exemple un transfert d'un portefeuille parent vers un portefeuille de pool. Il n'est pas comptabilisé comme revenu. |

### Conversion de devises

| Type de ligne | Description |
| - | - |
| `currency_conversion_outgoing` | Le débit en devise source créé lorsque le portefeuille convertit un solde d'une devise à une autre. |
| `currency_conversion_incoming` | Le crédit en devise de destination créé lorsque le portefeuille convertit un solde d'une devise à une autre. |

### Affiliés et partage de revenus

| Type de ligne | Description |
| - | - |
| `payment_referral` | Un bonus de parrainage d'affilié que le marchand a choisi de partager sur un paiement par carte ou LPM, crédité sur le portefeuille de l'affilié. |
| `payment_referral_reversal` | Annule un bonus de parrainage précédemment versé, débité du portefeuille de l'affilié. |
| `payment_revshare` | Un montant de partage de revenus débité du portefeuille du vendeur sur un paiement. |
| `payment_revshare_payout` | Un montant de partage de revenus crédité sur le portefeuille d'un affilié sur un paiement. |
| `payment_revshare_reversal` | Annule un partage de revenus précédemment versé, débité du portefeuille de l'affilié. |
| `payment_revshare_refund` | Restitue un montant de partage de revenus au portefeuille du vendeur après un remboursement ou un litige. |
| `application_fee_payout` | Des frais de plateforme issus d'un paiement d'un sous-compte, réglés sur le compte parent. |
| `platform_affiliate_payment` | Un bonus de parrainage pour avoir recommandé un compte ou un acheteur à Whop : une part des revenus de traitement générés par ce compte. |
| `platform_affiliate_payment_reversal` | Annule un `platform_affiliate_payment` que Whop a jugé invalide ou nécessitant une correction. |
| `ad_publisher_payout_received` | Un crédit sur le portefeuille d'un éditeur pour les revenus publicitaires générés. |
| `ad_publisher_payout` | Un versement de revenus publicitaires, débité du portefeuille Whop Ads. |
| `company_referral` | Ancien : un bonus de parrainage pour avoir recommandé un compte à Whop, partageant les revenus de traitement générés par ce compte. |

### Airdrops

| Type de ligne | Description |
| - | - |
| `airdrop` | Un crédit de fonds sur le portefeuille aux frais de Whop, généralement à titre promotionnel ou pour compenser un problème. |
| `airdrop_reversal` | Annule un `airdrop` jugé invalide ou nécessitant une correction. |
| `airdrop_link_created` | Débite le portefeuille pour financer un lien d'airdrop nouvellement créé. |
| `airdrop_link_returned` | Restitue les fonds d'un lien d'airdrop au solde disponible de l'expéditeur après que celui-ci a annulé le lien. |
| `airdrop_link_redeemed` | Crédite les fonds d'un lien d'airdrop réclamé sur le solde disponible du destinataire. |
| `resolution_center_refund` | Un remboursement à un acheteur que Whop prend en charge sur ses propres fonds après avoir résolu un dossier du Resolution Center en faveur de l'acheteur. |

### Publicité

| Type de ligne | Description |
| - | - |
| `ad_campaign_budget` | Réserve des fonds pour une campagne publicitaire lors de son financement. |
| `ad_spend_charge` | Un prélèvement sur les fonds réservés à la campagne pour les dépenses publicitaires, facturé au tarif majoré. |
| `ad_budget_release` | Libère le budget de campagne non dépensé, généralement la première étape d'un remboursement ou d'une restitution de solde. |

### Actifs on-chain et cartes

> [!NOTE]
>
> `onchain_deposit` est facultatif (opt-in) : il est exclu du flux par défaut et n'est renvoyé que si vous le demandez explicitement dans `line_types`.

| Type de ligne | Description |
| - | - |
| `onchain_deposit` | Un transfert crypto on-chain entrant crédité sur un portefeuille géré par Whop (y compris via des onramps comme MoonPay). Facultatif (opt-in) — renvoyé uniquement sur demande explicite. |
| `onchain_wallet_transfer_outgoing` | Un transfert on-chain sortant d'un portefeuille crypto géré par Whop vers un autre portefeuille géré par Whop. |
| `onchain_wallet_transfer_incoming` | Un transfert on-chain entrant vers un portefeuille crypto géré par Whop depuis un autre portefeuille géré par Whop. |
| `onchain_swap_target` | Le côté réception d'un swap de jetons on-chain — le jeton de sortie crédité sur le portefeuille. |
| `treasury_payin` | Un crédit sur le portefeuille en espèces provenant d'un apport de trésorerie, comme un off-ramp crypto reconvertissant un solde crypto en espèces. |
| `card_spend_authorization` | Une retenue d'autorisation de carte qui débite le solde de la carte lorsque l'émetteur autorise un achat. |
| `card_spend_authorization_void` | Restitue une autorisation de carte au solde de la carte lorsqu'elle est annulée, expirée ou refusée après autorisation. |
| `card_spend_refund` | Un remboursement du marchand recrédité sur le solde de la carte. |

### Anciens types et divers

| Type de ligne | Description |
| - | - |
| `legacy_crypto_payment` | Un ancien paiement Coinbase Commerce que Whop a traité et versé sur le portefeuille du marchand. |
| `legacy_payment` | Un ancien paiement de compte express crédité directement sur le portefeuille de l'utilisateur. |
| `legacy_payment_refund` | Annule un `legacy_payment`, en débitant le portefeuille du marchand. |
| `license_sale` | Le versement au marchand pour une vente de licence logicielle multipartite — le montant de la vente net de frais. Les parts de commission et de revenus utilisent les types de ligne distincts `license_sale_commission` et `license_sale_revenue`. |
| `license_sale_commission` | La part de commission d'une vente de licence logicielle, créditée sur le portefeuille de commissions. |
| `license_sale_revenue` | La part de partage de revenus d'une vente de licence logicielle, créditée sur le portefeuille de revenus. |
| `software_rental_revshare` | Un versement de partage de revenus pour une location de logiciel, créditant le marchand net de frais. |
| `software_rental_transaction` | Le règlement final d'une location de logiciel, créditant le marchand net de frais. |
| `misc_purchase` | Un achat effectué directement auprès de Whop, par exemple une ancienne location de logiciel ou un proxy. |
| `misc_refund` | Un remboursement d'un `misc_purchase`. |
| `referral_bonus` | Un bonus pour avoir parrainé un nouvel utilisateur inscrit sur whop.com. |
| `promo_reversal` | Une annulation ponctuelle du solde promotionnel non retirable `referral_bonus`. |
| `misc_reversal` | Ancien — un débit divers pour des frais négociés en dehors du cycle de vie normal des transactions. |

### Frais

| Type de ligne | Description |
| - | - |
| `payment_processing_fixed_fee` | Des frais fixes (≈\$0.30) pour le traitement d'un paiement par carte ou LPM. |
| `payment_processing_percentage_fee` | Des frais en pourcentage, par exemple 2,7 %, pour le traitement d'un paiement par carte ou LPM. |
| `billing_percentage_fee` | Des frais sur les transactions de facturation récurrente couvrant la gestion des abonnements et les nouvelles tentatives. |
| `cross_border_percentage_fee` | Des frais sur les transactions transfrontalières, prélevés lorsque l'acheteur se trouve en dehors de la région de traitement. |
| `fx_percentage_fee` | Des frais de conversion d'un paiement traité dans une devise étrangère lors du règlement. |
| `orchestration_percentage_fee` | Des frais pour l'acheminement d'un paiement via plusieurs PSP (routage intelligent et basculement). |
| `revshare_percentage_fee` | Des frais pour l'utilisation de versements de partage de revenus sur un paiement. |
| `three_ds_fixed_fee` | Des frais fixes pour l'authentification 3DS, prélevés uniquement lorsque le paiement exige le 3DS. |
| `whop_processing_fee` | Des frais de plateforme pour l'utilisation de whop.com, non directement liés au coût de traitement. |
| `fraud_prevention_fee` | Des frais de prévention de la fraude sur les paiements par carte ou LPM. |
| `buyer_fee` | Des frais acheteur comptabilisés comme revenu de la plateforme. Ils ne sont comptabilisés que lorsque la configuration traite les frais acheteur comme des revenus de la plateforme. |
| `sales_tax_fee` | Des frais pour la collecte et le reversement par Whop de la taxe de vente sur un paiement. |
| `sales_tax_remittance` | Taxe de vente perçue sur une transaction que Whop reverse à l'administration fiscale. |
| `sales_tax_remittance_reversal` | Annule un `sales_tax_remittance` après le remboursement ou la contestation d'un paiement. |
| `affiliate_fee` | La part d'un paiement par carte ou LPM réservée au versement d'un bonus de parrainage d'affilié. |
| `application_fee` | Les frais de plateforme issus d'un paiement d'un sous-compte, versés au compte parent. |
| `payout_fee` | Des frais couvrant le coût d'un versement vers un compte bancaire. |
| `payment_dispute_fee` | Des frais (≈\$15) pour la réception d'une rétrofacturation sur un paiement par carte ou LPM. |
| `dispute_alert_fee` | Des frais pour la réception d'une alerte précoce de litige sur un paiement par carte ou LPM. |
| `stripe_domestic_processing_fee` | Ancien — des frais pour le traitement national d'un paiement par carte ou LPM via Stripe. |
| `stripe_international_processing_fee` | Ancien — des frais pour le traitement international d'un paiement par carte ou LPM via Stripe. |


## Related topics

- [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md)
- [Présentation de l'API Whop](https://docs.whop.com/fr/api-reference/overview.md)
- [Get Financial Report](https://docs.whop.com/fr/api-reference/ledgers/get-financial-report.md)
