Universal Commerce Protocol - Universal Commerce Protocol (UCP)
Initializing search
UCP on GitHub
Specification
Universal Commerce<br>Protocol
The common language for platforms, agents and businesses.
UCP defines building blocks for agentic commerce—from discovering and buying to post purchase experiences—allowing the ecosystem to interoperate through one standard, without custom builds.
Learn
Protocol overview, core concepts, and design principles
Read the docs
Implement
GitHub repo, technical spec, SDKs, and reference implementations
View on GitHub
Co-developed and adopted by industry leaders
UCP was built by the industry, for the industry to solve for fragmented commerce journeys that lead to abandoned carts and frustrated shoppers, and enable agentic commerce.
Shopify
Etsy
Wayfair
Target
Walmart
Built for flexibility, security, and scale
Agentic commerce demands interoperability. UCP is built on industry standards — REST and JSON-RPC transports;<br>Agent Payments Protocol (AP2),<br>Agent2Agent (A2A), and<br>Model Context Protocol (MCP)<br>support built-in — so different systems can work together without custom integration.
Scalable and universal
Surface-agnostic design that can scale to support any commerce entity (from small businesses to enterprise scale) and all modalities (chat, visual commerce, voice, etc).
Businesses at the center
Built to facilitate commerce, ensuring retailers retain control of their business rules and remain the Merchant of Record with full ownership of the customer relationship.
Open and extensible
Open and extensible by design, enabling development of community-driven capabilities and extensions across verticals.
Secure and private
Built on proven security standards for account linking (OAuth 2.0) and secure payment (AP2) via payment mandates and verifiable credentials.
Frictionless payments
Open wallet ecosystem with interoperability between providers to ensure buyers can pay with their preferred payment methods.
See it in action
UCP is designed to facilitate the entire commerce lifecycle, from initial product discovery and search to final sale and post-purchase support.<br>The protocol's initial launch focuses on three core capabilities: Checkout, Identity Linking, and Order Management.
Checkout<br>Identity Linking<br>Order
SEE IT IN ACTION
Checkout
Support complex cart logic, dynamic pricing, tax calculations, and more across millions of businesses through unified checkout sessions.
Learn more
"ucp": { ... },<br>"id": "chk_123456789",<br>"status": "ready_for_complete",<br>"currency": "USD",<br>"buyer": {<br>"email": "e.beckett@example.com",<br>"first_name": "Elisa",<br>"last_name": "Beckett"<br>},<br>"line_items": [<br>"id": "li_1",<br>"item": {<br>"id": "item_123",<br>"title": "Monos Carry-On Pro suitcase",<br>"price": 26550<br>},<br>"quantity": 1,<br>...<br>],<br>"totals": [ ... ],<br>"links": [ ... ],<br>"payment": { ... },<br>"fulfillment": {<br>"methods": [<br>"id": "method_1",<br>"type": "shipping",<br>"line_item_ids": ["li_1"],<br>"selected_destination_id": "dest_1",<br>"destinations": [<br>"id": "dest_1",<br>"first_name": "Elisa",<br>"last_name": "Beckett",<br>"street_address": "1600 Amphitheatre Pkwy",<br>"address_locality": "Mountain View",<br>"address_region": "CA",<br>"postal_code": "94043",<br>"address_country": "US"<br>],<br>"groups": [<br>"id": "group_1",<br>"line_item_ids": ["li_1"],<br>"selected_option_id": "free-shipping",<br>"options": [<br>"id": "free-shipping",<br>"title": "Free Shipping",<br>"totals": [ {"type": "total", "amount": 0} ]
SEE IT IN ACTION
Identity Linking
OAuth 2.0 standard enables agents to maintain secure, authorized relationships without sharing credentials.
Learn more
Sample of /.well-known/oauth-authorization-server
"issuer": "https://example.com",<br>"authorization_endpoint": "https://example.com/oauth2/authorize",<br>"token_endpoint": "https://example.com/oauth2/token",<br>"revocation_endpoint": "https://example.com/oauth2/revoke",<br>"scopes_supported": [<br>"dev.ucp.shopping.checkout"<br>],<br>"response_types_supported": [<br>"code"<br>],<br>"grant_types_supported": [<br>"authorization_code",<br>"refresh_token"<br>],<br>"token_endpoint_auth_methods_supported": [<br>"client_secret_basic"<br>],<br>"service_documentation": "https://example.com/docs/oauth2"
SEE IT IN ACTION
Order
From purchase confirmation to delivery. Real-time webhooks power status updates, shipment tracking, and return processing across every channel.
Learn more
"ucp": { ... },<br>"id": "order_123456789",<br>"checkout_id": "chk_123456789",<br>"permalink_url": ...,<br>"line_items": [ ... ],<br>"fulfillment": {<br>"expectations": [<br>"id": "exp_1",<br>"line_items": [{ "id": "li_1", "quantity": 1 }],<br>"method_type": "shipping",<br>"destination": {<br>"first_name": "Elisa",<br>"last_name": "Beckett",<br>"street_address": "1600 Amphitheatre Pkwy",<br>"address_locality": "Mountain View",<br>"address_region": "CA",<br>"postal_code": "94043",<br>"address_country": "US"<br>},<br>"description": "Arrives in 2-3 business days",<br>"fulfillable_on": "now"<br>...<br>],<br>"events": [<br>"id": "evt_1",<br>"occurred_at": "2026-01-11T10:30:00Z",<br>"type": "delivered",<br>"line_items": [{ "id": "li_1",...