Spec UCP 2026-04-08 — agent-ecommerce.fr

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, agents te skippent (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 tu différencies (loyalty, fulfillment custom, BOPIS, abonnements)

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

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)

Articles liés