Spec UCP 2026-04-08

Référence rapide de la spec stabilisée le 8 avril 2026. Pour la spec complète : ucp.dev et github.com/Universal-Commerce-Protocol/ucp.

Manifest minimal valide

Servi à /.well-known/ucp, en JSON, content-type application/json, accessible publiquement.

ucp_version : "2026-04-08"
merchant : id, name, domain, merchant_of_record
services : array d'au moins un service avec name, version, transport, base_url
capabilities : array (dev.ucp.checkout, dev.ucp.order, dev.ucp.identity, etc.)

Champs critiques pour le ranking agent

payment_handlers : sans ça, les agents skippent la boutique (ils ne savent pas s'ils peuvent finaliser)
auth.oauth2 : requis pour identity link et loyalty
signing_keys : JWKS URL ; optionnel en 2026-04-08, probablement requis en 2026-10-08
extensions : c'est là que se joue votre différenciation (loyalty, fulfillment custom, BOPIS, abonnements)

Diagramme architecture UCP : agent ↔ manifest ↔ checkout 1280×720 /diagrams/ucp-architecture.svg

Export Excalidraw ou Mermaid SVG, accent #634AD9

Six couches UCP

Surfaces consommateurs (Gemini, ChatGPT, Copilot, Le Chat)
Agents IA / shopping agents
UCP core : capabilities + extensions
Transport : REST, JSON-RPC 2.0, MCP, A2A
5a. Auth : OAuth 2.0 + PKCE · 5b. Paiement : AP2 mandates
Merchant backend : Shopify, Etsy, BigCommerce, custom

Diagramme 6 couches UCP (consommateurs → backend) 1280×720 /diagrams/ucp-six-layers.svg

Checkout state machine

incomplete : état initial, données manquantes, self-loop sur PUT /sessions/{id}
ready_for_complete : état final API, l'agent peut finaliser → order_id
requires_escalation : sortie humaine via continue_url (3DS, SCA, custom field)

Checkout state machine : incomplete → ready → escalation 1280×720 /diagrams/ucp-checkout-state-machine.svg

Articles liés