Skip to main content
POST
/
checkout_configurations
JavaScript
import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

const checkoutConfiguration = await client.checkoutConfigurations.create({
  plan: { company_id: 'biz_xxxxxxxxxxxxxx', currency: 'usd' },
});

console.log(checkoutConfiguration.id);
{
  "id": "ch_xxxxxxxxxxxxxxx",
  "company_id": "<string>",
  "plan": {
    "id": "plan_xxxxxxxxxxxxx",
    "billing_period": 42,
    "expiration_days": 42,
    "initial_price": 6.9,
    "renewal_price": 6.9,
    "trial_period_days": 42,
    "adaptive_pricing_enabled": true
  },
  "affiliate_code": "<string>",
  "metadata": {},
  "redirect_url": "<string>",
  "purchase_url": "<string>",
  "allow_promo_codes": true,
  "payment_method_configuration": {
    "enabled": [],
    "disabled": [],
    "include_platform_defaults": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.whop.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Body

application/json

Autogenerated input type of CreateCheckoutSession

​
plan
object
required

The plan attributes to create a new plan inline for this checkout configuration.

​
affiliate_code
string | null

An affiliate tracking code to attribute the checkout to a specific affiliate.

​
allow_promo_codes
boolean | null

Whether the checkout should show the promo code input field and accept promo codes. Defaults to true.

​
checkout_styling
object

Checkout styling overrides for this session. Overrides plan and company defaults.

​
currency
enum<string> | null

The currency for the checkout when in setup mode. Controls which currency-specific payment methods are available. Defaults to USD when in setup mode.

Available options:
usd,
sgd,
inr,
aud,
brl,
cad,
dkk,
eur,
nok,
gbp,
sek,
chf,
hkd,
huf,
jpy,
mxn,
myr,
pln,
czk,
nzd,
aed,
eth,
ape,
cop,
ron,
thb,
bgn,
idr,
dop,
php,
try,
krw,
twd,
vnd,
pkr,
clp,
uyu,
ars,
zar,
dzd,
tnd,
mad,
kes,
kwd,
jod,
all,
xcd,
amd,
bsd,
bhd,
bob,
bam,
khr,
crc,
xof,
egp,
etb,
gmd,
ghs,
gtq,
gyd,
ils,
jmd,
mop,
mga,
mur,
mdl,
mnt,
nad,
ngn,
mkd,
omr,
pyg,
pen,
qar,
rwf,
sar,
rsd,
lkr,
tzs,
ttd,
uzs,
rub,
btc,
cny,
usdt,
kzt,
awg,
whop_usd,
xau
​
metadata
object

Custom key-value metadata to attach to the checkout configuration.

​
mode
string
Allowed value: "payment"
​
payment_method_configuration
object

The explicit payment method configuration for the checkout session. Only applies to setup mode. If not provided, the platform or company defaults will apply.

​
redirect_url
string | null

The URL to redirect the user to after checkout is completed.

​
source_url
string | null

The URL of the page where the checkout is being initiated from.

Response

A successful response

A checkout configuration is a reusable configuration for a checkout, including the plan, affiliate, and custom metadata. Payments and memberships created from a checkout session inherit its metadata.

​
id
string
required

The unique identifier for the checkout session.

Example:

"ch_xxxxxxxxxxxxxxx"

​
company_id
string
required

The ID of the company to use for the checkout configuration

​
mode
enum<string>
required

The mode of the checkout session.

Available options:
payment,
setup
​
currency
enum<string> | null
required

The currency to use for the configuration when in 'setup' mode. This is used to target which currency specific payment methods are available. If not provided, it will default to 'usd' when in setup mode.

Available options:
usd,
sgd,
inr,
aud,
brl,
cad,
dkk,
eur,
nok,
gbp,
sek,
chf,
hkd,
huf,
jpy,
mxn,
myr,
pln,
czk,
nzd,
aed,
eth,
ape,
cop,
ron,
thb,
bgn,
idr,
dop,
php,
try,
krw,
twd,
vnd,
pkr,
clp,
uyu,
ars,
zar,
dzd,
tnd,
mad,
kes,
kwd,
jod,
all,
xcd,
amd,
bsd,
bhd,
bob,
bam,
khr,
crc,
xof,
egp,
etb,
gmd,
ghs,
gtq,
gyd,
ils,
jmd,
mop,
mga,
mur,
mdl,
mnt,
nad,
ngn,
mkd,
omr,
pyg,
pen,
qar,
rwf,
sar,
rsd,
lkr,
tzs,
ttd,
uzs,
rub,
btc,
cny,
usdt,
kzt,
awg,
whop_usd,
xau
​
plan
object
required

The plan to use for the checkout configuration

​
affiliate_code
string | null
required

The affiliate code to use for the checkout configuration

​
metadata
object
required

The metadata to use for the checkout configuration

​
redirect_url
string | null
required

The URL to redirect the user to after the checkout configuration is created

​
purchase_url
string
required

A URL you can send to customers to complete a checkout. It looks like /checkout/plan_xxxx?session={id}

​
allow_promo_codes
boolean
required

Whether the checkout configuration allows promo codes. When false, the promo code input is hidden and promo codes are rejected.

​
payment_method_configuration
object
required

The explicit payment method configuration for the session, if any. This currently only works in 'setup' mode. Use the plan's payment_method_configuration for payment method.