Skip to main content
PUT
Replace UCP Checkout Session Fields

Authorizations

Authorization
string
header
required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Headers

UCP-Agent
string
required

UCP agent identity, for example agent.example/1.0.

Maximum string length: 240

Path Parameters

sessionId
string
required

Query Parameters

organizationId
string

Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token.

Maximum string length: 120

Body

application/json
line_items
object[]
Required array length: 1 - 100 elements
buyer
object
fulfillment
object
payment
object
payment_rail
enum<string>
Available options:
acp_stripe,
x402
metadata
object

Response

UCP checkout session updated.

ucp
object
required
id
string
required
line_items
object[]
required
status
enum<string>
required
Available options:
ready_for_complete,
completed,
canceled
currency
string
required
totals
object[]
required
buyer
object
fulfillment
object
payment
object
order
object
settlement
object