Read UCP business outcomes alongside HTTP status
Read transport status and business outcome separately in UCP reports. Build assertions that inspect the negotiated result instead of counting HTTP 200 responses.
Resources
UCP resources:
specifications and standards.
Find the source you need to build, check or explain a UCP integration. Start with our notes for a guide, then open the official standard to check exact fields and rules.
Where should I start?
- New to UCP? Read the core concept to learn who does what in a purchase.
- Building a store integration? Start with the merchant guide, then check the UCP standard below.
- Checking product data or payments? Use the matching group of sources below. Each link takes you to the publisher’s site.
Reference notes
Use these guides to plan a task or check a field. They cover product data, checkout, payments and what happens after a sale. Each note links to its sources and shows its publication and revision dates.
-
How to validate a UCP implementation before production
A UCP validation plan for discovery, negotiation, schemas, states, signatures, idempotency, security, and end-to-end tests.
· the UCP implementation guide
-
UCP extensions: names, parents and versions
Declare UCP extensions: names, parents, versions and schemas. Learn why Discount can remain negotiable with Checkout alone, under conditions.
· the UCP framework
-
UCP errors, retries, and idempotency in production
Separate UCP transport errors from business results, handle 409, 429, and 503, then retry without duplicating a transaction.
· the UCP implementation guide
-
UCP Message Signatures: verify requests and webhooks
A guide to UCP signatures with RFC 9421, body digests, ES256, JWK discovery, key rotation, verification, and webhook security.
· the UCP implementation guide
-
UCP Embedded Protocol: web and native app handoff
How UCP Embedded Protocol uses JSON-RPC, postMessage, origin validation, handshake, delegation, and checkout recovery.
· the UCP implementation guide
-
UCP Identity Linking: connect accounts with OAuth
How UCP Identity Linking handles access levels, OAuth discovery, scopes, consent, tokens, and unauthenticated fallback.
· the UCP implementation guide
-
UCP Orders after purchase: state, events, and returns
The UCP Order model after Checkout: current snapshots, webhooks, fulfillment, refunds, returns, adjustments, and attribution.
· agentic commerce
-
UCP Catalog: Search, Lookup, and stable product IDs
How to expose a UCP catalog with Search and Lookup, stabilize identifiers, and connect product discovery to Checkout.
· catalog readability for AI agents
-
UCP Checkout lifecycle: the 6 states to implement
The six UCP Checkout states, valid transitions, message handling, buyer handoff, and safe completion into an order.
· the UCP implementation guide
-
UCP Cart or Checkout: which capability should you use?
Cart and Checkout differences in UCP, cart conversion, lifecycle, payments, and the implementation rules merchants need.
· the UCP implementation guide
-
Shopify agents.md, Catalog MCP, Cart MCP, and UCP
Understand Shopify's agent surfaces: discovery, product truth, Catalog MCP, UCP carts, WebMCP, and checkout.
· the UCP and MCP comparison
-
Disputes and liability for AI-agent purchases
What signed mandates prove, what they do not assign, and the evidence a merchant should retain while liability rules are still settling.
· AP2, the agentic payments protocol
-
Measuring agentic commerce beyond your website
Why classic attribution undercounts AI agents, what GA4 actually captures, and the protocol signals a merchant should instrument server-side.
· agentic commerce
-
AI agent traffic: governance, crawling, attribution
Telling training crawlers, answer indexers and human-triggered agents apart, what robots.txt actually governs, and what it does not.
· catalogue readability for agents
-
UCP payment handlers: specifications, instruments, PSPs
Why UCP declares processing specifications rather than providers, what a payment handler contains, and what it changes about choosing a PSP.
· agentic payments
-
The /.well-known/ucp manifest, field by field
The real structure of the UCP discovery manifest: services, capabilities, payment_handlers, signing keys, version negotiation and error codes.
· the UCP implementation guide
The UCP standard (primary sources)
-
ucp.dev
Official UCP website.
External link ↗
-
Current UCP specification (HTML)
Read the current UCP standard in HTML.
External link ↗
-
UCP specification (GitHub)
Read the code, docs and discussions in the UCP repository.
External link ↗
-
Google Developers Blog, Under the Hood: UCP
A technical guide from Google (January 2026).
External link ↗
-
Google, merchant integration guide
A guide to adding UCP through Google Merchant Center.
External link ↗
-
Shopify, Universal Commerce Protocol
Shopify's own guide to the UCP standard.
External link ↗
Semantic standards
Agent readability and GEO readiness
-
GEO: Generative Engine Optimization (KDD 2024)
Research on how content appears in answers from AI search tools.
External link ↗
-
VerityScore
Read the scope, method and limits before choosing this audit tool.
External link ↗
-
Google, AI optimization guide
Google guidance on AI Mode and AI Overviews.
External link ↗
-
llmtxt.info
Guides to the llms.txt format and related tools.
External link ↗
Agent protocols
Agent-aware payment rails
Editorial content
Need background and analysis?
Visit the .blog for longer articles on agentic commerce. It offers guides, comparisons and analysis to help you put the standards in context.
Practical guides
What evidence should support a vendor's “UCP compatible” claim?
Turn a broad UCP compatibility claim into a reviewable scope: role, version, capabilities, test environment and unresolved limitations.