Shopify et Universal Commerce Protocol : guide développeur

Par Shubham Vats, Fondateur de Revize

Publié le Mis à jour le 10 min de lecture

Sur cette page

Universal Commerce Protocol (UCP) est un protocole ouvert et versionné pour le commerce agentique. L’implémentation actuelle de Shopify expose des serveurs MCP compatibles UCP pour la recherche catalogue, les paniers, le paiement et les commandes. UCP est disponible dès aujourd’hui aux développeurs, mais un protocole ouvert ne signifie pas que chaque agent ou marchand prend en charge toutes les capacités.

Hub reliant agent IA, boutique, paiements et panier pour représenter le commerce UCP

Vue d’ensemble : qu’est-ce qui a changé ?

UCP a été annoncé par Shopify et Google le 11 janvier 2026. Le protocole continue d’évoluer ; la documentation actuelle utilise les exemples de profil d’agent 2026-08-25. Le 13 octobre 2026, Shopify a aussi annoncé Shop MCP, qui permet aux agents compatibles de rechercher dans Shopify Catalog, créer des paniers et un paiement via une connexion MCP unique.

Pour les développeurs Shopify, la question pratique est le parcours agent à prendre en charge : découverte, création de panier, transfert au paiement ou suivi de commande. Vérifiez les outils et autorisations documentés avant de promettre une fonction aux marchands.

Qu’est-ce que l’UCP, exactement ?

UCP est un protocole ouvert décrivant l’échange d’informations et l’exécution d’actions commerciales définies entre applications d’agent et systèmes de commerce. Il est versionné et fondé sur les capacités : une intégration annonce ce qu’elle prend en charge, et l’agent doit utiliser uniquement ces capacités.

Shopify implémente UCP via des points de terminaison et outils MCP. Selon le point et les autorisations, les développeurs peuvent utiliser la découverte catalogue, les paniers, le paiement ou les informations de commande. Ce sont des parcours distincts ; la prise en charge de l’un n’implique pas toutes les autres capacités.

Hub UCP relié aux icônes de robot, boutique, paiement et profil utilisateur

Rôles dans un parcours de commerce agentique

  • Agent ou application : aide l’acheteur à trouver des produits, créer un panier ou poursuivre le paiement.
  • Système du marchand : fournit les informations produit et de paiement et traite la commande via son interface Shopify prise en charge.
  • Fournisseur d’identifiants : fournit des identifiants ou jetons de paiement via la méthode négociée pour ce parcours.
  • Service de paiement : gère le paiement via le parcours ou moyen disponible.
  • Acheteur : vérifie et autorise l’achat. Respectez les exigences de confirmation et d’autorisation du parcours.

Le problème : pourquoi le commerce avait besoin d’un protocole

Aujourd’hui, les systèmes commerciaux sont très fragmentés.

Prenons le cas d’un client qui souhaite acheter un produit avec un assistant IA :

Connexions commerciales emmêlées comparées à un réseau organisé autour d’un hub pour un protocole commun

  • L’IA doit trouver les informations produit dans les catalogues des marchands
  • Elle doit connaître la disponibilité, les prix et les options d’expédition en temps réel
  • Elle doit gérer les programmes de fidélité, les codes de réduction et les préférences d’abonnement
  • Elle doit recueillir les données de paiement de façon sécurisée
  • Elle doit finaliser le paiement en respectant toutes les exigences propres au marchand
  • Enfin, elle doit prendre en charge le suivi des commandes, les retours et le service client

Les intégrations personnalisées ajoutent de la maintenance. UCP fournit des schémas partagés et une négociation de capacités pouvant la réduire, mais deux implémentations doivent encore avoir des versions, capacités, authentifications et gestionnaires de paiement compatibles. La compatibilité du protocole seule ne garantit pas qu’un agent termine un achat.

Les capacités UCP à comprendre d’abord

Le paiement, la liaison d’identité et l’état de commande sont des points de départ utiles dans la spécification UCP. Shopify documente aussi les capacités de catalogue et de panier. Chaque interface implémente son propre ensemble ; vérifiez le profil négocié avant d’appeler un outil.

Empilement illustré des étapes de découverte produit, de paiement et de suivi de commande

1. Paiement

Checkout crée et met à jour une session d’achat, dont les articles, les informations acheteur, les totaux et le gestionnaire de paiement. Le marchand reste le vendeur officiel. Le parcours standard transfère l’acheteur à une interface de confiance pour confirmer le paiement ; la finalisation autonome dépend des extensions d’autorisation prises en charge et de l’intégration précise.

2. Liaison des identités

La liaison d’identité utilise OAuth 2.0 pour permettre à l’acheteur d’autoriser un agent à agir pour lui. Elle peut prendre en charge les fonctions propres au compte, comme les adresses enregistrées ou l’historique. La recherche publique catalogue peut fonctionner sans liaison d’identité : l’autorisation est donc une capacité et une décision de permission distinctes.

3. Commande

La capacité Order partage l’état et les événements du cycle de vie comme le traitement, les retours et remboursements. Ce n’est pas une API générale de modification. Order MCP et les API de modification à la demande de l’acheteur ont leurs propres périmètres et limites documentés, décrits ci-dessous.

Architecture technique : conçue pour évoluer

UCP utilise les profils pour déclarer une version et les capacités prises en charge. Entreprises et agents négocient leurs capacités communes pour une session ; l’agent doit utiliser uniquement cet ensemble. Les exemples Shopify utilisent des versions datées : reprenez le profil et schéma actuels de la documentation en ligne plutôt qu’un ancien exemple.

Service commercial en couches avec modules de capacités optionnels montrant l’architecture extensible d’UCP

Les extensions ajoutent des détails facultatifs à une capacité de base, comme le traitement ou les réductions. Une entreprise peut exposer le paiement de base sans toutes les extensions ; l’agent doit vérifier celles prises en charge par l’autre partie avant de s’y fier. Consultez la présentation UCP et le guide des profils d’agent Shopify.

Conçu pour l’interopérabilité

Le standard UCP est conçu pour fonctionner avec différentes liaisons, comme REST, MCP et A2A. Cela décrit le standard dans son ensemble ; cela ne garantit pas qu’une implémentation Shopify expose chaque capacité via chaque transport.

Noyau UCP relié aux concepts MCP, A2A, AP2 et REST dans l’écosystème des protocoles

La documentation développeur actuelle décrit les serveurs MCP compatibles UCP et leurs outils. Vérifiez le point de terminaison exact, l’authentification, la version de profil et la confirmation acheteur requise. Ne déduisez pas qu’une capacité de la spécification UCP est déjà disponible via une interface Shopify MCP particulière.

Interfaces UCP et MCP actuellement proposées par Shopify

La documentation des agents Shopify décrit plusieurs interfaces distinctes :

Découverte catalogue

Les outils Catalog MCP permettent à un agent de rechercher dans Shopify Catalog et de récupérer les détails produit. Global Catalog MCP utilise https://catalog.shopify.com/api/ucp/mcp ; Shop MCP est disponible à https://mcp.shop.com et expose la recherche catalogue et les outils produit. La visibilité et les résultats dépendent des données actuelles et de l’interface utilisée.

Création de panier et paiement

Cart MCP crée et met à jour un panier. Checkout MCP crée et gère une session, puis transfère l’acheteur vers la boutique du marchand pour les étapes nécessitant son intervention. Shopify recommande Checkout MCP côté serveur ; Checkout WebMCP convient à un agent déjà dans le navigateur de l’acheteur. Certains types de paiement et interactions d’applications ne sont pas gérés par les outils navigateur.

Shop MCP est une connexion distincte qui recherche dans Shopify Catalog, crée des paniers et un paiement Shop Pay. Cela ne rend pas automatiquement chaque marchand disponible dans toutes les applications IA.

Informations de commande

Order MCP lit l’état actuel des commandes passées via l’agent, dont le traitement et les ajustements après achat. get_order sert aux vues demandées par l’acheteur et au rapprochement. Les webhooks de commande UCP fournissent des instantanés continus après les changements validés ; un responsable partenaire Shopify doit enregistrer l’adresse de livraison. Ce canal de lecture et de mise à jour n’exécute pas de modifications arbitraires.

Séparément, les API annoncées le 1er octobre 2026 permettent aux acheteurs de demander le retrait de lignes non traitées ; un marchand ou une application peut examiner, résoudre ou refuser la demande. Ce parcours limité diffère d’un changement d’adresse ou de produit.

Ce que cela signifie pour les marchands Shopify

Ordinateur montrant les contrôles des vitrines agentiques et les canaux d’achat IA connectés

Les outils d’agents de Shopify peuvent rendre les parcours produit et paiement accessibles aux agents compatibles. L’expérience dépend de l’interface utilisée, des capacités activées pour la boutique et de l’autorisation du client. Gardez à jour les informations produit, la disponibilité et les politiques, et vérifiez les canaux activés pour votre boutique.

Considérez cela comme une interface d’intégration, pas une garantie de présence universelle dans l’IA ou d’accès à tous les marchands. La présentation des vitrines agentiques explique la disponibilité des canaux et le paiement par recommandation ChatGPT standard.

Ce que cela signifie pour les développeurs d’applications Shopify

Main manipulant des composants de commerce près d’un écran de code

UCP et les outils MCP Shopify offrent aux développeurs des interfaces définies. Avant de commencer, identifiez la tâche acheteur, le point Shopify, le profil et les autorisations requis, ainsi que les étapes où l’acheteur doit vérifier ou confirmer.

Développer pour les capacités prises en charge

Utilisez la documentation et les tutoriels actuels pour la découverte des points, l’authentification, le panier, le paiement et le suivi. Ne supposez pas qu’une application tierce peut exposer ses fonctions à un agent simplement parce qu’UCP accepte les extensions ; vérifiez l’implémentation de l’interface et de la capacité.

Séparer la modification de commande

Order MCP couvre les informations et le cycle de vie des commandes. Il ne fait pas de changements arbitraires d’adresse ou de produit. Les API du 1er octobre 2026 sont limitées aux demandes de retrait de lignes non traitées avec examen du marchand ou d’une application. Pour les autres modifications client après achat, vérifiez les fonctions et autorisations actuelles de l’application distincte.

Ce que cela signifie pour les agences

Équipe d’agence planifiant une intégration UCP autour d’un schéma commercial

Les agences peuvent préparer les données produit et le paiement pour les interfaces d’agent choisies. Commencez par la documentation actuelle et le forfait réel, les applications, les données et le parcours acheteur du marchand. Mesurez la disponibilité, la portée client et les conversions pour chaque marchand au lieu de les considérer comme des garanties du protocole.

UCP et les autres protocoles de commerce agentique

UCP et Agentic Commerce Protocol (ACP) sont des initiatives distinctes. Leurs interfaces et parcours diffèrent : ne supposez pas une compatibilité automatique d’une intégration UCP avec ACP ou inversement. Consultez les spécifications actuelles et développez uniquement pour les interfaces visées.

Comparaison conceptuelle des plateformes UCP et ACP avec un pont d’intégration

Le pont illustré représente un travail d’intégration à évaluer, pas une fonction d’interopérabilité Shopify livrée.

Pour commencer : guide pratique d’implémentation

Commencez par la documentation actuelle du commerce agentique Shopify. Elle comprend les interfaces MCP, profils UCP, authentifications et tutoriels actuels. Shopify recommande le démarrage rapide AI Toolkit pour une configuration guidée ; les développeurs peuvent aussi suivre les tutoriels individuels.

Parcours de mise en œuvre : examen des spécifications, travail en sandbox, tests et lancement

Étape 1 : définir la tâche du client

Déterminez si l’application doit rechercher des produits, créer un panier, créer ou mettre à jour un paiement ou lire les informations de cycle de vie des commandes. Ces tâches utilisent des outils et autorisations différents.

Étape 2 : suivre le guide Shopify actuel

Utilisez le profil et les exemples API actuels. Ne copiez pas un ancien point de terminaison, profil, dépôt d’exemple ou URL de terrain d’essai sans vérifier qu’il est encore documenté.

Étape 3 : tester tout le parcours d’achat

Utilisez une boutique de développement pour tester l’authentification, les messages et statuts renvoyés, le transfert au paiement et la confirmation requise. Testez le type exact de commande ou paiement prévu ; Shopify documente des cas non pris en charge par les outils navigateur.

Étape 4 : limiter l’intégration aux capacités vérifiées

Déclarez et demandez uniquement les autorisations nécessaires. Précisez les étapes non prises en charge ou nécessitant confirmation de l’acheteur et vérifiez le comportement avant production.

Les prochaines étapes

La documentation publiée couvre la découverte catalogue, les paniers, le paiement et les informations de commande via des parcours MCP distincts. Shop MCP ajoute une connexion pour rechercher dans Shopify Catalog, créer des paniers et un paiement Shop Pay. Considérez les fonctions futures et dates de déploiement comme non annoncées tant qu’elles n’apparaissent pas dans la spécification officielle ou le journal Shopify.

Avant de fixer une feuille de route, vérifiez le profil, le point, les autorisations et types de commande ou paiement précis dans la documentation actuelle. Les outils, confirmations acheteur et types pris en charge diffèrent selon l’interface et peuvent évoluer avec les API.

Pour conclure

UCP fournit un protocole partagé et évolutif pour les parcours de commerce agentique. Les outils Shopify actuels couvrent la découverte, le panier et le paiement et le cycle de vie des commandes, avec des points, autorisations et limites distincts.

Les marchands doivent vérifier les interfaces activées et leurs parcours acheteur. Développeurs et agences doivent suivre la documentation, tester dans une boutique de développement et éviter de laisser entendre qu’une intégration modifie les commandes ou référence les produits dans toutes les interfaces IA sans prise en charge réelle.

Développeur observant un réseau commercial connecté pour planifier un déploiement

Questions fréquentes

UCP rend-il chaque application Shopify accessible à un agent ?

Une application nécessite une interface implémentée prise en charge par l’agent et l’interface Shopify visés. Une déclaration d’extension ou une norme ouverte seule n’expose pas ses fonctions.

Order MCP peut-il changer une adresse ou remplacer un produit ?

Order MCP récupère l’état des commandes passées via l’agent. Les changements d’adresse et de produit nécessitent un parcours distinct. Le retrait de lignes non traitées demandé par l’acheteur est une demande API distincte examinée par le marchand ou une application.

Comment recevoir les mises à jour de commande UCP sur Shopify ?

Organisez l’enregistrement des webhooks avec votre responsable partenaire, traitez les instantanés reçus et utilisez get_order lorsque l’acheteur demande des informations actualisées ou qu’une livraison doit être rapprochée.

Le paiement ChatGPT standard de Shopify est-il un paiement direct UCP ?

La vitrine agentique ChatGPT standard redirige vers le paiement de la boutique du marchand. D’autres canaux activés et intégrations d’agent distinctes peuvent utiliser d’autres parcours ; vérifiez celui que vous implémentez.

Que vérifier avant de déployer une intégration UCP ?

Vérifiez le point de terminaison, la version négociée, les capacités, autorisations, authentification et confirmations. Testez les produits indisponibles, le transfert au paiement et les mises à jour avec l’agent choisi avant publication.

Ressources

Cet article fait partie de notre série « Au-delà du paiement ». L’application Revize permet les modifications admissibles en libre-service avant traitement pendant une période définie par le marchand. Le changement et l’ajout de produits, les réductions et remboursements en crédit en boutique nécessitent Pro ; la modification par le personnel est en développement. Ce portail client est distinct d’une intégration d’agent UCP.

À lire aussi

Statistiques sur la modification des commandes Shopify · Vendre sur ChatGPT avec les vitrines agentiques Shopify · Guide des points de terminaison Shopify MCP et UCP · Guide Shopify AI Toolkit · Permettre aux clients de modifier leurs commandes Shopify