Guide d'implémentation
Implémenter UCP : le guide marchand.
Ce que demande concrètement le Universal Commerce Protocol côté marchand : les prérequis, les deux voies d'implémentation, les étapes, et ce qui reste de votre responsabilité. Guide maintenu à partir des sources primaires.
L'essentiel en 30 secondes
- Deux voies : passer par l'implémentation de référence de Google (Merchant Center), ou intégrer le protocole open source directement.
- Prérequis Google : un compte Merchant Center actif et des produits éligibles au checkout.
- Côté protocole : publier un manifeste
/.well-known/ucpqui déclare services, capacités et paiements. - Vous restez vendeur de record, avec votre logique métier et, si vous le souhaitez, votre checkout.
À qui s'adresse ce guide
Aux marchands, plateformes e-commerce et équipes digitales qui veulent rendre leur offre achetable par des agents IA via le standard UCP de Google et Shopify. Il distingue ce qui relève de la configuration (voie Merchant Center) de ce qui relève de l'ingénierie (voie protocole), et ce qui reste un travail de fond sur la donnée, quelle que soit la voie.
Voie 1 : l'implémentation de référence Google
Google a construit la première implémentation de référence d'UCP : elle propulse un checkout natif dans AI Mode (Search) et l'app Gemini, avec paiement Google Pay. Pour y participer : Établi
- Disposer d'un compte Merchant Center actif. C'est la voie d'entrée : Google s'appuie sur les données produit déclarées pour exposer l'inventaire dans ses expériences conversationnelles.
- Fournir des produits éligibles au checkout, conformes à la spécification de flux Merchant Center (prix, disponibilité, attributs à jour).
- Suivre le guide d'intégration Google (developers.google.com/merchant/ucp) et compléter le formulaire d'intérêt marchand.
- Finaliser l'intégration checkout selon les instructions dédiées du guide.
Disponibilité : le déploiement commence par les États-Unis, avec des extensions annoncées au Canada et en Australie, puis au Royaume-Uni. Pas de date annoncée pour la France à ce jour. Établi
Voie 2 : intégrer le protocole directement
UCP est un standard ouvert et vendor-agnostique : un marchand ou une plateforme peut exposer ses propres capacités, indépendamment de Google. Le cœur de l'intégration : Établi
- Publier le manifeste de découverte à l'adresse
/.well-known/ucp: un JSON qui déclare la version du protocole, les services (ex.dev.ucp.shopping), les capacités et les gestionnaires de paiement. - Exposer les capacités choisies :
checkout(cœur transactionnel), avec des extensions commediscountoufulfillment, et au-delà la liaison d'identité et la gestion de commande. - Brancher les gestionnaires de paiement : le protocole sépare les instruments (ce que l'acheteur utilise) des gestionnaires (qui traitent), avec des handlers comme Google Pay ou Shop Pay. Chaque autorisation est adossée à une preuve cryptographique du consentement.
- Choisir le transport : API REST, MCP ou A2A selon votre pile, le standard supporte les trois.
- Partir des outils officiels : SDK Python (
python-sdk) et dépôt d'exemples (samples) publiés sur le GitHub du protocole, avec un serveur de démonstration complet.
Ce que UCP ne fait pas à votre place
Le protocole transporte votre offre, il ne l'améliore pas. Trois chantiers restent entièrement côté marchand, quelle que soit la voie choisie : Établi
- La qualité du catalogue : attributs riches, prix et stocks exacts, identifiants propres. Un agent compare à la vitesse machine ; une donnée pauvre est une donnée éliminée.
- La clarté des politiques : livraison, retours, garanties, éligibilité. Ce qui est ambigu pour un humain est bloquant pour un agent.
- La gouvernance : ce que vous autorisez, refusez et auditez quand un agent agit au nom d'un client.
Ces trois chantiers correspondent aux couches du framework en quatre couches de ce hub, et la méthodologie d'audit de readiness permet de les noter avant d'engager l'intégration.
Questions fréquentes
01 Quels sont les prérequis pour implémenter UCP côté Google ?
Quels sont les prérequis pour implémenter UCP côté Google ?
Un compte Google Merchant Center actif avec des produits éligibles au checkout. C'est la condition pour que Google dispose des informations produit nécessaires pour exposer votre inventaire à l'achat dans ses expériences conversationnelles (AI Mode, Gemini). Google publie un guide d'intégration dédié et un formulaire d'intérêt marchand.
02 Faut-il être développeur pour implémenter UCP ?
Faut-il être développeur pour implémenter UCP ?
Pour la voie Google (implémentation de référence), l'essentiel passe par Merchant Center : un e-commerçant outillé peut s'y préparer sans équipe protocole. Pour la voie protocole (exposer soi-même un manifeste /.well-known/ucp et des capacités), il faut une équipe technique : Google fournit un SDK Python et un dépôt d'exemples open source.
03 Qu'est-ce que le manifeste /.well-known/ucp ?
Qu'est-ce que le manifeste /.well-known/ucp ?
Un document JSON publié par le marchand à une adresse standardisée. Il déclare la version du protocole, les services supportés (ex. dev.ucp.shopping), les capacités exposées (checkout, remises, fulfillment...) et les gestionnaires de paiement acceptés. Les agents le lisent pour découvrir dynamiquement ce que le marchand sait faire, sans intégration sur mesure.
04 Qui encaisse et qui est responsable de la vente avec UCP ?
Qui encaisse et qui est responsable de la vente avec UCP ?
Le marchand reste vendeur de record : il conserve sa logique métier, sa relation client et sa responsabilité juridique sur la vente. UCP propose aussi une option « embarquée » permettant de garder un checkout entièrement personnalisé dès le premier jour.
05 Implémenter UCP suffit-il pour être visible des agents IA ?
Implémenter UCP suffit-il pour être visible des agents IA ?
Non. UCP structure la transaction, pas la qualité de l'offre. Si les données produit sont pauvres ou les politiques ambiguës, l'agent n'a rien d'exploitable à transiger. Le travail de readiness (catalogue, attributs, politiques) reste le prérequis, évaluable via la méthodologie d'audit.
Sources primaires
- Google, guide d'intégration marchand UCP et instructions checkout.
- Google Developers Blog, « Under the Hood: UCP » (walkthrough technique complet).
- Spécification UCP, SDK Python et exemples (GitHub).
- ucp.dev : site officiel du standard.
Avant d'implémenter
Évaluez votre readiness couche par couche, puis comparez les standards avant d'arbitrer.