Skip to main content
POST
Suspend a Subaccount

Yetkilendirmeler

Authorization
string
header
gerekli

An Account API key or an account-scoped user token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

company:suspend_child

Başlıklar

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Örnek:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Örnek:

"2026-11-17"

Yol Parametreleri

id
string
gerekli

Subaccount ID, prefixed biz_.

Yanıt

Subaccount suspended.

ads_spend_usd
number | null
gerekli

Lifetime charged ad spend for the account, in USD. Computed only on list for callers with stats:read on the account; null otherwise.

Örnek:

0

balances
object[]
gerekli
banner_image_url
string | null
gerekli

Account banner image URL.

Örnek:

"https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

business_address
object | null
gerekli

Account business address used to calculate tax, with line1, line2, city, state, postal_code, and country. null when no address is set.

Örnek:
business_name
string | null
gerekli

The account's legal business name used with its tax address.

Maximum string length: 255
Örnek:

"Shine Time Auto Detailing, LLC"

business_type
string | null
gerekli

High-level business category for the account. See the business types and industries glossary for valid values.

Örnek:

"software"

can_transfer_pending_balance_to_children
boolean
gerekli

Whether pending funds may be transferred from this platform account to its subaccounts.

Örnek:

false

cancellation_policy
object | null
gerekli

The account's cancellation policy document, or null if they have not published one.

capabilities
object | null
gerekli

Payment rails enabled for this account, each active, inactive, or pending (onboarding or review in progress). Computed only on retrieve and me for callers with company:balance:read scope; null otherwise.

cards
object | null
gerekli

Whop Cards application details for the account. Returned on list, retrieve, and me for callers with company:balance:read scope; null otherwise, or when the account has no card application or blocking application review.

collect_vat_id
boolean
gerekli

Whether checkout shows a VAT/tax ID field for buyers to optionally enter. Does not require a VAT ID to purchase.

Örnek:

false

company_formation
object
gerekli

Company formation state for the account, managed through Form Company. A draft status until the formation checkout is paid, then filing progress with downloadable documents and signatures awaiting action. Empty when the formation state is temporarily unavailable.

country
string | null
gerekli

Country where the account is located.

Örnek:

"us"

created_at
string
gerekli

When the account was created, as an ISO 8601 timestamp.

Örnek:

"2026-01-01T12:00:00.000Z"

customers_l30d
integer | null
gerekli

Distinct customers with a paid receipt at the account in the last 30 days, refreshed every few hours. Computed only on retrieve for callers with stats:read on the account; null otherwise, and when the count is unavailable.

Örnek:

null

description
string | null
gerekli

Account promotional description.

Örnek:

"Mobile ceramic coating, paint correction, and interior detailing across the Austin metro."

dispute_fighter_enabled
boolean
gerekli

Whether Whop assembles and files dispute evidence for this account. Enabling it opts the account into the success fee charged on disputes it wins.

Örnek:

false

economic_intelligence
boolean
gerekli

Whether Economic Intelligence is on for the account. It turns off automatically when its committed period ends. While it is off, the account can't activate an experiment or run a recommendation.

Örnek:

false

email
string | null
gerekli

Account owner email address.

Örnek:

"marcus@shinetime.example"

eula
object | null
gerekli

The account's end-user license agreement document, or null if they have not published one.

external_id
string | null
gerekli

The parent platform's own identifier for this subaccount, unique among the platform's subaccounts. null when unset.

Örnek:

"connected_account_123"

financing
object | null
gerekli

The account's most recent financing application. Computed only on retrieve and me for callers with company:balance:read scope; null otherwise, or when the account has never applied for financing.

funds_release_at
string | null
gerekli

When a suspended account can pay out its balance to its own payout method, as an ISO 8601 timestamp. A dispute can move it later. Computed on retrieve, me, and suspend; null otherwise, when status is not suspended, and when the suspension holds the balance.

Örnek:

null

home_preferences
enum<string>[]
gerekli

Public account home page preferences.

Mevcut seçenekler:
hide_member_count,
hide_members_card
id
string
gerekli

Account ID, prefixed biz_.

Örnek:

"biz_xxxxxxxxxxxxxx"

industry_type
string | null
gerekli

Specific industry vertical for the account. See the business types and industries glossary for valid values.

Örnek:

"trading"

invoice_prefix
string | null
gerekli

Prefix used for account invoices.

Örnek:

"INV"

level
object | null
gerekli

The Whop Levels progress of the account's owner, counted across every account they own, so all of them show the same level. Computed only on retrieve and me for callers with company:basic:read scope; null otherwise, and when the account is not in Whop Levels.

logo_url
string | null
gerekli

Account logo image URL.

Örnek:

"https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

metadata
object
gerekli

Arbitrary key/value metadata supplied at account creation.

Örnek:
onboarding_type
enum<string> | null
gerekli

Type of onboarding the account has completed.

Mevcut seçenekler:
platform,
seller,
null
Örnek:

"platform"

opengraph_image_url
string | null
gerekli

Account Open Graph image URL.

Örnek:

"https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

opengraph_image_variant
enum<string> | null
gerekli

Account Open Graph image variant.

Mevcut seçenekler:
white,
black,
orange,
null
Örnek:

"black"

orchestration_enabled
boolean
gerekli

Whether payment orchestration is enabled for this account.

Örnek:

true

other_business_description
string | null
gerekli

Business type details when business_type is other.

Örnek:

null

other_industry_description
string | null
gerekli

Industry details when industry_type is other.

Örnek:

null

owner
object
gerekli

The single user who owns the account, whose email is the email above. Distinct from the owner role on team members, which any number of them can hold.

parent_account
object | null
gerekli

Parent account for subaccounts, or null for standalone accounts.

payment_controls
object | null
gerekli

Payment health controls currently applied to the account. Computed only on retrieve and me for callers with company:balance:read scope; null otherwise.

payment_method_configuration
object | null
gerekli

The account's default payment methods at checkout. A variant's or checkout configuration's own payment_method_configuration takes precedence. null when the account uses Whop's platform defaults.

platform_credits
object[]
gerekli
privacy_policy
object | null
gerekli

The account's privacy policy document, or null if they have not published one.

product_tax_code
object | null
gerekli

Tax classification code applied by default to the account's products, with id, name, and product_type. null when no default is set.

Örnek:

DEPRECATED: Use the GET /economic_intelligence?account_id={account_id} endpoint instead.

Örnek:

null

require_2fa
boolean
gerekli

Whether authorized users must enable two-factor authentication.

Örnek:

false

required_actions
object[] | null
gerekli
return_policy
object | null
gerekli

The account's return policy document, or null if they have not published one.

route
string
gerekli

Account public route identifier.

Örnek:

"biz_xxxxxxxxxxxxxx"

send_customer_emails
boolean
gerekli

Whether Whop sends transactional emails to customers on behalf of this account.

Örnek:

false

shipping_policy
object | null
gerekli

The account's shipping policy document, or null if they have not published one.

show_joined_whops
boolean
gerekli

Whether the account appears in joined whops on other accounts.

Örnek:

true

show_reviews_dtc
boolean
gerekli

Whether reviews are displayed on direct-to-consumer product pages.

Örnek:

true

show_user_directory
boolean
gerekli

Whether the account shows users in the user directory.

Örnek:

true

status
string | null
gerekli

Whether the account can operate on Whop: active or suspended. Computed on list, retrieve, me, and suspend; null otherwise.

Örnek:

"active"

status_reason
string | null
gerekli

Why the account was suspended, as a label such as Suspended - Fraudulent activity. Suspended when no reason is recorded. Computed on retrieve, me, and suspend. null otherwise, or when status is not suspended.

Örnek:

"Suspended - Fraudulent activity"

store_page_config
object
gerekli

Account store page display configuration.

target_audience
string | null
gerekli

Target audience for this account.

Örnek:

"Owners of new and enthusiast vehicles in Austin, TX"

tax_collection_enabled_states
string[]
gerekli

US state codes (of the 50 states plus DC) where the account collects tax: the full set when Whop remits (tax_remitted_by whop), the configured subset when the account self-remits (self), and empty when neither. On update, send the complete list to replace it (only allowed when self).

tax_identifiers
object[]
gerekli
tax_remitted_by
enum<string> | null
gerekli

Who calculates and remits tax for the account. whop means Whop calculates and remits. self means Whop calculates, and the account collects and remits. none means neither, and the account is responsible. New businesses start on whop, and new connected accounts start on none. null means the account has no setting yet.

Mevcut seçenekler:
whop,
self,
none,
null
Örnek:

"self"

tax_type
enum<string> | null
gerekli

How tax is applied to the account's prices: inclusive (tax included in the listed price) or exclusive (tax added on top). Defaults to exclusive when unset; null only when the account has no payment connection.

Mevcut seçenekler:
inclusive,
exclusive,
null
Örnek:

"inclusive"

terms_of_service
object | null
gerekli

The account's terms of service document, or null if they have not published one.

three_ds_level
enum<string> | null
gerekli

3D Secure behavior for supported on-session card payments. mandate_challenge requires a 3DS challenge before payment processing; mandate_if_required mandates a challenge only when the payment processor requires it; frictionless_if_required uses the regular frictionless 3DS flow. Payments of $1,000 or more use mandate_if_required unless mandate_challenge is selected. Risk and authentication recovery requirements can override the preference. null uses the standard checkout flow.

Mevcut seçenekler:
mandate_challenge,
mandate_if_required,
frictionless_if_required,
null
Örnek:

"mandate_challenge"

title
string
gerekli

Account display name.

Örnek:

"Shine Time Auto Detailing"

total_earned_usd
number | null
gerekli

Account lifetime sales, normalized to USD. Computed only on retrieve and me for callers with stats:read scope; null otherwise.

Örnek:

0

total_usd
string | null
gerekli

Total USD value across balances with known exchange rates. Computed only on single-account reads (retrieve and me); null on list responses, writes, missing balance-read permission, or unavailable balance source.

Örnek:

"50.00"

trading
object | null
gerekli

The trading account address, a snapshot of its margin and open positions, and its WebSocket subscriptions. Opt in with include_trading=true on single-account reads. null otherwise, without trading permission, or without an Ethereum wallet.

use_logo_as_opengraph_image_fallback
boolean
gerekli

Whether the account uses its logo as the fallback Open Graph image.

Örnek:

false

verification
object
gerekli

Account identity verification status for the individual (KYC) and business (KYB) profiles. Each is null until created, otherwise a status of not_started, pending, manual_review, approved, or rejected.

Örnek:
volume_l30d_usd
number | null
gerekli

Volume through the account in the last 30 days (GMV from paid receipts), normalized to USD. Computed only on list for callers with stats:read on the account; null otherwise.

Örnek:

0

volume_usd
number | null
gerekli

Lifetime volume through the account — sales plus transfers received — normalized to USD. Computed only on list for callers with stats:read on the account; null otherwise.

wallet
object | null
gerekli

Account primary crypto wallet, or null if none has been provisioned.

website
string | null
gerekli

The account's business website URL, or null if none has been provided. Setting it also adds a website entry to social_links.

Örnek:

"https://shinetimedetail.com"

direct_reports_count
integer

How many team members report to the business directly, with no manager above them. Present on single-account reads.

Örnek:

0

partner
object | null

The account's active first-tier partner. Present on retrieve responses; null when no active first-tier partner is attributed to the account. Omitted from other responses.

rewards
object[]
whop_partner_enabled_at
string | null

When the account turned on Whop Partner mode, as an ISO 8601 timestamp. Present on single-account reads and update responses; null until the account turns Whop Partner mode on by sending whop_partner_enabled: true on update.

Örnek:

null