v6

latestOpenAPI 3.1.02026-07-311856741.1 MB

checkout-links

public

Get Checkout Link

Get a checkout link by ID.

Scopes: checkout_links:read checkout_links:write

get/v1/checkout-links/{id}

Path parameters

idstring uuid4 required

The checkout link ID.

Response

Successful Response

idstring uuid4 required

The ID of the object.

created_atstring date-time required

Creation timestamp of the object.

modified_atstring date-time nullable required

Last modification timestamp of the object.

trial_interval'day' | 'week' | 'month' | 'year' required

trial_interval_countinteger nullable required

The number of interval units for the trial period.

metadataMetadataOutputType required

payment_processor'stripe' required

client_secretstring required

Client secret used to access the checkout link.

success_urlstring nullable required

URL where the customer will be redirected after a successful payment.

return_urlstring nullable required

When set, a back button will be shown in the checkout to return to this URL.

labelstring nullable required

Optional label to distinguish links internally

allow_discount_codesboolean required

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_addressboolean required

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_idstring uuid4 nullable required

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.

seatsinteger nullable required

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_idstring uuid4 required

The organization ID.

urlstring required