PATCH
/
v1
/
checkouts
/
client
/
{client_secret}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

client_secret
string
required

The checkout session client secret.

Body

application/json

Update an existing checkout session using the client secret.

custom_field_data
object | null

Key-value object storing custom field values.

product_id
string | null

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

product_price_id
string | null
deprecated

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

amount
integer | null

Amount to pay in cents. Only useful for custom prices, it'll be ignored for fixed and free prices.

Required range: 50 < x < 99999999
customer_name
string | null

Name of the customer.

customer_email
string | null

Email address of the customer.

customer_billing_address
object | null

Billing address of the customer.

customer_tax_id
string | null
discount_code
string | null

Discount code to apply to the checkout.

Response

200
application/json
Checkout session updated.

Checkout session data retrieved using the client secret.

created_at
string
required

Creation timestamp of the object.

modified_at
string | null
required

Last modification timestamp of the object.

id
string
required

The ID of the object.

payment_processor
enum<string>
required

Payment processor used.

Available options:
stripe
status
enum<string>
required

Status of the checkout session.

Available options:
open,
expired,
confirmed,
succeeded,
failed
client_secret
string
required

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

url
string
required

URL where the customer can access the checkout session.

expires_at
string
required

Expiration date and time of the checkout session.

success_url
string
required

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

embed_origin
string | null
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.

amount
integer | null
required

Amount to pay in cents. Only useful for custom prices, it'll be ignored for fixed and free prices.

Required range: 50 < x < 99999999
tax_amount
integer | null
required

Computed tax amount to pay in cents.

currency
string | null
required

Currency code of the checkout session.

subtotal_amount
integer | null
required

Subtotal amount in cents, including discounts and before tax.

total_amount
integer | null
required

Total amount to pay in cents, including discounts and after tax.

product_id
string
required

ID of the product to checkout.

product_price_id
string
required

ID of the product price to checkout.

discount_id
string | null
required

ID of the discount applied to the checkout.

allow_discount_codes
boolean
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.

is_discount_applicable
boolean
required

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

is_free_product_price
boolean
required

Whether the product price is free, regardless of discounts.

is_payment_required
boolean
required

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

is_payment_setup_required
boolean
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_required
boolean
required

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

customer_id
string | null
required
customer_name
string | null
required

Name of the customer.

customer_email
string | null
required

Email address of the customer.

customer_ip_address
string | null
required
customer_billing_address
object | null
required

Billing address of the customer.

customer_tax_id
string | null
required
payment_processor_metadata
object
required
products
object[]
required

List of products available to select.

product
object
required

Product selected to checkout.

product_price
object
required

Price of the selected product.

discount
object | null
required

Schema for a fixed amount discount that is applied once or forever.

organization
object
required
attached_custom_fields
object[]
required
custom_field_data
object

Key-value object storing custom field values.