# Connecter WooCommerce à RUIT

Tutoriel pour connecter WooCommerce : saisissez l'adresse de votre boutique et approuvez l'accès dans WordPress, ou créez des clés d'API à coller dans RUIT.

_Updated: 2026-09-28 · Source: https://ruit.es/fr/docs/connecter-woocommerce/_

Dans ce tutoriel, vous connectez votre boutique WooCommerce à RUIT. Il y a deux chemins, et tous
deux mènent au même endroit : **autoriser depuis votre propre boutique**, le plus court (vous
saisissez son adresse, vous approuvez dans votre WordPress et vous revenez), ou **coller des clés**
que vous générez vous-même dans WooCommerce. Cela prend **cinq minutes** et se fait **une seule
fois**.

**Il vous faut** être administrateur de la boutique, WooCommerce **3.5 ou supérieur** et une
boutique servie en `https://` **à la racine de son domaine**, comme `https://votreboutique.com`.
Il vous faut aussi votre [téléphone vérifié](https://ruit.es/fr/docs/verifier-votre-telephone/), car sans cela
l'assistant de connexion ne s'ouvre pas.

> **Avertissement:** RUIT ne garde que le domaine de l'adresse que vous saisissez. Un WordPress installé dans un
> dossier, comme `https://mondomaine.com/boutique/`, perd ce dossier en chemin et ne peut pas être
> connecté pour l'instant.

## 1. Saisissez l'adresse de votre boutique dans RUIT

Allez dans **Paramètres → Comptes**, appuyez sur **Connecter un compte** et choisissez
**WooCommerce**. Saisissez l'adresse de votre boutique dans **Site web**.

_Capture: La fenêtre de connexion à WooCommerce dans RUIT : la demande de remplir les informations requises, le lien vers ce guide, le champ Site web, le bouton de connexion et, en dessous, le menu déroulant pour se connecter manuellement_

La fenêtre de WooCommerce. Le numéro désigne **Site web**. Sous le bouton,
**Vous préférez vous connecter manuellement ?** déplie le chemin des clés, qui est l'étape 4.

## 2. Approuvez l'accès depuis votre boutique

Appuyez sur **Se connecter avec WooCommerce**. Tant que l'adresse est vide, le bouton affiche
**Remplir les champs requis** ; une fois l'adresse saisie, il vous emmène sur l'écran
d'autorisation de votre propre boutique. Si votre session d'administrateur n'est pas ouverte,
WordPress vous demande d'abord de vous connecter.

L'écran indique ce que RUIT demande : **lire et écrire** dans votre boutique, ce dont il a besoin
pour publier des produits, tenir le stock à jour et être informé des ventes. Appuyez sur
**Approuver**.

_Capture: La page d'autorisation de la boutique WooCommerce : l'avis indiquant que RUIT veut se connecter avec un accès en lecture et en écriture, la liste de ce qu'il pourra faire, le compte administrateur avec lequel vous êtes connecté et les boutons pour refuser et approuver_

L'autorisation, vue sur une boutique dont l'administration est en anglais. Le cadre désigne
**Approuver** ; dans votre boutique, les libellés s'affichent dans la langue de votre WordPress.

> **Avertissement:** Cette autorisation expire **15 minutes** après que vous avez appuyé sur le bouton. Si vous la
> laissez en plan, revenez à l'étape 1 et recommencez.

## 3. Revenez à RUIT

Votre boutique génère une paire de clés et les envoie elle-même à RUIT ; RUIT les vérifie auprès de
votre boutique, enregistre le compte et vous affiche **WooCommerce connecté**. Appuyez sur
**Voir mes comptes** et passez directement à « Ce que vous avez accompli ».

## 4. Ou collez les clés à la main

Si votre boutique ne vous laisse pas approuver, ou si vous préférez créer la clé vous-même, l'autre
chemin passe par des clés de l'API WooCommerce. Elles se génèrent dans votre WordPress, dans
**WooCommerce → Réglages → Avancé → API REST**, avec le bouton **Ajouter une clé**.

_Capture: L'onglet Avancé des réglages de WooCommerce, dans la section API REST, avec la liste des clés existantes et le bouton pour ajouter une clé à côté du titre_

La liste des clés de votre boutique, avec l'administration en anglais. Le cadre désigne
**Ajouter une clé**.

Donnez-lui une description que vous reconnaîtrez, choisissez un **administrateur** comme
utilisateur et, pour les autorisations, **Lecture/Écriture**. Appuyez sur **Générer une clé API**.

_Capture: Le formulaire de la nouvelle clé dans WooCommerce : le champ de description, le sélecteur d'utilisateur, le sélecteur d'autorisations avec Lecture/Écriture choisi et le bouton pour générer la clé_

Les trois cadres : la **description**, les **autorisations** en lecture et écriture, et le bouton
pour **générer**. L'utilisateur est masqué, car il affiche l'e-mail de l'administrateur.

> **Avertissement:** Créez la clé avec **Lecture/Écriture**. RUIT ne vérifie pas les autorisations à la connexion : avec
> une clé en lecture seule, la connexion réussit, et ce sont les notifications que votre boutique
> envoie à RUIT à chaque vente qui échouent ensuite, sans rien dire.

WooCommerce ne vous montre les deux clés **qu'une seule fois** : la clé client, qui commence par
`ck_`, et la clé secrète, qui commence par `cs_`. Copiez-les maintenant ; si vous fermez la page,
vous devrez générer une autre clé.

_Capture: La page de WooCommerce après la génération de la clé : l'avis invitant à copier les clés maintenant, les champs de la clé client et de la clé secrète avec leur bouton de copie, et le code QR_

Les deux clés, masquées ici. Les cadres désignent les deux boutons pour **copier** ; l'avis vert
prévient que la clé secrète ne s'affichera plus.

Revenez à RUIT, dépliez **Vous préférez vous connecter manuellement ?** et remplissez
**Site web**, **Clé consommateur** et **Secret consommateur**. Appuyez sur **Connecter**. RUIT
vérifie que les clés ont le bon format, puis les teste auprès de votre boutique.

## Ce que vous avez accompli

Votre boutique apparaît dans **Comptes connectés** avec sa carte WooCommerce. Les clés n'expirent
pas, donc la carte n'a pas le bouton **Reconnecter** que proposent Wallapop et Vinted : la
connexion dure jusqu'à ce que vous supprimiez la clé dans WooCommerce. De plus, votre boutique a
été configurée pour informer RUIT de chaque vente sur le moment, sans attendre aucune vérification
périodique.

_Capture: L'écran Comptes connectés de RUIT avec une carte par marketplace, dont celle de WooCommerce avec la boutique connectée, et le bouton pour connecter un compte en haut à droite_

La boutique WooCommerce parmi les comptes connectés. Sa carte porte le nom que vous voulez lui
donner, et aucun bouton de reconnexion.

**Étape suivante :** importer depuis une marketplace pour rapatrier les produits que vous avez déjà
dans la boutique, ou [publier votre premier produit](https://ruit.es/fr/docs/votre-premiere-annonce/).

## Si quelque chose cloche

- **« Impossible de vérifier les identifiants. Vérifiez vos clés d'API et l'URL de votre
  boutique ».** RUIT a interrogé votre boutique et n'a pas obtenu de réponse valide. Le message est
  le même quelle que soit la cause, alors vérifiez-les dans l'ordre : l'adresse pointe vers la
  racine du domaine ; l'API WooCommerce répond sur `https://votreboutique.com/wp-json/wc/v3/` (un
  plugin de sécurité ou les permaliens de WordPress réglés sur **Simple** la désactivent) ;
  WooCommerce est en version 3.5 ou supérieure ; et les clés sont copiées en entier.
- **« Format d'identifiants invalide ».** La clé ne commence pas par `ck_` ou le secret ne commence
  pas par `cs_`. Copiez-les à nouveau toutes les deux, sans espaces.
- **« L'URL doit utiliser HTTPS (pas HTTP) ».** RUIT ne connecte pas les boutiques sans `https://`.
  Installez un certificat sur la boutique et réessayez.
- **Vous revenez avec « WooCommerce connecté », mais la carte n'apparaît pas dans Comptes.** Votre
  boutique a approuvé, mais RUIT n'a pas pu vérifier les clés auprès d'elle. Essayez le chemin des
  clés, l'étape 4, qui vous dit sur-le-champ ce qui ne va pas.
- **« La connexion n'a pas été autorisée ».** Vous avez appuyé sur **Refuser** dans votre boutique.
  Recommencez depuis l'étape 2 et acceptez les autorisations demandées.
- **Plus de 15 minutes se sont écoulées avec l'autorisation ouverte.** Elle a expiré. Recommencez
  depuis l'étape 1.

- [Vendre sur WooCommerce avec RUIT](https://ruit.es/fr/docs/marketplaces/)
- [Connecter PrestaShop à RUIT](https://ruit.es/fr/docs/connecter-prestashop/)
- [Comment fonctionne la connexion d'un compte](https://ruit.es/fr/docs/comment-fonctionne-la-connexion-d-un-compte/)