Skip to main content
PATCH
Update Account Fees

Authorizations

Authorization
string
header
required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-09-15"

Path Parameters

account_id
string
required

Account ID, prefixed biz_.

Body

application/json
ads
object

The fields of a fee the caller may change. Only the keys sent are replaced.

bank_deposit
object

The fields of a fee the caller may change. Only the keys sent are replaced.

billing
object

The fields of a fee the caller may change. Only the keys sent are replaced.

buyer
object

The fields of a fee the caller may change. Only the keys sent are replaced.

card_processing
object

The fields of a fee the caller may change. Only the keys sent are replaced.

child_markups
object

This platform's default markups for every account connected to it.

cross_border
object

The fields of a fee the caller may change. Only the keys sent are replaced.

dispute
object

The fields of a fee the caller may change. Only the keys sent are replaced.

dispute_alert
object

The fields of a fee the caller may change. Only the keys sent are replaced.

dispute_alert_cdrn
object

The fields of a fee the caller may change. Only the keys sent are replaced.

dispute_alert_ethoca
object

The fields of a fee the caller may change. Only the keys sent are replaced.

dispute_alert_rdr
object

The fields of a fee the caller may change. Only the keys sent are replaced.

dispute_representment
object

The fields of a fee the caller may change. Only the keys sent are replaced.

foreign_exchange
object

The fields of a fee the caller may change. Only the keys sent are replaced.

fraud_screening
object

The fields of a fee the caller may change. Only the keys sent are replaced.

high_risk
object

The fields of a fee the caller may change. Only the keys sent are replaced.

marketplace
object

The fields of a fee the caller may change. Only the keys sent are replaced.

markups
object

Markups on this connected account, set by the platform it is connected to.

notes
string

Why the fees are changing, recorded with the change. Required when a Whop Verified Partner edits the fee schedule; ignored for markups.

Example:

"Risk review"

orchestration
object

The fields of a fee the caller may change. Only the keys sent are replaced.

payment_methods
object

Changes to non-card payment method fees, keyed by payment method type.

payouts
object

Changes to withdrawal fees, keyed by payout method.

pending_auto_topup
object

The fields of a fee the caller may change. Only the keys sent are replaced.

platform_processing
object

The fields of a fee the caller may change. Only the keys sent are replaced.

pool_payout
object

The fields of a fee the caller may change. Only the keys sent are replaced.

revshare
object

The fields of a fee the caller may change. Only the keys sent are replaced.

tax_calculation
object

The fields of a fee the caller may change. Only the keys sent are replaced.

tax_service
object

The fields of a fee the caller may change. Only the keys sent are replaced.

three_ds
object

The fields of a fee the caller may change. Only the keys sent are replaced.

transfers
object

The fields of a fee the caller may change. Only the keys sent are replaced.

Response

fees updated

account_id
string
required

The account these fees are charged to, prefixed biz_.

Example:

"biz_xxxxxxxxxxxxxx"

ads
object
required

Charged on Whop Ads spend.

bank_deposit
object
required

Charged on bank deposits into the account's balance.

billing
object
required

Charged on recurring billing.

buyer
object
required

Charged to the buyer at checkout, on top of the price.

card_processing
object
required

Card payments. percentage and fixed are the rate in the headline region; every other acquirer region is under regions.

child_markups
object | null
required

The default markups this account charges the accounts connected to it. null unless the account is a platform.

cross_border
object
required

Added to a payment whose card was issued outside the region where the payment was processed.

dispute
object
required

Charged when a payment is disputed.

dispute_alert
object
required

Charged when an early dispute alert lets Whop refund a payment before it becomes a dispute.

dispute_alert_cdrn
object
required

The early dispute alert fee when the alert comes through Verifi CDRN.

dispute_alert_ethoca
object
required

The early dispute alert fee when the alert comes through Ethoca.

dispute_alert_rdr
object
required

The early dispute alert fee when the alert comes through Verifi RDR.

dispute_representment
object
required

Charged on the amount recovered when Whop fights a dispute and wins.

foreign_exchange
object
required

Added to a payment settled in a currency other than the one it was charged in.

fraud_screening
object
required

Charged when a payment is screened for fraud.

high_risk
object
required

Added to every payment while the account is classed as high risk.

marketplace
object
required

Charged on payments attributed to the Whop marketplace.

markups
object | null
required

What the platform this account is connected to adds on top of Whop's fees, collected by that platform. null unless the account has a parent.

orchestration
object
required

Charged on payments routed through Whop's payment orchestration.

parent_account_id
string | null
required

The platform this account is connected to, whose markups appear under markups. null for a standalone account.

Example:

"biz_xxxxxxxxxxxxxx"

payment_methods
object
required

Processing fees for every non-card payment method the platform prices, keyed by payment method type such as us_bank_account or klarna.

Example:
payouts
object
required

Fees on withdrawals, keyed by payout method: bank_wire, same_day_bank, next_day_bank, rtp, crypto, and digital_wallet.

Example:
pending_auto_topup
object
required

Charged on a Whop Ads auto top-up that is funded from pending balance.

platform_processing
object
required

Whop's share of every payment, on top of card processing.

pool_payout
object
required

Charged on payouts from a shared pool balance.

revshare
object
required

Charged on revenue shared with the account.

tax_calculation
object
required

Charged when tax is calculated on a payment.

tax_service
object
required

Charged when Whop collects and remits tax on the account's behalf.

three_ds
object
required

Charged when a payment is authenticated with 3-D Secure.

transfers
object
required

Charged on transfers from the account's balance to another Whop balance.