CheckoutLink

June 12, 2026 ยท View on GitHub

Checkout link data.

Fields

FieldTypeRequiredDescriptionExample
idstr:heavy_check_mark:The ID of the object.
created_atdate:heavy_check_mark:Creation timestamp of the object.
modified_atdate:heavy_check_mark:Last modification timestamp of the object.
trial_intervalNullable[models.TrialInterval]:heavy_check_mark:The interval unit for the trial period.
trial_interval_countNullable[int]:heavy_check_mark:The number of interval units for the trial period.
metadataDict[str, models.MetadataOutputType]:heavy_check_mark:N/A
payment_processormodels.PaymentProcessor:heavy_check_mark:N/A
client_secretstr:heavy_check_mark:Client secret used to access the checkout link.
success_urlNullable[str]:heavy_check_mark:URL where the customer will be redirected after a successful payment.
return_urlNullable[str]:heavy_check_mark:When set, a back button will be shown in the checkout to return to this URL.
labelNullable[str]:heavy_check_mark:Optional label to distinguish links internally
allow_discount_codesbool:heavy_check_mark:Whether to allow the customer to apply discount codes. If you apply a discount through discount_id, it'll still be applied, but the customer won't be able to change it.
require_billing_addressbool:heavy_check_mark:Whether to require the customer to fill their full billing address, instead of just the country. Customers in the US will always be required to fill their full address, regardless of this setting.
discount_idNullable[str]:heavy_check_mark:ID of the discount to apply to the checkout. If the discount is not applicable anymore when opening the checkout link, it'll be ignored.
seatsNullable[int]:heavy_check_mark:Preconfigured number of seats for seat-based pricing. When set, checkout sessions created from this link are locked to this number of seats and the customer won't be able to change it. All products on the link must use seat-based pricing and allow this number of seats. If the products no longer accommodate this value when the link is opened, it'll be ignored.
organization_idstr:heavy_check_mark:The organization ID.1dbfc517-0bbf-4301-9ba8-555ca42b9737
productsList[models.CheckoutLinkProduct]:heavy_check_mark:N/A
discountNullable[models.CheckoutLinkDiscount]:heavy_check_mark:N/A
urlstr:heavy_check_mark:N/A