Implementation guide
Implement UCP: the merchant guide.
What the Universal Commerce Protocol concretely requires on the merchant side: prerequisites, the two implementation paths, the steps, and what remains your responsibility. Maintained from primary sources.
The 30-second summary
- Two paths: go through Google's reference implementation (Merchant Center), or integrate the open-source protocol directly.
- Google prerequisites: an active Merchant Center account and checkout-eligible products.
- Protocol side: publish a
/.well-known/ucpmanifest declaring services, capabilities and payments. - You remain the merchant of record, with your business logic and, if you wish, your own checkout.
Who this guide is for
Merchants, e-commerce platforms and digital teams that want their offer to be buyable by AI agents through the Google and Shopify UCP standard. It separates what is configuration (Merchant Center path) from what is engineering (protocol path), and what remains data groundwork either way.
Path 1: Google's reference implementation
Google built the first reference implementation of UCP: it powers native checkout in AI Mode (Search) and the Gemini app, with Google Pay. To take part: Established
- Have an active Merchant Center account. This is the entry point: Google relies on declared product data to surface inventory in its conversational experiences.
- Provide checkout-eligible products, compliant with the Merchant Center feed specification (accurate price, availability, attributes).
- Follow Google's integration guide (developers.google.com/merchant/ucp) and complete the merchant interest form.
- Complete the checkout integration following the guide's dedicated instructions.
Availability: rollout starts in the United States, with announced expansions to Canada and Australia, then the United Kingdom. Established
Path 2: integrate the protocol directly
UCP is an open, vendor-agnostic standard: a merchant or platform can expose its own capabilities, independently of Google. The core of the integration: Established
- Publish the discovery manifest at
/.well-known/ucp: a JSON document declaring the protocol version, services (e.g.dev.ucp.shopping), capabilities and payment handlers. - Expose your chosen capabilities:
checkout(the transactional core), with extensions such asdiscountorfulfillment, plus identity linking and order management. - Wire payment handlers: the protocol separates instruments (what the buyer uses) from handlers (who processes), with handlers such as Google Pay or Shop Pay. Every authorization is backed by cryptographic proof of consent.
- Pick your transport: REST APIs, MCP or A2A depending on your stack, the standard supports all three.
- Start from the official tooling: the Python SDK (
python-sdk) and the samples repository (samples) on the protocol's GitHub, including a complete demo server.
What UCP does not do for you
The protocol transports your offer, it does not improve it. Three workstreams remain entirely on the merchant side, whichever path you choose: Established
- Catalog quality: rich attributes, accurate prices and stock, clean identifiers. Agents compare at machine speed; poor data is eliminated data.
- Policy clarity: shipping, returns, warranties, eligibility. What is ambiguous for a human is blocking for an agent.
- Governance: what you allow, refuse and audit when an agent acts on behalf of a customer.
These map to the layers of this hub's four-layer framework, and the readiness audit methodology scores them before you commit engineering time.
Frequently asked questions
01 What are the prerequisites to implement UCP on the Google side?
What are the prerequisites to implement UCP on the Google side?
An active Google Merchant Center account with checkout-eligible products. This ensures Google has the product information needed to surface your inventory for purchase within its conversational experiences (AI Mode, Gemini). Google publishes a dedicated integration guide and a merchant interest form.
02 Do you need developers to implement UCP?
Do you need developers to implement UCP?
For the Google path (reference implementation), most of the work goes through Merchant Center: a well-tooled merchant can prepare without a protocol team. For the protocol path (publishing your own /.well-known/ucp manifest and capabilities), you need an engineering team: Google provides an open-source Python SDK and a samples repository.
03 What is the /.well-known/ucp manifest?
What is the /.well-known/ucp manifest?
A JSON document published by the merchant at a standardized address. It declares the protocol version, supported services (e.g. dev.ucp.shopping), exposed capabilities (checkout, discounts, fulfillment...) and accepted payment handlers. Agents read it to dynamically discover what the merchant supports, without bespoke integration.
04 Who collects the money and who is responsible for the sale with UCP?
Who collects the money and who is responsible for the sale with UCP?
The merchant remains the merchant of record: you keep your business logic, your customer relationship and your legal responsibility for the sale. UCP also provides an "embedded option" that lets you keep a fully customized checkout from day one.
05 Is implementing UCP enough to be visible to AI agents?
Is implementing UCP enough to be visible to AI agents?
No. UCP structures the transaction, not the quality of your offer. If product data is poor or policies are ambiguous, the agent has nothing reliable to transact on. Readiness work (catalog, attributes, policies) remains the prerequisite, and can be assessed with the audit methodology.
Primary sources
- Google, UCP merchant integration guide and checkout instructions.
- Google Developers Blog, "Under the Hood: UCP" (full technical walkthrough).
- UCP specification, Python SDK and samples (GitHub).
- ucp.dev: official site of the standard.
Before you implement
Score your readiness layer by layer, then compare the standards before you commit.