Passer au contenu principal

​
Phase 1 : Configuration backend (API REST)

Cette étape permet à Kleep de récupérer votre catalogue produits, l’historique des commandes et les données de retours/remboursements afin de calibrer l’algorithme.

​
1. Créer une clé API REST

  1. Connectez-vous à votre panneau d’administration WordPress.
  2. Accédez à WooCommerce > Réglages > Avancé > API REST.
  3. Cliquez sur « Ajouter une clé ».
  4. Renseignez les champs suivants :
    • Description : Saisissez un nom (par exemple, « Kleep Integration »)
    • Utilisateur : Sélectionnez un utilisateur administrateur
    • Permissions : Sélectionnez Lecture
  5. Cliquez sur « Générer la clé API ».

​
2. Récupérer et enregistrer les identifiants

Après la génération, WooCommerce affichera deux identifiants :
  • Consumer Key (commence par ck_)
  • Consumer Secret (commence par cs_)
⚠️ Important : Le Consumer Secret n’est affiché qu’une seule fois. Copiez immédiatement les deux valeurs et conservez-les en lieu sûr.

​
3. Prérequis

  • Votre boutique WooCommerce doit utiliser HTTPS pour que les clés API fonctionnent de manière sécurisée.
  • La version v3 de l’API REST WooCommerce est requise (WooCommerce 3.5+).
  • Si vous utilisez des plugins de retours/RMA personnalisés (par exemple, YITH WooCommerce RMA, ReturnGO), veuillez nous en informer afin que nous puissions coordonner la bonne approche d’intégration.

​
4. Configuration du pare-feu

If your store is behind a firewall or uses IP-based access restrictions, please whitelist the following Kleep IP addresses to ensure uninterrupted API access:
  • 34.1.4.3
  • 82.66.252.201
  • 176.148.67.162

​
5. Envoyer les identifiants à Kleep

Veuillez envoyer les informations suivantes à votre contact Kleep par e-mail :
  1. URL de votre boutique (par exemple, https://yourstore.com)
  2. Consumer Key (ck_...)
  3. Consumer Secret (cs_...)

​
Phase 2 : Intégration frontend (Widget)

Cette étape consiste à ajouter le script Kleep à vos pages produits (PDP). Compatible avec toutes les versions de WooCommerce. Suivez notre guide Widget Bibliothèque JS pour installer et configurer le CTA frontend sur vos pages produits.

​
Phase 3 : Gestion des données manquantes (SFTP)

Cette section s’applique lorsque des données ne peuvent pas être récupérées via les endpoints API standard. Si votre boutique WooCommerce utilise un plugin de retours/RMA tiers qui n’expose pas les données de retours via l’API REST WooCommerce standard, nous procédons par échange de fichiers CSV. Veuillez vous référer à la documentation ci-dessous. Ce guide vous guidera pas à pas dans le processus de transmission des données manquantes. Concentrez-vous sur la partie relative aux données de retours.

​
Cookies & confidentialité des données

Kleep est entièrement conditionné par le consentement du visiteur : le script ne se charge qu’après que le consentement a été collecté via votre CMP, et vous devez conditionner son chargement en conséquence. Pour la liste complète des traceurs, les données traitées, les finalités et bases légales, l’hébergement, les sous-traitants et la sécurité, consultez Cookies, CMP & confidentialité des données.