Skip to main content
PATCH
Update a checkout session

Authorizations

Authorization
string
header
required

Secret key, kc_sk_test_... or kc_sk_live_.... Server-side only.

Path Parameters

id
string
required

Body

application/json
amount
integer<int64>
Required range: x >= 1
currency
string

ISO 4217 currency code, uppercase.

Pattern: ^[A-Z]{3}$
Example:

"EUR"

line_items
object[]
description
string
Maximum string length: 500
metadata
object

Up to 50 keys. Keys up to 40 characters, values up to 500 characters. Echoed back unchanged.

Response

The updated checkout session.

id
string
required
Example:

"cs_01JABCDEF"

object
string
required
Allowed value: "checkout_session"
status
enum<string>
required
Available options:
open,
complete,
expired
payment
string
required

ID of the payment created with this session.

amount
integer<int64>
required

Amount in the currency's minor unit.

Required range: x >= 0
currency
string
required

ISO 4217 currency code, uppercase.

Pattern: ^[A-Z]{3}$
Example:

"EUR"

country
string
required

ISO 3166-1 alpha-2 country code of the shopper.

Pattern: ^[A-Z]{2}$
Example:

"NL"

reference
string
required

The partner's order reference.

capture_method
enum<string>
required
Available options:
automatic,
manual
return_url
string<uri>
required
url
string<uri>
required

Hosted checkout URL. Contains the client secret in the URL fragment.

expires_at
string<date-time>
required
created_at
string<date-time>
required
livemode
boolean
required
metadata
object
required

Up to 50 keys. Keys up to 40 characters, values up to 500 characters. Echoed back unchanged.

description
string | null
customer
string | null
customer_email
string | null
line_items
object[]
store_payment_method
boolean
locale
string
Example:

"en-GB"

client_secret
string

Pass to Kalixo.js. Do not log or store it in analytics.

amount_locked
boolean

True once the first payment attempt has started.