> ## 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 de actividad financiera

> Una fila de actividad financiera es un único movimiento de dinero que entra o sale del saldo de una cuenta o de un usuario: un pago, un retiro, un reembolso, una transferencia, un depósito on-chain, un intercambio o una transacción con tarjeta.

Cada fila incluye un `resource` y un `source` tipados para que puedas presentar y enlazar el evento sin búsquedas adicionales.

Usa la API de actividad financiera para crear un extracto o un feed de transacciones para una cuenta o un usuario, e informes financieros para resumir la actividad del saldo, los ingresos y los saldos en un intervalo de fechas, y luego desglosar el total de un informe en lo que lo originó.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar actividad financiera](https://docs.whop.com/es/api-reference/ledgers/list-financial-activity.md) | GET `/financial_activity` |
| [Obtener informe financiero](https://docs.whop.com/es/api-reference/ledgers/get-financial-report.md) | GET `/financial_reports` |
| [Obtener desglose del informe financiero](https://docs.whop.com/es/api-reference/ledgers/get-financial-report-breakdown.md) | GET `/financial_reports/breakdown` |

## Atributos

**id** `string` *required*

ID de la actividad del libro mayor.

**account** `account or user`

La cuenta del visualizador propietaria del libro mayor de esta fila. Presente solo cuando la respuesta agrega cuentas propias (include\_owned\_accounts=true); se omite en otros casos.

**amount** `string` *required*

Importe con signo en las unidades de precisión más pequeñas de la moneda.

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

Marca de tiempo ISO 8601 de cuándo esta actividad afecta a los fondos disponibles: 00:00:00 UTC en la fecha de liberación programada para créditos y débitos en un grupo de liberación de fondos confirmados pendiente; la hora de contabilización para créditos y débitos a fondos disponibles liquidados, incluidos reembolsos, disputas y retiros. Null para la actividad fuera de estas rutas, incluidas las filas on-chain. Los filtros available\_after/before usan su fecha UTC; la actividad predeterminada excluye algunos movimientos, incluidas las reservas opcionales.

**currency** `object` *required*

Moneda de esta actividad del libro mayor.

> [accordion] Propiedades
>
> **code** `string` *required*
>
> Código de moneda.
>
> **precision** `string` *required*
>
> Factor de precisión de la moneda, por ejemplo `100000000` para USD.

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

La cuenta del libro mayor (un identificador ldgr\_) a la que pertenece esta fila. Presente solo cuando la respuesta agrega cuentas propias (include\_owned\_accounts=true); se omite en otros casos. Combínala con `account` para limitar los paneles laterales y los enlaces del dashboard al negocio propietario.

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

La categoría de línea del libro mayor bajo la que se contabilizó esta actividad.

Opciones 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`

Pago relacionado con esta actividad del libro mayor. Se incluye cuando la hidratación enriquecida de recursos está habilitada y el movimiento está vinculado a un pago.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del pago, con el prefijo `pay_`.
>
> **amount** `object | null` *required*
>
> Total cobrado por el pago.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee durante la transmisión.
> >
> > **currency** `string` *required*
> >
> > Código de moneda ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales MOSTRAR. Normalmente igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa esto para formatear el número en tu propia configuración regional.
>
> **card\_brand** `string | null` *required*
>
> Marca de la tarjeta, cuando el cliente pagó con tarjeta.
>
> **card\_last4** `string | null` *required*
>
> Últimos cuatro dígitos de la tarjeta, cuando el cliente pagó con tarjeta.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el pago.
>
> **object** `string` *required*
>
> **payment\_method\_type** `string | null` *required*
>
> Cómo pagó el cliente, como `card` o `paypal`.
>
> **payment\_processor** `string | null` *required*
>
> Procesador que gestionó el pago, como `stripe`.
>
> **plan** `object | null` *required*
>
> Variante asociada al pago, cuando corresponda.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID de la variante, con el prefijo `plan_`.
> >
> > **name** `string | null` *required*
> >
> > Nombre de la variante.
>
> **product** `object | null` *required*
>
> Producto asociado al pago, cuando corresponda.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID del producto, con el prefijo `prod_`.
> >
> > **name** `string` *required*
> >
> > Nombre del producto.
>
> **user** `object | null` *required*
>
> Cliente asociado al pago. El correo electrónico requiere member:email:read.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID del cliente, con el prefijo `user_`.
> >
> > **email** `string | null` *required*
> >
> > Correo electrónico del cliente, o null sin member:email:read.
> >
> > **name** `string` *required*
> >
> > Nombre visible del cliente.

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

ID del pago para cualquier actividad relacionada con pagos, incluidos reembolsos y disputas.

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

ID de la variante asociada al pago, cuando corresponda.

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

Nombre de la variante asociada al pago, cuando corresponda.

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

Cuándo se contabilizó la actividad en el libro mayor.

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

ID del producto asociado al pago, cuando corresponda.

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

Nombre del producto asociado al pago, cuando corresponda.

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

Recurso asociado a esta actividad del libro mayor.

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

Origen de esta actividad del libro mayor. Las comisiones de margen de la plataforma usan el objeto platform\_fee y el ID de la actividad del libro mayor.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> **amount\_float** `number | null`
>
> Importe del retiro como número decimal en la moneda de destino (solo orígenes de tipo payout; requiere payout:withdrawal:read).
>
> **card\_brand** `string | null`
>
> Marca de la tarjeta usada por el origen del pago.
>
> **chain** `string | null`
>
> Cadena en la que se recibió el depósito, por ejemplo plasma (solo orígenes onchain\_transaction).
>
> **claim\_url** `string | null`
>
> La URL de reclamación del airdrop. Null salvo que el llamante pueda gestionar enlaces de reclamación en la cuenta de financiación o retirar del saldo personal de financiación.
>
> **created\_at** `string | null`
>
> Hora de creación del retiro como marca de tiempo ISO 8601 (solo orígenes de tipo payout; requiere payout:withdrawal:read).
>
> **created\_by\_user** `object | null`
>
> Usuario que solicitó el retiro. Null para retiros generados por el sistema o sin payout:withdrawal:read.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID del usuario, con el prefijo `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nombre visible.
> >
> > **profile\_picture** `object` *required*
> >
> > Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no ha establecido ninguna imagen.
> >
> > > [accordion] Propiedades
> > >
> > > **url** `string` *required*
> > >
> > > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no ha establecido ninguna imagen.
> >
> > **username** `string` *required*
> >
> > Nombre de usuario público.
>
> **estimated\_arrival** `string | null`
>
> Llegada estimada como marca de tiempo ISO 8601 (solo orígenes de tipo payout; requiere payout:withdrawal:read).
>
> **fee\_amount** `object | null`
>
> Comisiones totales del retiro, incluidas las comisiones de margen. Requiere payout:withdrawal:read.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee durante la transmisión.
> >
> > **currency** `string` *required*
> >
> > Código de moneda ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales MOSTRAR. Normalmente igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa esto para formatear el número en tu propia configuración regional.
>
> **fee\_kind** `string | null`
>
> Acción que generó una comisión de margen de la plataforma: deposit, swap, transfer, card\_spend o payout. Presente para platform\_markup\_fee y platform\_markup\_fee\_payout, incluso cuando include\_resource es false. Null cuando la acción de origen no está disponible; se omite en otros tipos de origen.
>
> Opciones disponibles: `payout`, `transfer`, `deposit`, `swap`, `card_spend`
>
> **fee\_type** `string | null`
>
> Si las comisiones del retiro son inclusivas o exclusivas. Requiere payout:withdrawal:read.
>
> Opciones disponibles: `exclusive`, `inclusive`
>
> **from\_amount** `string | null`
>
> Importe convertido desde from\_currency como cadena decimal (solo orígenes de tipo swap).
>
> **from\_currency** `string | null`
>
> Código de moneda en minúsculas desde el que se convirtió (solo orígenes de tipo swap).
>
> **notes** `string | null`
>
> Nota adjunta al origen transfer, payout o bank\_deposit, o null cuando no se proporcionó ninguna (en orígenes de tipo payout requiere payout:withdrawal:read).
>
> **object** `string` *required*
>
> **payer\_name** `string | null`
>
> En orígenes de tipo payout, el nombre de la entidad que procesa el retiro (requiere payout:withdrawal:read). En orígenes de tipo bank\_deposit, el nombre de la cuenta que envió el depósito.
>
> **payment\_amount** `object | null`
>
> Total cobrado por el origen del pago.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee durante la transmisión.
> >
> > **currency** `string` *required*
> >
> > Código de moneda ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales MOSTRAR. Normalmente igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa esto para formatear el número en tu propia configuración regional.
>
> **payment\_method\_type** `string | null`
>
> Método de pago usado por el origen del pago. En orígenes de tipo bank\_deposit, la red de transferencia: `wire`, `ach` o `rtp`.
>
> **payment\_processor** `string | null`
>
> Procesador usado por el origen del pago.
>
> **payout\_amount** `object | null`
>
> Principal del retiro enviado al destino, sin incluir comisiones, en la moneda del retiro. Requiere payout:withdrawal:read.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee durante la transmisión.
> >
> > **currency** `string` *required*
> >
> > Código de moneda ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales MOSTRAR. Normalmente igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa esto para formatear el número en tu propia configuración regional.
>
> **payout\_destination** `object | null`
>
> Información visible del destino del retiro (solo orígenes de tipo payout).
>
> > [accordion] Propiedades
> >
> > **icon\_url** `string | null`
> >
> > **payer\_name** `string | null`
> >
> > **security\_answer** `string | null`
> >
> > La respuesta de seguridad que el comerciante estableció al añadir este método de retiro (por ejemplo, un Interac e-Transfer), necesaria para reclamar el retiro. null cuando el destino no tiene una respuesta personalizada. Requiere payout:destination:read.
>
> **payout\_token\_nickname** `string | null`
>
> Alias guardado del destino del retiro (solo orígenes de tipo payout).
>
> **reason** `string | null`
>
> Por qué se produjo la actividad. En orígenes de tipo transfer es el motivo de la transferencia, por ejemplo pool\_top\_up o bounty\_return. En orígenes de tipo payout explica por qué el retiro se canceló, se denegó o falló (requiere payout:withdrawal:read); null mientras el retiro avanza con normalidad.
>
> **risk\_review\_hold** `boolean | null`
>
> Si este retiro está retenido actualmente para una revisión manual de riesgos (solo orígenes de tipo payout; requiere payout:withdrawal:read).
>
> **sender\_address** `string | null`
>
> En orígenes onchain\_transaction, la dirección de la billetera remitente o el identificador del proveedor de onramp. En orígenes de tipo bank\_deposit, los últimos cuatro dígitos de la cuenta bancaria remitente, como `••••1547`.
>
> **status** `string | null`
>
> Estado del ciclo de vida. En orígenes de tipo payout es el estado del retiro (requiere payout:withdrawal:read); en orígenes airdrop\_link es el estado del enlace de reclamación (sin restricciones); en orígenes de pago y de recarga es el estado de pago legible, como succeeded/pending/failed (sin restricciones); en orígenes de tipo bank\_deposit es succeeded, reversal\_in\_progress o reversed (sin restricciones).
>
> **to\_amount** `string | null`
>
> Importe recibido en to\_currency como cadena decimal (solo orígenes de tipo swap).
>
> **to\_currency** `string | null`
>
> Código de moneda en minúsculas al que se convirtió (solo orígenes de tipo swap).
>
> **trace\_code** `string | null`
>
> Referencia de rastreo bancario del retiro. Requiere payout:withdrawal:read.
>
> **tx\_hash** `string | null`
>
> Hash de la transacción on-chain (solo orígenes onchain\_transaction y swap).

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

Valor en dólares de este movimiento como cadena decimal, con el mismo signo que `amount`. Se convierte a partir del importe contabilizado al tipo de cambio vigente cuando se contabilizó la línea —el mismo precio que usan el gráfico de saldo de la billetera y los informes financieros—, de modo que una fila de cripto también incluye su valor en dólares. `null` para una moneda para la que Whop no tiene tipo de cambio.

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

Correo electrónico del cliente asociado al pago. Requiere member:email:read.

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

ID del cliente asociado al pago.

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

Nombre visible del cliente asociado al pago.

```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"
}
```

## Glosario de tipos de línea

Cada fila de actividad incluye un `line_type` que nombra el evento financiero que representa. Pasa uno o más `line_types` a [Listar actividad financiera](https://docs.whop.com/es/api-reference/ledgers/list-financial-activity.md) para filtrar el feed a eventos específicos, ya sea como parámetros `line_types[]` repetidos o como un único valor separado por comas (`line_types=payment_gross,payment_refund`). Los tipos de línea desconocidos devuelven un `400`.

El término método de pago local (LPM) se refiere a un método que no es tarjeta, incluidos los débitos bancarios, las transferencias bancarias y las billeteras.

### Categorías

En lugar de enumerar tipos de línea individuales, puedes pasar una categoría abreviada. Una categoría se expande a todos los tipos de línea que contiene.

| Categoría | Se expande a |
| - | - |
| `fees` | Todos los tipos de línea de comisiones de procesamiento: cada entrada de la sección [Comisiones](#fees) que aparece más abajo. |

### Pagos

| Tipo de línea | Descripción |
| - | - |
| `payment_gross` | Una venta con tarjeta o LPM que se liquida en la billetera: el importe bruto antes de comisiones. |
| `topup` | Fondos que la cuenta añadió a su propio saldo de billetera, en lugar de una venta de producto. |
| `platform_balance_payment` | Una compra pagada con el saldo existente de la billetera en lugar de con una tarjeta o un LPM externos. |
| `passthrough_gmv` | Valor bruto de mercancía (GMV) registrado para una compra realizada a través de un procesador externo, como Stripe Standard, PayPal o Coinbase Commerce. |
| `installment_default` | Un cargo a la billetera que cubre una cuota impagada de Compra ahora, paga después de un comprador. |

### Reembolsos

| Tipo de línea | Descripción |
| - | - |
| `payment_refund` | Un reembolso de un pago con tarjeta o LPM, deducido de la billetera. |
| `payment_refund_reversal` | Revierte un `payment_refund` y devuelve los fondos a la billetera. |
| `platform_balance_payment_refund` | Un reembolso de una compra con saldo de billetera, devuelto al saldo del comprador original. |

### Disputas

| Tipo de línea | Descripción |
| - | - |
| `payment_dispute` | Un contracargo sobre un pago con tarjeta o LPM, debitado de la billetera. |
| `payment_dispute_adjustment` | Un crédito o débito que ajusta un contracargo cuando el importe disputado difiere del pago original (disputas parciales). |
| `payment_dispute_reversal` | Revierte un `payment_dispute` después de que el comerciante gane la disputa. |
| `platform_covered_dispute` | La parte de un contracargo que cubre el marketplace de Whop cuando la venta incluía una comisión al comprador. Puede ser un crédito o un débito. |
| `dispute_hold_adjustment` | Mueve fondos hacia o desde una retención por disputa. Un débito aplica la retención y un crédito la libera. |

### Reservas

| Tipo de línea | Descripción |
| - | - |
| `psp_reserve_hold` | Un procesador de pagos retiene en reserva parte de una liquidación, de modo que esos fondos no están disponibles hasta que se liberan. |
| `psp_reserve_release` | Un procesador de pagos devuelve fondos de reserva retenidos previamente al saldo de liquidación disponible. |

### Retiros

| Tipo de línea | Descripción |
| - | - |
| `withdrawal` | Un retiro de fondos de la billetera a una cuenta bancaria externa (el tipo de línea conserva su nombre histórico). |
| `withdrawal_reversal` | Revierte un retiro cancelado o rechazado y devuelve los fondos a la billetera. |
| `withdrawal_clawback` | Un crédito a la billetera que recupera fondos de la cuenta bancaria vinculada para cubrir un saldo negativo. |
| `withdrawal_clawback_reversal` | Revierte un `withdrawal_clawback` cuando la recuperación falla posteriormente o el banco devuelve los fondos. |
| `withdrawal_reclassification` | Devuelve el importe neto de un retiro al saldo disponible de la billetera cuando Whop lo reclasifica como transferencia interna. |

### Transferencias

| Tipo de línea | Descripción |
| - | - |
| `platform_balance_transfer_outgoing` | Una transferencia de fondos de la billetera a otra cuenta de la plataforma. |
| `platform_balance_transfer_incoming` | Una transferencia de fondos a la billetera desde otra cuenta de la plataforma. |
| `internal_balance_transfer_outgoing` | Una transferencia saliente a otra billetera propiedad de la misma entidad, como de la principal a un pool. No cuenta como ingreso. |
| `internal_balance_transfer_incoming` | Una transferencia entrante desde otra billetera propiedad de la misma entidad, como una transferencia de una billetera principal a una billetera de pool. No cuenta como ingreso. |

### Conversión de moneda

| Tipo de línea | Descripción |
| - | - |
| `currency_conversion_outgoing` | El débito en la moneda de origen que se crea cuando la billetera convierte un saldo entre monedas. |
| `currency_conversion_incoming` | El crédito en la moneda de destino que se crea cuando la billetera convierte un saldo entre monedas. |

### Afiliados y reparto de ingresos

| Tipo de línea | Descripción |
| - | - |
| `payment_referral` | Una bonificación por referido de afiliado que el comerciante decidió compartir de un pago con tarjeta o LPM, abonada en la billetera del afiliado. |
| `payment_referral_reversal` | Revierte una bonificación por referido pagada previamente, debitada de la billetera del afiliado. |
| `payment_revshare` | Un importe de reparto de ingresos debitado de la billetera del vendedor en un pago. |
| `payment_revshare_payout` | Un importe de reparto de ingresos abonado en la billetera de un afiliado en un pago. |
| `payment_revshare_reversal` | Revierte un reparto de ingresos pagado previamente, debitado de la billetera del afiliado. |
| `payment_revshare_refund` | Devuelve un importe de reparto de ingresos a la billetera del vendedor después de un reembolso o una disputa. |
| `application_fee_payout` | Una comisión de plataforma de un pago de una subcuenta, liquidada en la cuenta principal. |
| `platform_affiliate_payment` | Una bonificación por referir una cuenta o un comprador a Whop: una parte de los ingresos de procesamiento que generó esa cuenta. |
| `platform_affiliate_payment_reversal` | Revierte un `platform_affiliate_payment` que Whop determinó que no era válido o necesitaba corrección. |
| `ad_publisher_payout_received` | Un crédito a la billetera de un editor por los ingresos publicitarios obtenidos. |
| `ad_publisher_payout` | Un pago de ingresos publicitarios, debitado de la billetera de Whop Ads. |
| `company_referral` | Heredado: una bonificación por referir una cuenta a Whop, que comparte los ingresos de procesamiento que generó esa cuenta. |

### Airdrops

| Tipo de línea | Descripción |
| - | - |
| `airdrop` | Un abono de fondos en la billetera a cargo de Whop, normalmente promocional o para compensar un problema. |
| `airdrop_reversal` | Revierte un `airdrop` que se determinó no válido o que necesita corrección. |
| `airdrop_link_created` | Debita la billetera para financiar un enlace de airdrop recién creado. |
| `airdrop_link_returned` | Devuelve los fondos de un enlace de airdrop al saldo disponible del remitente después de que el remitente cancele el enlace. |
| `airdrop_link_redeemed` | Abona los fondos de un enlace de airdrop reclamado en el saldo disponible del destinatario. |
| `resolution_center_refund` | Un reembolso a un comprador que Whop cubre de su bolsillo después de resolver un caso del Centro de resoluciones a favor del comprador. |

### Publicidad

| Tipo de línea | Descripción |
| - | - |
| `ad_campaign_budget` | Reserva fondos para una campaña publicitaria al financiar la campaña. |
| `ad_spend_charge` | Un cargo a los fondos reservados de la campaña por el gasto publicitario, facturado a la tarifa con margen. |
| `ad_budget_release` | Libera el presupuesto de campaña no gastado, normalmente el primer paso de un reembolso o de una devolución de saldo. |

### Activos on-chain y tarjetas

> [!NOTE]
>
> `onchain_deposit` es opcional: se excluye del feed predeterminado y solo se devuelve cuando lo solicitas explícitamente en `line_types`.

| Tipo de línea | Descripción |
| - | - |
| `onchain_deposit` | Una transferencia cripto on-chain entrante abonada en una billetera gestionada por Whop (incluidos onramps como MoonPay). Opcional: solo se devuelve cuando se solicita explícitamente. |
| `onchain_wallet_transfer_outgoing` | Una transferencia on-chain saliente desde una billetera cripto gestionada por Whop a otra billetera gestionada por Whop. |
| `onchain_wallet_transfer_incoming` | Una transferencia on-chain entrante a una billetera cripto gestionada por Whop desde otra billetera gestionada por Whop. |
| `onchain_swap_target` | El lado recibido de un intercambio de tokens on-chain: el token de salida abonado en la billetera. |
| `treasury_payin` | Un crédito a la billetera de efectivo procedente de un ingreso de tesorería, como un off-ramp cripto que devuelve un saldo cripto a efectivo. |
| `card_spend_authorization` | Una retención por autorización de tarjeta que debita el saldo de la tarjeta cuando el emisor autoriza una compra. |
| `card_spend_authorization_void` | Devuelve una autorización de tarjeta al saldo de la tarjeta cuando se anula, caduca o se rechaza después de la autorización. |
| `card_spend_refund` | Un reembolso del comerciante abonado de nuevo en el saldo de la tarjeta. |

### Heredados y varios

| Tipo de línea | Descripción |
| - | - |
| `legacy_crypto_payment` | Un pago histórico de Coinbase Commerce que Whop procesó y pagó a la billetera del comerciante. |
| `legacy_payment` | Un pago histórico de cuenta express abonado directamente en la billetera del usuario. |
| `legacy_payment_refund` | Revierte un `legacy_payment`, debitando la billetera del comerciante. |
| `license_sale` | El pago al comerciante por una venta de licencia de software con varias partes: el importe de la venta descontadas las comisiones. Las comisiones y los repartos de ingresos usan los tipos de línea distintos `license_sale_commission` y `license_sale_revenue`. |
| `license_sale_commission` | La parte de comisión de una venta de licencia de software, abonada en la billetera de comisiones. |
| `license_sale_revenue` | La parte de reparto de ingresos de una venta de licencia de software, abonada en la billetera de ingresos. |
| `software_rental_revshare` | Un pago de reparto de ingresos por un alquiler de software, que abona al comerciante el importe neto de comisiones. |
| `software_rental_transaction` | La liquidación final de un alquiler de software, que abona al comerciante el importe neto de comisiones. |
| `misc_purchase` | Una compra realizada directamente a Whop, por ejemplo un alquiler de software heredado o un proxy. |
| `misc_refund` | Un reembolso de un `misc_purchase`. |
| `referral_bonus` | Una bonificación por referir a un nuevo usuario para que se registre en whop.com. |
| `promo_reversal` | Una reversión única de saldo promocional no retirable de `referral_bonus`. |
| `misc_reversal` | Heredado: un débito misceláneo por cargos negociados fuera del ciclo de vida normal de las transacciones. |

### Comisiones

| Tipo de línea | Descripción |
| - | - |
| `payment_processing_fixed_fee` | Una comisión fija (≈\$0.30) por procesar un pago con tarjeta o LPM. |
| `payment_processing_percentage_fee` | Una comisión porcentual, como el 2.7 %, por procesar un pago con tarjeta o LPM. |
| `billing_percentage_fee` | Una comisión sobre las transacciones de facturación recurrente que cubre la gestión de suscripciones y los reintentos. |
| `cross_border_percentage_fee` | Una comisión sobre las transacciones transfronterizas, que se cobra cuando el comprador está fuera de la región de procesamiento. |
| `fx_percentage_fee` | Una comisión por convertir en la liquidación un pago procesado en moneda extranjera. |
| `orchestration_percentage_fee` | Una comisión por enrutar un pago a través de varios PSP (enrutamiento inteligente y conmutación por error). |
| `revshare_percentage_fee` | Una comisión por usar pagos de reparto de ingresos en un pago. |
| `three_ds_fixed_fee` | Una comisión fija por la autenticación 3DS, que solo se cobra cuando el checkout requiere 3DS. |
| `whop_processing_fee` | Una comisión de plataforma por usar whop.com, no vinculada directamente al coste de procesamiento. |
| `fraud_prevention_fee` | Una comisión por la prevención del fraude en pagos con tarjeta o LPM. |
| `buyer_fee` | Una comisión al comprador registrada como ingreso de la plataforma. Solo se contabiliza cuando la configuración trata las comisiones al comprador como ingresos de la plataforma. |
| `sales_tax_fee` | Una comisión por que Whop recaude e ingrese el impuesto sobre las ventas de un pago. |
| `sales_tax_remittance` | Impuesto sobre las ventas recaudado en una transacción que Whop ingresa a la autoridad fiscal. |
| `sales_tax_remittance_reversal` | Revierte un `sales_tax_remittance` después de que alguien reembolse o dispute un pago. |
| `affiliate_fee` | La parte de un pago con tarjeta o LPM reservada para pagar una bonificación por referido de afiliado. |
| `application_fee` | La comisión de plataforma de un pago de una subcuenta pagada a la cuenta principal. |
| `payout_fee` | Una comisión que cubre el coste de realizar un retiro a una cuenta bancaria. |
| `payment_dispute_fee` | Una comisión (≈\$15) por recibir un contracargo sobre un pago con tarjeta o LPM. |
| `dispute_alert_fee` | Una comisión por recibir una alerta temprana de disputa sobre un pago con tarjeta o LPM. |
| `stripe_domestic_processing_fee` | Heredado: una comisión por procesar un pago con tarjeta o LPM a través de Stripe a nivel nacional. |
| `stripe_international_processing_fee` | Heredado: una comisión por procesar un pago con tarjeta o LPM a través de Stripe a nivel internacional. |


## Related topics

- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
- [API de Events](https://docs.whop.com/es/api-reference/events/event.md)
- [API de People](https://docs.whop.com/es/api-reference/people/person.md)
