Preferred Settlement Currency

Set a preferred settlement currency to put all new revenue into one balance. Whop converts each new sale into that currency when the buyer pays, so you don’t convert small balances before a payout.

	Original currency (default)	Preferred settlement currency
Where a sale settles	A balance in the plan’s currency	A balance in the currency you choose
Balances to manage	One for each plan currency	One
Extra fee	None	0.5% on each converted sale

Choose a currency

Dashboard
API

In your dashboard settings, select Payments.
Under Preferred settlement currency, select a currency in Settle every new sale in.
Select Save changes.

Send a lowercase currency code to Update Account Preferences. Send null to turn the setting off.

import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

const preferences = await client.accounts.preferences.update({
	account_id: "biz_xxxxxxxxxxxxx",
	preferred_settlement_currency: "usd",
});

console.log(preferences.preferred_settlement_currency_changeable_at);

import os

from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

preferences = client.accounts.preferences.update(
    account_id="biz_xxxxxxxxxxxxx",
    preferred_settlement_currency="usd",
)

print(preferences.preferred_settlement_currency_changeable_at)

require "whop_sdk"

client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))

preferences = client.accounts.preferences.update(
  account_id: "biz_xxxxxxxxxxxxx",
  preferred_settlement_currency: "usd"
)

puts preferences.preferred_settlement_currency_changeable_at

curl -X PATCH "https://api.whop.com/api/v1/accounts/biz_xxxxxxxxxxxxx/preferences" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "preferred_settlement_currency": "usd" }'

The response returns the account’s preferences:

{
	"preferred_settlement_currency": "usd",
	"preferred_settlement_currency_changeable_at": "2026-10-22T14:03:11.000Z"
}

A change applies only to new sales. Money already in your balances stays in its currency.

Know which sales convert

A sale converts when its plan’s currency isn’t your preferred currency. The currency that the buyer pays in doesn’t change this. These sales never convert:

Sales on plans already in your preferred currency.
App Store purchases. Apple pays them in USD.
Sales that settle outside your Whop balance, such as sales through a Stripe account that you connected.

Whop sets the exchange rate when the buyer pays and stores it on the payment. The setting has no effect on the buyer. The buyer pays the price shown at checkout, and the receipt shows that amount.

Fee structure

Each converted sale has a 0.5% fee. Your usual fees also apply. The payment shows the 0.5% on the Currency conversion line. Whop doesn’t charge the 0.5% when the buyer pays in a currency other than the plan’s. Adaptive pricing already charges for that conversion at checkout. These examples use USD as the preferred currency:

Plan currency	Buyer pays in	Settles in	0.5% fee
USD	USD or EUR	USD	No. The plan is already in USD.
GBP	GBP	USD	Yes
GBP	EUR or USD	USD	No. The buyer paid in another currency.
MXN	MXN	USD	Yes
GBP, App Store	GBP	USD	No. Apple pays in USD.

Refunds and disputes

A refund or dispute comes out of the balance that the sale settled in.

Refunds use the exchange rate stored on the payment. A rate change after the sale doesn’t change the amount.
Disputes use the exchange rate on the day that the dispute opens. The amount can differ from the converted sale.

Platforms and connected accounts

The setting applies only to the account that sets it. A connected account doesn’t get its platform’s setting, and a platform doesn’t get its connected accounts’ settings. Your application fees follow your setting. Whop converts each fee into your currency at the exchange rate on the day of the sale. The connected account’s share follows the connected account’s setting. Whop charges you 0.5% on a converted application fee. Whop doesn’t charge the 0.5% when the sale’s plan is already in your currency.

Read amounts on a payment

A payment gives amounts in two currencies. Each amount includes its own currency.

Fields	Currency	Use for
`total`, `subtotal`, `tax_amount`, `refunded_amount`, `amount_after_fees`	The settlement currency	Balances, payouts, and ledger reconciliation
`presentment_total`, `presentment_tax_amount`, `presentment_refunded_amount`	The currency the buyer paid in	Order totals, receipts, and customer emails

To match a payment to an order in your system, compare presentment_total. The setting doesn’t change it. presentment_total doesn’t include buyer fees. Payment webhooks send the same fields.

Preferred Settlement Currency

Choose a currency

Know which sales convert

Fee structure

Refunds and disputes

Platforms and connected accounts

Read amounts on a payment

Next steps

Account Preferences reference

Adaptive pricing

​Choose a currency

​Know which sales convert

​Fee structure

​Refunds and disputes

​Platforms and connected accounts

​Read amounts on a payment

​Next steps

Account Preferences reference

Adaptive pricing

Choose a currency

Know which sales convert

Fee structure

Refunds and disputes

Platforms and connected accounts

Read amounts on a payment

Next steps