convert_cart
Convert an existing cart into a checkout session. Preserves all cart-level state including discounts and context. Use this instead of re-passing line items to create_checkout after building a cart.
Schema
Input Schema
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Cart session ID to convert to a checkout session."
},
"meta": {
"type": "object",
"required": [],
"properties": {
"signature": {
"type": "string",
"description": "Optional detached JWS signature (RFC 7515 Appendix F) for message integrity."
},
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform UCP profile document (/.well-known/ucp equivalent for the agent)."
}
},
"description": "Platform agent identification. Carries the platform UCP profile URI."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "UUID for retry safety. Required on complete_checkout and cancel_checkout."
}
},
"description": "Request metadata. Include ucp-agent for capability negotiation. idempotency-key is required on complete/cancel for retry safety."
}
}
}
Verified Stores
1
Member Stores
Stores exposing the convert_cart 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
