create_checkout
Start a new checkout session. Returns a session object with an "id" field — store this ID and use update_checkout to add more items or buyer details. Use this only once per shopping journey; use update_checkout for all subsequent changes.
Schema
Input Schema
{
"type": "object",
"required": [
"line_items"
],
"properties": {
"buyer": {
"type": "object",
"required": [],
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "Customer email address"
},
"full_name": {
"type": "string",
"description": "Customer full name"
},
"last_name": {
"type": "string",
"description": "Customer last name"
},
"first_name": {
"type": "string",
"description": "Customer first name"
},
"phone_number": {
"type": "string",
"description": "Customer phone number"
}
},
"description": "Optional buyer information (name, email, phone)"
},
"payment": {
"type": "object",
"required": [],
"properties": {
"instruments": {
"type": "array",
"items": {
"type": "object"
},
"description": "Array of payment instruments"
},
"selected_instrument_id": {
"type": "string",
"description": "ID of selected payment instrument"
}
},
"description": "Optional payment instruments and selection"
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"quantity"
],
"properties": {
"item": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Product ID or variation ID"
}
},
"description": "Item reference with product or variation ID"
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Quantity to add to cart"
}
}
},
"description": "Array of line items. Each item is an object with \"item\" (object with \"id\" field) and \"quantity\" (integer)"
},
"fulfillment": {
"type": "object",
"required": [],
"properties": {
"methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"enum": [
"shipping",
"pickup",
"digital"
],
"type": "string",
"description": "Fulfillment method type"
},
"groups": {
"type": "array",
"items": {
"type": "object"
},
"description": "Fulfillment groups for this method"
},
"destinations": {
"type": "array",
"items": {
"type": "object"
},
"description": "Available destinations for this method"
},
"line_item_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Line items for this fulfillment method"
},
"selected_destination_id": {
"type": "string",
"description": "Selected destination ID"
}
}
},
"description": "Array of fulfillment methods (shipping, pickup, digital)"
}
},
"description": "Optional fulfillment methods configuration"
}
}
}
Verified Stores
17,391
Member Stores
Stores exposing the create_checkout tool
Weekly UCP Report
Get the agentic commerce digest every Monday
Real adoption data, ecosystem trends, new spec versions, and the stores that broke or recovered this week. Read by founders and engineers building the next generation of commerce.
Weekly UCP Report
Issue #50 · Sep 14, 2026
+664
new verified stores
Verified rate
Latest spec
Cart capability
