Headless commerce : définition et architecture

Le mot sert à tout, et souvent à vendre. Voici ce qu'il recouvre quand on regarde l'architecture plutôt que la brochure.

L'architecture, en une image

   votre site        application mobile        agent IA
        \                  |                    /
         \                 |                   /
          ------------- API HTTP --------------
                           |
                  moteur de commerce
        catalogue | panier | checkout | commandes
                           |
                    PSP, emails, webhooks

La frontière n'est pas esthétique : elle est contractuelle. Tout ce qui se décide (un prix, un total, un état de commande) est du côté du moteur. Tout ce qui s'affiche est du côté de la tête.

Ce que la séparation apporte

Le frontend redevient un choix. Vous pouvez le refaire, le changer de technologie, en avoir deux, sans toucher au commerce. C'est particulièrement vrai pour un site généré par une IA : il évolue vite, et il n'a pas à emporter le catalogue avec lui à chaque refonte.

Les données ont une seule source. Un prix vient du catalogue. Un total vient du serveur. Un état de commande vient de la notification du PSP. Rien de tout cela ne se recopie dans un composant, donc rien ne se périme en silence.

Les nouveaux canaux ne coûtent pas une refonte. Une application, une borne, une place de marché, un agent : ce sont des clients de la même API.

Ce qu'elle coûte

Il faut être honnête sur le prix à payer.

Le headless n'est pas plus « moderne » : il est plus adapté quand le site existe déjà, ou quand plusieurs canaux doivent partager le même catalogue. Pour un lancement sans site ni contrainte, une plateforme intégrée reste le chemin le plus court.

Comment reconnaître un backend réellement découplé

1. Le catalogue se lit sans authentification. Une vitrine est publique ; s'il faut une clé secrète pour afficher un prix, la clé finira dans le navigateur.
2. Les totaux sont calculés côté serveur. Si l'API accepte un prix envoyé par le client, ce n'est pas un backend de commerce, c'est un formulaire.
3. Le checkout est hébergé ou entièrement pilotable. Entre les deux se trouvent les tunnels à moitié imposés, qui vous laissent la responsabilité sans la maîtrise.
4. Les paiements arrivent sur votre compte. Un moteur qui encaisse pour vous ajoute un intermédiaire à votre trésorerie et à votre comptabilité.
5. Il y a des webhooks sortants. Sans eux, votre système d'information apprend vos ventes en interrogeant l'API en boucle.

Où se place Ts-Shop

Ts-Shop est un moteur de commerce headless pour des sites qui existent déjà. Le catalogue et le panier sont publics par API, les totaux sont calculés par le serveur, le checkout est hébergé (pour ne pas vous imposer la conformité du tunnel de paiement), et l'encaissement va sur votre compte PSP.

Au Lot 1, il vend des Disponibleservices : des prestations. Le stock et la livraison sont des lots ultérieurs, et un produit physique sans livraison donnerait une commande qu'on ne sait pas expédier.

Questions courantes

Headless veut-il dire « sans interface » ? Non : sans interface imposée. Le checkout de Ts-Shop, par exemple, est bien une interface, hébergée pour des raisons de conformité.

Faut-il un développeur ? Pour brancher l'API, oui. Un assistant peut écrire l'essentiel s'il dispose du serveur MCP.

Et le référencement ? C'est celui de votre site, qui ne bouge pas. Voir Comment ajouter l'e-commerce à un site existant.

Pour aller plus loin

• Comment ajouter l'e-commerce à un site existant
• Pourquoi le webhook PSP est la source de vérité du paiement