Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "cancel_cart", "cancel_checkout", "complete_checkout" and 6 more
⟨332 unchanged words⟩ cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this ⟨33 unchanged words⟩ "street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"} ⟨125 unchanged words⟩ required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array ⟨423 unchanged words⟩
⟨339 unchanged words⟩ cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this ⟨33 unchanged words⟩ "street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"} ⟨125 unchanged words⟩ required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array ⟨547 unchanged words⟩
before
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}⟨332 unchanged words⟩ cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this ⟨33 unchanged words⟩ "street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"} ⟨125 unchanged words⟩ required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array ⟨423 unchanged words⟩
⟨339 unchanged words⟩ cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this ⟨33 unchanged words⟩ "street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"} ⟨125 unchanged words⟩ required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array ⟨547 unchanged words⟩
⟨332 unchanged words⟩ cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this ⟨33 unchanged words⟩ "street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"} ⟨125 unchanged words⟩ required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array ⟨423 unchanged words⟩
before
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}⟨332 unchanged words⟩ cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this ⟨33 unchanged words⟩ "street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"} ⟨125 unchanged words⟩ required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array ⟨423 unchanged words⟩
⟨339 unchanged words⟩ cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this ⟨33 unchanged words⟩ "street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"} ⟨125 unchanged words⟩ required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array ⟨547 unchanged words⟩
Changed the definition of "ask_business"
⟨77 unchanged words⟩ :"Resource identifiers for grounding. Up to 10 of this store's ShopifyproductProduct, ProductVariant, Collection or Cart GIDs are supported. A cart or collection grounds the answer in its products.","items":{"type":"string"}, ⟨64 unchanged words⟩
⟨16 unchanged words⟩ ["plain"],"type":"object"},"links":{"description":"Links to the products, variants and collections named in `ask.ids`.","items":{"properties":{"id":{"type":"string"},"title":{"type":"string"},"type":{"type":"string"},"url":{"format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type","content"],"type":"object"},"type":"array"},"
Authorization not required, issuer https://shopify.com/authentication/99022045470
Added "ask_business" (13 tools before, 14 now)
Ask a question about this store, such as what it sells, its policies, or its services.
Changed the definition of "create_cart", "create_checkout", "update_cart" and 1 more
⟨395 unchanged words⟩ "string"}},"type":"object"},"declared_fields":{"description":"Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.","items":{"properties":{"key":{"description":"Unique identifier for the declared field.","type":"string"},"value":{"description":"Submitted JSON value for the field. Null clears the value.","type":["string","number","boolean","object","array","null"]}},"required":["key","value"],"type":"object"},"type":"array"},"discounts":{"description":"Discount or promo codes ⟨235 unchanged words⟩
⟨430 unchanged words⟩ "string"}},"type":"object"},"declared_fields":{"description":"Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.","items":{"properties":{"key":{"description":"Unique identifier for the declared field.","type":"string"},"value":{"description":"Submitted JSON value for the field. Null clears the value.","type":["string","number","boolean","object","array","null"]}},"required":["key","value"],"type":"object"},"type":"array"},"
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Changed the definition of "create_cart" and "create_checkout"
⟨516 unchanged words⟩ :"object"},"type":"array"},"line_item_ids":{"description":"The line item ids to fulfill.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"description":"ID of the selected ⟨114 unchanged words⟩
⟨551 unchanged words⟩ :"object"},"type":"array"},"line_item_ids":{"description":"The line item ids to fulfill.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"description":"ID of the selected ⟨645 unchanged words⟩
Authorization not required, issuer https://shopify.com/authentication/99022045470
Changed the definition of "cancel_cart", "cancel_checkout", "complete_checkout" and 6 more
⟨58 unchanged words⟩ "Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type": ⟨811 unchanged words⟩
⟨65 unchanged words⟩ Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Certificate changed, valid to 2027-01-13
Authorization not required, issuer https://shopify.com/authentication/99022045470
Changed the definition of "create_checkout"
⟨156 unchanged words⟩ and ignores overlapping fields in the checkout payload. line_items is still required: pass an empty array (\"line_items\": []). Format: 'gid://shopify/Cart/abc123?key=secret'","type":"string"} ⟨927 unchanged words⟩
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Changed the definition of "get_order"
before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured order content.","properties":{"adjustments":{"items":{"additionalProperties":true,"properties":{"description":{"type":"string"},"id":{"type":"string"},"line_items":{"items":{"additionalProperties":true,"properties":{"id":{"description":"The line item GID.","type":"string"},"quantity":{"type":"integer"}},"required":["id","quantity"],"type":"object"},"type":"array"},"occurred_at":{"description":"RFC 3339 timestamp.","type":"string"},"status":{"enum":["pending","completed","failed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"type":{"type":"string"}},"required":["id","type","occurred_at","status"],"type":"object"},"type":"array"},"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"properties":{"email":{"type":"string"},"phone_number":{"type":"string"}},"type":"object"},"checkout_id":{"description":"The checkout ID, when the order has checkout linkage.","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"fulfillment":{"additionalProperties":true,"properties":{"events":{"items":{"additionalProperties":true,"properties":{"carrier":{"type":"string"},"description":{"type":"string"},"id":{"type":"string"},"line_items":{"items":{"additionalProperties":true,"properties":{"id":{"description":"The line item GID.","type":"string"},"quantity":{"type":"integer"}},"required":["id","quantity"],"type":"object"},"type":"array"},"occurred_at":{"description":"RFC 3339 timestamp.","type":"string"},"tracking_number":{"type":"string"},"tracking_url":{"type":"string"},"type":{"type":"string"}},"required":["id","occurred_at","type","line_items"],"type":"object"},"type":"array"},"expectations":{"items":{"additionalProperties":true,"properties":{"description":{"type":"string"},"destination":{"additionalProperties":true,"type":"object"},"fulfillable_on":{"type":"string"},"id":{"type":"string"},"line_items":{"items":{"additionalProperties":true,"properties":{"id":{"description":"The line item GID.","type":"string"},"quantity":{"type":"integer"}},"required":["id","quantity"],"type":"object"},"type":"array"},"method_type":{"type":"string"},"selected_option":{"additionalProperties":true,"properties":{"carrier_identifier":{"type":"string"},"description":{"additionalProperties":true,"properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"type":"object"}},"required":["id","line_items","method_type","destination"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Order GID.","type":"string"},"label":{"description":"The buyer-facing order name or confirmation number.","type":"string"},"line_items":{"items":{"additionalProperties":true,"properties":{"id":{"description":"The line item GID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The line item group GID, for bundled items.","type":"string"},"quantity":{"additionalProperties":true,"properties":{"fulfilled":{"type":"integer"},"original":{"type":"integer"},"total":{"type":"integer"}},"required":["total","fulfilled"],"type":"object"},"status":{"enum":["processing","partial","fulfilled","removed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals","status"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment instruments used for the order.","properties":{"instruments":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"permalink_url":{"description":"The order status page URL.","type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version"],"type":"object"}},"required":["ucp","id","permalink_url","line_items","fulfillment","currency","totals"],"title":"Order response","type":"object"}Changed the definition of "get_product", "lookup_catalog" and "search_catalog"
before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"One product with option availability and the effective selection.","properties":{"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"product":{"additionalProperties":true,"properties":{"categories":{"items":{"additionalProperties":true,"properties":{"taxonomy":{"type":"string"},"value":{"type":"string"}},"required":["value"],"type":"object"},"type":"array"},"collections":{"items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"handle":{"type":"string"},"id":{"type":"string"},"media":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"type":"object"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"gift_card":{"type":"boolean"},"handle":{"type":"string"},"id":{"type":"string"},"list_price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"name":{"type":"string"},"values":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"exists":{"type":"boolean"},"label":{"type":"string"}},"required":["label"],"type":"object"},"type":"array"}},"required":["name","values"],"type":"object"},"type":"array"},"price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"selected":{"items":{"additionalProperties":true,"properties":{"label":{"type":"string"},"name":{"type":"string"}},"required":["name","label"],"type":"object"},"type":"array"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"url":{"description":"The online store URL.","type":"string"},"variants":{"items":{"additionalProperties":true,"properties":{"availability":{"additionalProperties":true,"properties":{"available":{"type":"boolean"}},"type":"object"},"checkout_url":{"description":"A cart permalink for the variant on this store.","type":"string"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"id":{"type":"string"},"list_price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"label":{"type":"string"},"name":{"type":"string"}},"required":["name","label"],"type":"object"},"type":"array"},"price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"requires":{"additionalProperties":true,"properties":{"selling_plan":{"type":"boolean"},"shipping":{"type":"boolean"}},"type":"object"},"selling_plans":{"items":{"additionalProperties":true,"properties":{"description":{"type":"string"},"group":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"options":{"items":{"additionalProperties":true,"properties":{"name":{"type":"string"},"value":{"type":"string"}},"type":"object"},"type":"array"},"price":{"additionalProperties":true,"type":"object"},"recurring":{"type":"boolean"}},"type":"object"},"type":"array"},"sku":{"type":"string"},"title":{"type":"string"}},"required":["id","title","description","price"],"type":"object"},"type":"array"}},"required":["id","title","description","price_range","variants"],"type":"object"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version"],"type":"object"}},"required":["ucp","product"],"title":"Product detail response","type":"object"}Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Changed the definition of "cancel_cart", "cancel_checkout", "complete_checkout" and 6 more
before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured cart content.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Cart GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","currency","totals"],"title":"Cart response","type":"object"}Authorization not required, issuer https://shopify.com/authentication/99022045470
Changed the definition of "cancel_checkout", "complete_checkout", "create_checkout" and 2 more
before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"}Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Changed the definition of "complete_checkout", "create_checkout" and "update_checkout"
⟨141 unchanged words⟩ "else":{"properties":{"credential":{"requiredproperties":[{"tokentype":{"not":{"const":"apple_pay_token"}}},"required":["type"]}}},"if":{"properties": ⟨151 unchanged words⟩ allOf":[{"else":{"required":["token","type"]},"if":{"properties":{" ⟨108 unchanged words⟩ "token":{"description":"Opaque payment tokenvalue.value, required except when restating a platform-listed instrument (e.g., a Shop Pay wallet card) whose token the platform re-derives from the instrument id.","type":"string"},"transaction_identifier":{ ⟨263 unchanged words⟩
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Authorization not required, issuer https://shopify.com/authentication/99022045470
Certificate recorded, valid to 2026-11-14
Authorization not required, issuer https://shopify.com/authentication/99022045470
First tool surface recorded: 13 tools (server version 0.1.0)
Showing the latest 37 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"if":{"properties":{"type":{"const":"shipping"}},"required":["type"]},"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"required":["id"],"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"then":{"properties":{"destinations":{"items":{"properties":{"type":{"const":"shipping_address","type":"string"}},"required":["id","type"]}}}},"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}⟨395 unchanged words⟩ "string"}},"type":"object"},"declared_fields":{"description":"Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.","items":{"properties":{"key":{"description":"Unique identifier for the declared field.","type":"string"},"value":{"description":"Submitted JSON value for the field. Null clears the value.","type":["string","number","boolean","object","array","null"]}},"required":["key","value"],"type":"object"},"type":"array"},"discounts":{"description":"Discount or promo codes ⟨266 unchanged words⟩
⟨388 unchanged words⟩ "string"}},"type":"object"},"declared_fields":{"description":"Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.","items":{"properties":{"key":{"description":"Unique identifier for the declared field.","type":"string"},"value":{"description":"Submitted JSON value for the field. Null clears the value.","type":["string","number","boolean","object","array","null"]}},"required":["key","value"],"type":"object"},"type":"array"},"discounts":{"description":"Discount or promo codes ⟨799 unchanged words⟩
⟨111 unchanged words⟩ "string"}},"type":"object"},"buyer":{"additionalProperties":true,"properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.","type":"object"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.","type":"object"}},"type":"object"},"payment":{"additionalProperties":true,"description":"Payment ⟨593 unchanged words⟩
before
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}⟨130 unchanged words⟩ email and phone number.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.","type":"object"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.","type":"object"},"email":{"format":"email","type": ⟨402 unchanged words⟩
⟨58 unchanged words⟩ "Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type": ⟨811 unchanged words⟩
⟨123 unchanged words⟩ email and phone number.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.","type":"object"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.","type":"object"},"email":{"format":"email","type": ⟨975 unchanged words⟩
⟨65 unchanged words⟩ "Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type": ⟨935 unchanged words⟩
⟨58 unchanged words⟩ "Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type": ⟨811 unchanged words⟩
before
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}⟨130 unchanged words⟩ email and phone number.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.","type":"object"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.","type":"object"},"email":{"format":"email","type": ⟨420 unchanged words⟩
⟨58 unchanged words⟩ "Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type": ⟨811 unchanged words⟩
⟨123 unchanged words⟩ email and phone number.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"granted":{"description":"Whether consent is granted.","type":"boolean"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.","type":"object"},"source":{"description":"Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.","enum":["business","platform"],"type":"string"}},"required":["granted","source"],"type":"object"},"description":"Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.","type":"object"},"email":{"format":"email","type": ⟨953 unchanged words⟩
⟨65 unchanged words⟩ "Information about the buyer.","properties":{"consent":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"segments":{"additionalProperties":{"additionalProperties":true,"properties":{"description":{"type":"string"},"granted":{"type":"boolean"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"type":"object"},"source":{"enum":["business","platform"],"type":"string"}},"required":["granted","source","description"],"type":"object"},"description":"Current buyer consent decisions and business defaults, keyed by purpose.","type":"object"},"email":{"format":"email","type": ⟨935 unchanged words⟩
⟨61 unchanged words⟩ and whether the match was exact or featured. In versions that require input correlations, only matched variants are returned. Prices in the response are integers in the ⟨60 unchanged words⟩
before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Products resolved from the requested identifiers.","properties":{"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"products":{"items":{"additionalProperties":true,"properties":{"categories":{"items":{"additionalProperties":true,"properties":{"taxonomy":{"type":"string"},"value":{"type":"string"}},"required":["value"],"type":"object"},"type":"array"},"collections":{"items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"handle":{"type":"string"},"id":{"type":"string"},"media":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"type":"object"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"gift_card":{"type":"boolean"},"handle":{"type":"string"},"id":{"type":"string"},"list_price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"name":{"type":"string"},"values":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"exists":{"type":"boolean"},"label":{"type":"string"}},"required":["label"],"type":"object"},"type":"array"}},"required":["name","values"],"type":"object"},"type":"array"},"price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"url":{"description":"The online store URL.","type":"string"},"variants":{"items":{"additionalProperties":true,"properties":{"availability":{"additionalProperties":true,"properties":{"available":{"type":"boolean"}},"type":"object"},"checkout_url":{"description":"A cart permalink for the variant on this store.","type":"string"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"id":{"type":"string"},"inputs":{"description":"The requested identifiers that resolved to this variant.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"match":{"description":"`exact` for a variant id, `featured` for a product id or URL.","type":"string"}},"required":["id"],"type":"object"},"type":"array"},"list_price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"label":{"type":"string"},"name":{"type":"string"}},"required":["name","label"],"type":"object"},"type":"array"},"price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"requires":{"additionalProperties":true,"properties":{"selling_plan":{"type":"boolean"},"shipping":{"type":"boolean"}},"type":"object"},"sku":{"type":"string"},"title":{"type":"string"}},"required":["id","title","description","price"],"type":"object"},"type":"array"}},"required":["id","title","description","price_range","variants"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version"],"type":"object"}},"required":["ucp","products"],"title":"Catalog lookup response","type":"object"}before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Products matching a catalog search.","properties":{"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"pagination":{"additionalProperties":true,"properties":{"cursor":{"description":"Opaque cursor for the next page.","type":"string"},"has_next_page":{"type":"boolean"},"total_count":{"type":"integer"}},"required":["has_next_page"],"type":"object"},"products":{"items":{"additionalProperties":true,"properties":{"categories":{"items":{"additionalProperties":true,"properties":{"taxonomy":{"type":"string"},"value":{"type":"string"}},"required":["value"],"type":"object"},"type":"array"},"collections":{"items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"handle":{"type":"string"},"id":{"type":"string"},"media":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"type":"object"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"gift_card":{"type":"boolean"},"handle":{"type":"string"},"id":{"type":"string"},"list_price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"name":{"type":"string"},"values":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"exists":{"type":"boolean"},"label":{"type":"string"}},"required":["label"],"type":"object"},"type":"array"}},"required":["name","values"],"type":"object"},"type":"array"},"price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"url":{"description":"The online store URL.","type":"string"},"variants":{"items":{"additionalProperties":true,"properties":{"availability":{"additionalProperties":true,"properties":{"available":{"type":"boolean"}},"type":"object"},"checkout_url":{"description":"A cart permalink for the variant on this store.","type":"string"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"id":{"type":"string"},"list_price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"label":{"type":"string"},"name":{"type":"string"}},"required":["name","label"],"type":"object"},"type":"array"},"price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"requires":{"additionalProperties":true,"properties":{"selling_plan":{"type":"boolean"},"shipping":{"type":"boolean"}},"type":"object"},"sku":{"type":"string"},"title":{"type":"string"}},"required":["id","title","description","price"],"type":"object"},"type":"array"}},"required":["id","title","description","price_range","variants"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version"],"type":"object"}},"required":["ucp","products"],"title":"Catalog search response","type":"object"}⟨109 unchanged words⟩ :"Discount codes and applied discounts for thecheckout.checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties ⟨92 unchanged words⟩ {"description":"Discount codes submitted for thecheckout.checkout or cart.","items":{"type":"string"}, ⟨32 unchanged words⟩ {"description":"Fulfillment methods available for thecheckout.checkout or cart.","items":{"additionalProperties":true,"properties" ⟨726 unchanged words⟩
before
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured cart content.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Cart GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","currency","totals"],"title":"Cart response","type":"object"}⟨109 unchanged words⟩ :"Discount codes and applied discounts for thecheckout.checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties ⟨92 unchanged words⟩ {"description":"Discount codes submitted for thecheckout.checkout or cart.","items":{"type":"string"}, ⟨32 unchanged words⟩ {"description":"Fulfillment methods available for thecheckout.checkout or cart.","items":{"additionalProperties":true,"properties" ⟨726 unchanged words⟩
before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured cart content.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Cart GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","currency","totals"],"title":"Cart response","type":"object"}before
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured cart content.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Cart GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","currency","totals"],"title":"Cart response","type":"object"}⟨109 unchanged words⟩ :"Discount codes and applied discounts for thecheckout.checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties ⟨92 unchanged words⟩ {"description":"Discount codes submitted for thecheckout.checkout or cart.","items":{"type":"string"}, ⟨32 unchanged words⟩ {"description":"Fulfillment methods available for thecheckout.checkout or cart.","items":{"additionalProperties":true,"properties" ⟨726 unchanged words⟩
before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"}before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}before
—after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout.","properties":{"applied":{"description":"Discounts applied to the checkout, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"}⟨552 unchanged words⟩ "else":{"properties":{"credential":{"requiredproperties":[{"tokentype":{"not":{"const":"apple_pay_token"}}},"required":["type"]}}},"if":{"properties": ⟨151 unchanged words⟩ allOf":[{"else":{"required":["token","type"]},"if":{"properties":{" ⟨108 unchanged words⟩ "token":{"description":"Opaque payment tokenvalue.value, required except when restating a platform-listed instrument (e.g., a Shop Pay wallet card) whose token the platform re-derives from the instrument id.","type":"string"},"transaction_identifier":{ ⟨236 unchanged words⟩
⟨526 unchanged words⟩ "else":{"properties":{"credential":{"requiredproperties":[{"tokentype":{"not":{"const":"apple_pay_token"}}},"required":["type"]}}},"if":{"properties": ⟨151 unchanged words⟩ allOf":[{"else":{"required":["token","type"]},"if":{"properties":{" ⟨108 unchanged words⟩ "token":{"description":"Opaque payment tokenvalue.value, required except when restating a platform-listed instrument (e.g., a Shop Pay wallet card) whose token the platform re-derives from the instrument id.","type":"string"},"transaction_identifier":{ ⟨251 unchanged words⟩