{"id":"c2d3ce7d-2995-4f40-91ab-0fb486a2f631","task":"Implement the Universal Commerce Protocol (UCP) merchant side to make your store natively transactable by any UCP-compatible AI agent from any platform","domain":"shopify.dev/docs/agents","steps":["Study the UCP specification co-developed by Shopify and Google, backed by a coalition including Amazon, American Express, Etsy, Mastercard, Meta, Microsoft, Salesforce, Stripe, Target, Walmart, and Visa; UCP defines the full agent-merchant interaction layer: catalog discovery, cart creation, checkout, payment, and post-purchase across any platform and any payment processor","Expose a UCP-compliant catalog endpoint: agents discover your products via a well-known URL or a UCP directory listing; the catalog response must include all UCP-required product fields including canonical product IDs, structured offer objects, policy metadata, and availability state","Implement UCP cart management endpoints: create_cart, update_cart, and get_cart must return a canonical cart object with line items, applied promotions, tax estimate, and available shipping options; UCP cart objects are protocol-neutral so any UCP agent can consume them regardless of which AI platform the buyer uses","Connect your existing Google Pay merchant ID and backend to UCP per Google's confirmation that existing Merchant IDs are compatible with UCP without re-provisioning; this also applies to Stripe and PayPal-connected merchants who have UCP-compatible processor integrations","Implement UCP payment handoff: at checkout, the UCP payment step routes through AP2 (for Google-ecosystem agents), ACP (for OpenAI/Stripe-ecosystem agents), Mastercard Agent Pay, or Visa VIC depending on the agent's protocol stack — your checkout must negotiate which credential type to accept and respond accordingly","Submit for UCP certification by testing all supported protocol paths in the Google and Shopify UCP sandboxes; certification is required for directory listing visibility which determines whether agents can discover your store without a direct URL"],"gotchas":["UCP is an umbrella protocol that composes AP2, ACP, and network-layer schemes; implementing only one sub-protocol means agents using the other sub-protocols cannot complete checkout on your store — plan for multi-protocol support from the start","UCP catalog freshness requirements are strict; a catalog entry returned with stale pricing or availability that causes an agent-initiated order to fail will result in your store being flagged in UCP directory quality monitoring, reducing your discoverability score","The UCP specification was in active development in mid-2026 with contributions from a large coalition; monitor the Shopify developer changelog and the UCP working group repository for breaking changes between minor versions, especially to the payment handoff negotiation fields"],"contributor":"waymark-seed","created":"2026-06-12T10:27:15.982Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/c2d3ce7d-2995-4f40-91ab-0fb486a2f631"}