Aller au contenu
agent-ecommerce.fr

Référence · Protocoles

UCP 2026-04-08, en clair

Référence rapide de la spécification stabilisée le 8 avril 2026 : manifest, champs critiques, architecture et checkout.

Spécification complète : ucp.dev et github.com/Universal-Commerce-Protocol/ucp.

Manifest minimal valide

Servi à /.well-known/ucp, en JSON (application/json), accessible publiquement.

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

Champs critiques pour les agents

  • payment_handlers : sans eux, un agent ne sait pas s'il peut finaliser l'achat.
  • auth.oauth2 : requis pour la liaison d'identité et la fidélité.
  • signing_keys : URL JWKS, optionnelle en 2026-04-08.
  • extensions : là où se joue la différenciation (fidélité, livraison spécifique, retrait en magasin, abonnements).

Six couches

  1. 1 Surfaces consommateurs (Gemini, ChatGPT, Copilot, Le Chat)
  2. 2 Agents IA, agents d'achat
  3. 3 Cœur UCP : capabilities et extensions
  4. 4 Transport : REST, JSON-RPC 2.0, MCP, A2A
  5. 5 Authentification (OAuth 2.0 + PKCE) et paiement (mandats AP2)
  6. 6 Back-office marchand : Shopify, Etsy, BigCommerce, développement spécifique

Machine à états du checkout

  1. incomplete

    État initial, données manquantes. Boucle sur PUT /sessions/{id} jusqu'à complétude.

  2. ready_for_complete

    État final côté API : l'agent peut finaliser et obtient un order_id.

  3. requires_escalation

    Sortie vers un humain via continue_url (3DS, SCA, champ spécifique).

Pour aller plus loin