latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Create a checkout link

Create a shareable checkout link selling either an existing product price (existing_price), a new price on an existing product (existing_product), or a brand-new product (new_product).

All amounts are integer minor units of the currency (e.g. cents: 1999 = $19.99); the Fanvue dashboard displays the same prices in major units. Requires checkout links to be enabled for the creator.

post/checkout-links

Headers

X-Fanvue-API-Versionstring required

Example:2025-06-26

API version to use for the request

Request body

descriptionstring

Internal note shown only in the creator dashboard. Fans never see it.

redirectUrlstring uri

URL fans are redirected to after a successful purchase.

Response

Checkout link created successfully

uuidstring uuid required

Checkout link UUID

namestring required

Creator-internal label for the link (derived from the product name)

descriptionstring nullable required

Creator-internal note (null when unset). Fans never see it.

urlstring nullable required

Shareable checkout URL fans use to purchase

priceinteger required

Price in integer minor units of the currency (e.g. cents). 0 for free links.

currencystring required

ISO-4217 currency code of the price

isRecurringboolean required

Whether purchases create a recurring subscription

cycleLengthinteger nullable required

Billing cycle length (null for one-off prices)

cycleUnit'day' | 'week' | 'month' | 'year' nullable required

Billing cycle unit (null for one-off prices)

productUuidstring uuid nullable required

UUID of the product the link sells

productPriceUuidstring uuid nullable required

UUID of the product price the link sells

status'active' | 'disabled' required

active links can be purchased; disabled links reject checkout until re-enabled

createdAtstring date-time required

When the link was created