v6

latestOpenAPI 3.1.02026-07-311856741.1 MB

checkouts

public

Confirm Checkout Session from Client

Confirm a checkout session by client secret.

Orders and subscriptions will be processed.

post/v1/checkouts/client/{client_secret}/confirm

Path parameters

client_secretstring required

The checkout session client secret.

Request body

custom_field_dataobject

Key-value object storing custom field values.

product_idstring uuid4 nullable

ID of the product to checkout. Must be present in the checkout's product list.

product_price_idstring uuid4 nullable

ID of the product price to checkout. Must correspond to a price present in the checkout's product list.

amountinteger nullable

Amount in cents, before discounts and taxes. Only useful for custom prices, it'll be ignored for fixed and free prices.

seatsinteger nullable

Number of seats for seat-based pricing.

is_business_customerboolean nullable

customer_namestring nullable

The name of the customer.

customer_emailstring email nullable

Email address of the customer.

customer_billing_namestring nullable

customer_tax_idstring nullable

localestring nullable

Locale of the customer, given as an IETF BCP 47 language tag, e.g. en, en-US or en-GB-oxendict. If null or unsupported, the locale will default to en.

payment_method_typestring nullable

Payment method type selected by the customer in the checkout form, e.g. card, apple_pay or upi.

discount_codestring nullable

Discount code to apply to the checkout.

allow_trialfalse nullable

Disable the trial period for the checkout session. It's mainly useful when the trial is blocked because the customer already redeemed one.

confirmation_token_idstring nullable

ID of the Stripe confirmation token. Required for fixed prices and custom prices.

Example request

{
  "customer_name": "John Doe",
  "customer_billing_address": {
    "country": "US"
  },
  "locale": "en"
}

Response

Checkout session confirmed.

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.

custom_field_dataobject

Key-value object storing custom field values.

payment_processor'stripe' required

status'confirmed' required

client_secretstring required

Client secret used to update and complete the checkout session from the client.

urlstring required

URL where the customer can access the checkout session.

expires_atstring date-time required

Expiration date and time of the checkout session.

success_urlstring 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.

embed_originstring nullable required

When checkout is embedded, represents the Origin of the page embedding the checkout. Used as a security measure to send messages only to the embedding page.

amountinteger required

Amount in cents, before discounts and taxes.

seatsinteger nullable

Predefined number of seats (works with seat-based pricing only)

min_seatsinteger nullable

Minimum number of seats (works with seat-based pricing only)

max_seatsinteger nullable

Maximum number of seats (works with seat-based pricing only)

discount_amountinteger required

Discount amount in cents.

net_amountinteger required

Amount in cents, after discounts but before taxes.

tax_amountinteger nullable required

Sales tax amount in cents. If null, it means there is no enough information yet to calculate it.

tax_behavior'inclusive' | 'exclusive' required

total_amountinteger required

Amount in cents, after discounts and taxes.

currencystring required

Currency code of the checkout session.

allow_trialboolean nullable required

Whether to enable the trial period for the checkout session. If false, the trial period will be disabled, even if the selected product has a trial configured.

active_trial_interval'day' | 'week' | 'month' | 'year' required

active_trial_interval_countinteger nullable required

Number of interval units of the trial period, if any. This value is either set from the checkout, if trial_interval_count is set, or from the selected product.

trial_endstring date-time nullable required

End date and time of the trial period, if any.

organization_idstring uuid4 required

ID of the organization owning the checkout session.

product_idstring uuid4 nullable required

ID of the product to checkout.

product_price_idstring uuid4 nullable required

ID of the product price to checkout.

discount_idstring uuid4 nullable required

ID of the discount applied to the checkout.

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. If you preset the billing address, this setting will be automatically set to true.

is_discount_applicableboolean required

Whether the discount is applicable to the checkout. Typically, free and custom prices are not discountable.

is_free_product_priceboolean required

Whether the product price is free, regardless of discounts.

is_payment_requiredboolean required

Whether the checkout requires payment, e.g. in case of free products or discounts that cover the total amount.

is_payment_setup_requiredboolean required

Whether the checkout requires setting up a payment method, regardless of the amount, e.g. subscriptions that have first free cycles.

is_payment_form_requiredboolean required

Whether the checkout requires a payment form, whether because of a payment or payment method setup.

customer_idstring uuid4 nullable required

is_business_customerboolean required

Whether the customer is a business or an individual. If true, the customer will be required to fill their full billing address and billing name.

customer_namestring nullable required

Name of the customer.

customer_emailstring nullable required

Email address of the customer.

customer_ip_addressstring ipvanyaddress nullable required

customer_billing_namestring nullable required

customer_tax_idstring nullable required

localestring nullable

payment_method_typestring nullable required

Payment method type selected by the customer in the checkout form, e.g. card, apple_pay or upi.

payment_processor_metadataobject required

pricesobject nullable required

Mapping of product IDs to their list of prices.

customer_session_tokenstring nullable required