Update Account
Updates an account. User tokens can update business accounts; Account API keys can update subaccounts.
Autorisaties
An Account API key, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Padparameters
Body
Account banner image, used as the cover photo when creating a Whop-managed Facebook page. Image files up to 10 MB, except image/gif. Pass a JSON object containing an id from Create File.
The account's cancellation policy document. Attached to new disputes as the cancellation policy evidence, with the terms of service as the fallback. PDF only. Pass a JSON object containing an id from Create File, or null to remove it.
The account's end-user license agreement document. PDF only. Pass a JSON object containing an id from Create File, or null to remove it.
Account logo, used as the profile picture when creating a Whop-managed Facebook page. Image files up to 5 MB. Pass a JSON object containing an id from Create File.
Open Graph preview media used when the account is shared. Image and video files up to 5 MB. Pass a JSON object containing an id from Create File.
The account's privacy policy document. PDF only. Pass a JSON object containing an id from Create File, or null to remove it.
ID of the tax classification code applied by default to the account's products. See the available product categories.
"ptc_xxxxxxxxxxxxxx"
The account's return and refund policy document. Attached to new disputes as the refund policy evidence, with the terms of service as the fallback. PDF only. Pass a JSON object containing an id from Create File, or null to remove it.
The account's shipping policy document. Sent with physical-goods dispute evidence. PDF only. Pass a JSON object containing an id from Create File, or null to remove it.
US state codes (50 states plus DC) where the account collects tax. Replaces the full set on update. Only settable when tax_remitted_by is self.
AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY The account's terms of service document. Attached to new disputes as the cancellation policy evidence when no cancellation policy is set. PDF only. Pass a JSON object containing an id from Create File, or null to remove it.
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.
mandate_challenge, mandate_if_required, frictionless_if_required, null "mandate_challenge"
Respons
account updated
High-level business category for the account. See the business types and industries glossary for valid values.
"software"
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.
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.
null
Specific industry vertical for the account. See the business types and industries glossary for valid values.
"trading"
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).
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.
whop, self, none, null "self"
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.
inclusive, exclusive, null "inclusive"
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.
mandate_challenge, mandate_if_required, frictionless_if_required, null "mandate_challenge"

