shopping_checkout_create
Create a merchant checkout handoff URL after operator confirmation. Does not accept payment credentials. Buyer phone should be E.164 and country must be ISO-2.
1verified stores declare the shopping_checkout_create tool
0%of the verified stores we check
By store platform
Custom or not identified 100%
By release
Each store has its own status page. To find more, search the directory.
Input schema
inputSchema
{
"type": "object",
"required": [
"agent_id",
"merchant_domain",
"operator_confirmed"
],
"properties": {
"buyer": {
"type": "object",
"required": [
"email",
"first_name",
"last_name",
"street_address",
"address_locality",
"address_region",
"postal_code",
"address_country"
],
"properties": {
"email": {
"type": "string",
"description": "Buyer email for merchant checkout contact and order confirmation."
},
"phone": {
"type": "string",
"description": "Buyer phone. Prefer E.164, e.g. +15555550100. Non-E.164 values are accepted but may be dropped before reaching the provider and will surface a non-fatal warning."
},
"last_name": {
"type": "string",
"description": "Buyer-provided shipping last name."
},
"first_name": {
"type": "string",
"description": "Buyer-provided shipping first name."
},
"postal_code": {
"type": "string",
"description": "Buyer-provided shipping postal code."
},
"phone_number": {
"type": "string",
"description": "Canonical buyer phone alias. Prefer E.164. Equivalent to `phone`; if both are set, phone_number wins."
},
"address_region": {
"type": "string",
"description": "Buyer-provided shipping state/province/region."
},
"street_address": {
"type": "string",
"description": "Buyer-provided shipping street address."
},
"address_country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code. Use 'US', not 'USA'."
},
"address_locality": {
"type": "string",
"description": "Buyer-provided shipping city/locality."
}
},
"description": "Buyer-provided checkout contact and shipping details. Never invent PII; omit phone if unavailable.",
"additionalProperties": false
},
"cart_id": {
"type": "string",
"description": "Provider cart ID returned by cart tools. Provide either cart_id or line_items."
},
"agent_id": {
"type": "string",
"description": "Registered UCP Gateway UUID returned by register_ucp_profile; required for every Shopping tool."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code, e.g. 'USD'."
},
"append_utm": {
"type": "boolean",
"description": "Whether to append The Agent Times handoff UTM parameters to the merchant continue_url."
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"quantity"
],
"properties": {
"item": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Provider variant ID returned by shopping_product_get or search results. The current adapter returns Shopify ProductVariant GIDs."
}
},
"description": "Selected provider item reference.",
"additionalProperties": false
},
"quantity": {
"type": "integer",
"maximum": 99,
"minimum": 1,
"description": "Integer quantity from 1 to 99, confirmed by the buyer/operator."
}
},
"description": "Cart or checkout line item.",
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "Selected provider variant line items confirmed by the buyer/operator."
},
"merchant_domain": {
"type": "string",
"description": "Merchant host such as 'outboundpower.com' or 'example.myshopify.com'. Do not include a URL scheme, localhost, private IP, file URL, or ftp URL."
},
"client_action_id": {
"type": "string",
"description": "Optional UUID generated once for an explicit buyer/operator-confirmed cart or checkout mutation. Reuse only when retrying the same confirmed action."
},
"operator_confirmed": {
"type": "boolean",
"description": "Set true only after the buyer/operator reviewed the cart summary and explicitly confirmed checkout creation."
}
},
"description": "Arguments for creating a buyer-confirmed checkout handoff.",
"additionalProperties": false
}