Skip to main content
POST
Create Agentic Checkout Session

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Optional idempotency key for create retries.

Maximum string length: 180

Body

application/json
items
object[]
required
Required array length: 1 - 100 elements
organizationId
string

Optional for OAuth clients bound to one organization; required when the caller can access multiple organizations.

Maximum string length: 120
paymentRail
enum<string>
default:acp_stripe
Available options:
acp_stripe,
x402
buyer
object
shippingAddress
object
billingAddress
object
metadata
object

Response

Checkout session created with inventory reserved.

ok
boolean
apiVersion
string
default:agentic_checkout_v1
session
object
items
object[]