Sign in
checkout-links
public

Create Checkout Link

Create a checkout link.

Scopes: checkout_links:write

post/v1/checkout-links/

Request body

OR
OR

Response

Checkout link created.

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

Changes

Changed in 1 of the 11 revisions of this API.4

  • 8ae937367e874See the full diff
    • ○

      added the required property discount/anyOf[subschema #1: CheckoutLinkDiscount]/oneOf[subschema #1: DiscountFixedOnceForeverDurationBase]/max_redemptions_per_customer to the response with the 201 status

      response-required-property-added

    • ○

      added the required property discount/anyOf[subschema #1: CheckoutLinkDiscount]/oneOf[subschema #2: DiscountFixedRepeatDurationBase]/max_redemptions_per_customer to the response with the 201 status

      response-required-property-added

    • ○

      added the required property discount/anyOf[subschema #1: CheckoutLinkDiscount]/oneOf[subschema #3: DiscountPercentageOnceForeverDurationBase]/max_redemptions_per_customer to the response with the 201 status

      response-required-property-added

    • ○

      added the required property discount/anyOf[subschema #1: CheckoutLinkDiscount]/oneOf[subschema #4: DiscountPercentageRepeatDurationBase]/max_redemptions_per_customer to the response with the 201 status

      response-required-property-added