Ledger Activity - Whop Docs

A Ledger Activity row is a single financial event on an account’s ledger — a payment, withdrawal, refund, transfer, on-chain deposit, swap, or card transaction. Each row is derived from the underlying ledger lines and carries a typed resource and source so you can present and link the event without extra lookups. Use Ledger Activity to build a statement or transaction feed for an account or user. Reconcile against your own records with amount (signed, in the currency’s smallest precision units) and posted_at, and use available_at to know when inflows became withdrawable.

Endpoints

Endpoint	Request
List Financial Activity	GET `/financial-activity`

Attributes

string

required

Ledger activity ID.

amount

string

required

Signed amount in the currency’s smallest precision units.

available_at

string | null

required

ISO 8601 timestamp these funds became (or are scheduled to become) withdrawable: the posted time for already-settled funds, or 00:00:00 UTC on the scheduled release date for pending funds. Present only on inflows entering the balance (payments, top-ups, incoming transfers/affiliate); null on withdrawals, refunds, disputes and on-chain rows. The available_after/before filters window on its UTC settlement date.

created_at

string | null

required

When the activity record was created.

currency

object

required

Currency for this ledger activity.

Properties

code

string

required

Currency code.

precision

string

required

Precision factor for the currency, for example 100000000 for USD.

line_type

string

required

Type of ledger activity.

object

string

required

posted_at

string

required

When the activity posted to the ledger.

resource

account or user or bounty or ledger_account or payment_method or payout_method or card_transaction | null

required

Resource associated with this ledger activity.

source

object | null

required

Source of this ledger activity.

Properties

string

required

amount_float

number | null

Withdrawal amount as a decimal number in the destination currency (withdrawal sources only; requires payout:withdrawal:read).

chain

string | null

Chain the deposit landed on, for example plasma (onchain_transaction sources only).

claim_url

string | null

Public claim URL for the airdrop link (airdrop_link sources only).

created_at

string | null

Withdrawal creation time as an ISO 8601 timestamp (withdrawal sources only; requires payout:withdrawal:read).

estimated_arrival

string | null

Estimated arrival as an ISO 8601 timestamp (withdrawal sources only; requires payout:withdrawal:read).

from_amount

string | null

Amount converted out of from_currency as a decimal string (swap sources only).

from_currency

string | null

Lowercase currency code converted from (swap sources only).

object

string

required

payer_name

string | null

Name of the entity processing the payout (withdrawal sources only; requires payout:withdrawal:read).

payout_destination

object | null

Payout destination display info (withdrawal sources only).

Properties

icon_url

string | null

payer_name

string | null

payout_token_nickname

string | null

Saved payout destination nickname (withdrawal sources only).

reason

string | null

Transfer reason on transfer sources, for example pool_top_up or bounty_return.

sender_address

string | null

Sender wallet address or onramp provider identifier (onchain_transaction sources only).

status

string | null

Lifecycle status. On withdrawal sources this is the withdrawal status (requires payout:withdrawal:read); on airdrop_link sources it is the claim-link status (ungated); on payment and top-up sources it is the friendly payment status such as succeeded/pending/failed (ungated).

to_amount

string | null

Amount received in to_currency as a decimal string (swap sources only).

to_currency

string | null

Lowercase currency code converted to (swap sources only).

tx_hash

string | null

On-chain transaction hash (onchain_transaction and swap sources only).

LedgerActivity

{
	"id": "line_cGF5bWVudF9ncm9zczpsaTpwZXRhbHBvc3Q6YWM6bGVkZ2VyOmxlOjE6djppazpyZWNlaXB0",
	"object": "ledger_activity",
	"line_type": "payment_gross",
	"amount": "4800000000",
	"currency": {
		"code": "usd",
		"precision": "100000000"
	},
	"posted_at": "2026-06-14T18:49:49Z",
	"available_at": "2026-06-17T00:00:00Z",
	"created_at": "2026-06-14T18:49:49Z",
	"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"
	}
}

Glossary of line types

Every activity row carries a line_type that names the financial event it represents. Pass one or more line_types to List Financial Activity to filter the feed to specific events — either as repeated line_types[] parameters or as a single comma-separated value (line_types=payment_gross,payment_refund). Unknown line types return a 400. Throughout this glossary, “LPM” means a local payment method (a non-card method such as a bank debit or wallet).

Category	Expands to
`fees`	All processing-fee line types — every entry in the Fees section below.

Payments

Line type	Description
`payment_gross`	A card or LPM sale settling into the wallet — the gross amount before fees.
`topup`	Funds the account added to its own wallet balance, rather than a product sale.
`platform_balance_payment`	A purchase paid for with existing wallet balance instead of an external card or LPM.
`passthrough_gmv`	Recorded GMV for a purchase made through an external processor (Stripe Standard, PayPal, Coinbase Commerce, etc.).
`installment_default`	A charge to the wallet covering a buyer’s defaulted Buy Now, Pay Later installment.

Refunds

Line type	Description
`payment_refund`	A refund of a card or LPM payment, deducted from the wallet.
`payment_refund_reversal`	Reverses a `payment_refund`, returning the funds to the wallet.
`platform_balance_payment_refund`	A refund of a wallet-balance purchase, returned to the original purchaser’s balance.

Disputes

Line type	Description
`payment_dispute`	A chargeback on a card or LPM payment, debited from the wallet.
`payment_dispute_adjustment`	A credit or debit that adjusts a chargeback when the disputed amount differs from the original payment (partial disputes).
`payment_dispute_reversal`	Reverses a `payment_dispute` when the dispute is won.
`platform_covered_dispute`	The portion of a chargeback Whop’s marketplace covers when the sale carried a buyer fee; can be a credit or a debit.
`dispute_hold_adjustment`	Moves funds into or out of a dispute hold — debited when a hold is placed, credited when it is released.

Withdrawals

Line type	Description
`withdrawal`	A payout of wallet funds to an external bank account.
`withdrawal_reversal`	Reverses a withdrawal that was canceled or rejected, returning the funds to the wallet.
`withdrawal_clawback`	A credit to the wallet that recovers funds from the linked bank account to cover a negative balance.
`withdrawal_clawback_reversal`	Reverses a `withdrawal_clawback` when the clawback later fails or is returned by the bank.
`withdrawal_reclassification`	Returns a withdrawal’s net amount to the wallet’s available balance when that payout is reclassified as an internal Whop transfer.

Transfers

Line type	Description
`platform_balance_transfer_outgoing`	A transfer of wallet funds out to another account on the platform.
`platform_balance_transfer_incoming`	A transfer of funds into the wallet from another account on the platform.
`internal_balance_transfer_outgoing`	A transfer out to another wallet owned by the same entity, such as primary to pool; not counted as revenue.
`internal_balance_transfer_incoming`	A transfer in from another wallet owned by the same entity, such as pool funded by parent; not counted as revenue.

Currency conversion

Line type	Description
`currency_conversion_outgoing`	The source-currency debit when wallet balance is converted between currencies.
`currency_conversion_incoming`	The destination-currency credit when wallet balance is converted between currencies.

Line type	Description
`payment_referral`	An affiliate referral bonus the merchant chose to share from a card or LPM payment, credited to the affiliate’s wallet.
`payment_referral_reversal`	Reverses a previously paid referral bonus, debited from the affiliate’s wallet.
`payment_revshare`	A revenue-share amount debited from the seller’s wallet on a payment.
`payment_revshare_payout`	A revenue-share amount credited to an affiliate’s wallet on a payment.
`payment_revshare_reversal`	Reverses a previously paid revenue share, debited from the affiliate’s wallet.
`payment_revshare_refund`	Returns a revenue-share amount to the seller’s wallet when the payment is refunded or disputed.
`application_fee_payout`	A platform fee from a connected-account payment, settled into the parent account.
`platform_affiliate_payment`	A referral bonus for referring an account or buyer to Whop: a share of the processing revenue that account generated.
`platform_affiliate_payment_reversal`	Reverses a `platform_affiliate_payment` that Whop determined was invalid or needed correction.
`ad_publisher_payout_received`	A credit to a publisher’s wallet for ad revenue earned.
`ad_publisher_payout`	A payout of ad revenue, debited from the Whop Ads wallet.
`company_referral`	Legacy: a referral bonus for referring an account to Whop, sharing the processing revenue that account generated.

Airdrops

Line type	Description
`airdrop`	A credit of funds into the wallet at Whop’s expense, typically promotional or to make good on an issue.
`airdrop_reversal`	Reverses an `airdrop` found to be invalid or in need of correction.
`airdrop_link_created`	Debits the wallet to fund a newly created airdrop link.
`airdrop_link_returned`	Returns an airdrop link’s funds to the sender’s available balance when the link is canceled.
`airdrop_link_redeemed`	Credits a claimed airdrop link’s funds into the recipient’s available balance.
`resolution_center_refund`	A refund to a buyer that Whop covers out of pocket after resolving a Resolution Center case in the buyer’s favor.

Advertising

Line type	Description
`ad_campaign_budget`	Earmarks funds for an ad campaign when the campaign is funded.
`ad_spend_charge`	A charge against earmarked campaign funds for ad spend, billed at the marked-up rate.
`ad_budget_release`	Releases unspent campaign budget, typically the first step of a refund or balance return.

Crypto & cards

onchain_deposit is opt-in: it is excluded from the default feed and only returned when you request it explicitly in line_types.

Line type	Description
`onchain_deposit`	An inbound on-chain crypto transfer credited to a Whop-managed wallet (including onramps such as MoonPay). Opt-in — only returned when explicitly requested.
`onchain_wallet_transfer_outgoing`	An outbound on-chain transfer from a Whop-managed crypto wallet to another Whop-managed wallet.
`onchain_wallet_transfer_incoming`	An inbound on-chain transfer to a Whop-managed crypto wallet from another Whop-managed wallet.
`onchain_swap_target`	The received side of an on-chain token swap — the output token credited to the wallet.
`treasury_payin`	A credit to the cash wallet from a treasury pay-in, such as a crypto off-ramp moving stablecoin balance back into cash.
`card_spend_authorization`	A card authorization hold, debited from the card balance when a spend is authorized.
`card_spend_authorization_void`	Returns a card authorization to the card balance when it is voided, expired, or declined after auth.
`card_spend_refund`	A merchant refund credited back to the card balance.

Legacy & miscellaneous

Line type	Description
`legacy_crypto_payment`	A historical Coinbase Commerce payment Whop processed and paid out to the merchant’s wallet.
`legacy_payment`	A historical express-account payment credited directly to the user’s wallet.
`legacy_payment_refund`	Reverses a `legacy_payment`, debiting the merchant’s wallet.
`license_sale`	The merchant payout for a multi-party software license sale — the sale amount net of fees. Commission and revenue shares post separately as `license_sale_commission` and `license_sale_revenue`.
`license_sale_commission`	The commission portion of a software license sale, credited to the commission wallet.
`license_sale_revenue`	The revenue-share portion of a software license sale, credited to the revenue wallet.
`software_rental_revshare`	A revenue-share payout for a software rental, crediting the merchant net of fees.
`software_rental_transaction`	The final settlement of a software rental, crediting the merchant net of fees.
`misc_purchase`	A purchase made directly from Whop, such as legacy software rentals or proxies.
`misc_refund`	A refund of a `misc_purchase`.
`referral_bonus`	A bonus for referring a new user to sign up for whop.com.
`promo_reversal`	A one-time reversal of promotional, non-withdrawable `referral_bonus` balance.
`misc_reversal`	Legacy — a miscellaneous debit for charges negotiated outside the normal transaction lifecycle.

Fees

Line type	Description
`payment_processing_fixed_fee`	A fixed fee (≈$0.30) for processing a card or LPM payment.
`payment_processing_percentage_fee`	A percentage fee, such as 2.7%, for processing a card or LPM payment.
`billing_percentage_fee`	A fee on recurring billing transactions covering subscription management and retries.
`cross_border_percentage_fee`	A fee on cross-border transactions, charged when the buyer is outside the processing region.
`fx_percentage_fee`	A fee for converting a payment processed in a foreign currency at settlement.
`orchestration_percentage_fee`	A fee for routing a payment across multiple PSPs (smart routing and failover).
`revshare_percentage_fee`	A fee for using revenue-share payouts on a payment.
`three_ds_fixed_fee`	A fixed fee for 3DS authentication, charged only when 3DS is required.
`whop_processing_fee`	A platform fee for using whop.com, not tied directly to processing cost.
`fraud_prevention_fee`	A fee for fraud prevention on card or LPM payments.
`buyer_fee`	A buyer fee booked as platform income, posted only when buyer fees are configured as platform revenue.
`sales_tax_fee`	A fee for Whop collecting and remitting sales tax on a payment.
`sales_tax_remittance`	Sales tax collected on a transaction that Whop remits to the tax authority.
`sales_tax_remittance_reversal`	Reverses a `sales_tax_remittance` when a payment is refunded or disputed.
`affiliate_fee`	The portion of a card or LPM payment earmarked to pay an affiliate referral bonus.
`application_fee`	The platform fee from a connected-account payment paid to the parent account.
`payout_fee`	A fee covering the cost of paying out to a bank account.
`payment_dispute_fee`	A fee (≈$15) for receiving a chargeback on a card or LPM payment.
`dispute_alert_fee`	A fee for receiving an early dispute alert on a card or LPM payment.
`stripe_domestic_processing_fee`	Legacy — a fee for processing a card or LPM payment through Stripe domestically.
`stripe_international_processing_fee`	Legacy — a fee for processing a card or LPM payment through Stripe internationally.

​Endpoints

​Attributes

​Glossary of line types

​Categories

​Payments

​Refunds

​Disputes

​Withdrawals

​Transfers

​Currency conversion

​Affiliates & revenue share

​Airdrops

​Advertising

​Crypto & cards

​Legacy & miscellaneous

​Fees

Endpoints

Attributes

Glossary of line types

Categories

Payments

Refunds

Disputes

Withdrawals

Transfers

Currency conversion

Affiliates & revenue share

Airdrops

Advertising

Crypto & cards

Legacy & miscellaneous

Fees