📋 Guide marchand

Configurez votre boutique en 5 étapes

Ce guide vous accompagne pas à pas pour configurer CinetPay, votre catalogue et tester votre premier flow de vente sur WhatsApp.

1 CinetPay
›
2 Connexion
›
3 Catalogue
›
4 Test
›
5 Équipe
💳

Step 1 — Créer et configurer votre compte CinetPay

CinetPay est le provider de paiement qui vous permet de recevoir de l'argent via Wave, Orange Money et MTN Money directement sur votre compte.

1 Créer un compte CinetPay Marchands

Deux options selon votre situation :

  1. Si vous n'avez pas encore de compte : Allez sur cinetpay.com → "Créer un compte" → choisissez "Compte Marchand". Remplissez vos informations (nom, numéro de téléphone, email, activité).
  2. Si vous avez déjà un compte CinetPay : Assurez-vous qu'il est de type "Marchand" (pas simplement acheteur). Si vous utilisez CinetPay pour recevoir des paiements dans une autre application, c'est bon — vous pouvez réutiliser le même compte ici.
💡

Astuce : Utilisez le même numéro de téléphone que vous utilisez pour Wave/Orange Money. Cela accélère la vérification de votre compte.

2 Récupérer votre API Key et Site ID

Une fois votre compte créé et validé :

  1. Connectez-vous à votre dashboard CinetPay.
  2. Allez dans Paramètres → Configuration API (ou directement dans le menu latéral).
  3. Copiez votre Site ID (c'est un nombre, ex : 123456). Vous le trouverez en haut de la page ou dans la section "Intégration".
  4. Générez ou copiez votre API Key. Si vous ne l'avez pas encore, cliquez sur "Générer une clé API".
⚠️ L'API Key est confidentielle — ne la partagez pas et ne la mettez pas dans un email.
🔑

Note : Si vous ne trouvez pas l'API Key dans vos paramètres, c'est probablement que votre compte n'est pas encore complet. Completez la vérification d'identité (KYC) dans votre espace CinetPay avant de continuer.

3 Configurer le webhook dans CinetPay

Le webhook indique à CinetPay où envoyer les confirmations de paiement. Sans lui, Vendaa ne peut pas savoir qu'un client a payé.

  1. Dans le dashboard CinetPay, allez dans Paramètres → Webhooks → Ajouter une URL de callback.
  2. Entrez cette URL :
    Chargement...
  3. Cochez les événements que vous voulez recevoir : minimum "Paiement accepté" et "Paiement refusé".
  4. Sauvegardez. Votre webhook est maintenant actif.
✅

Vérification : Une fois le webhook enregistré, CinetPay enverra un "ping" de test automatiquement. Vous pouvez aussi déclencheer un test manuellement depuis votre dashboard CinetPay.

4 Test : vérifier que le webhook arrive

Après avoir configuré le webhook, vérifiez que tout fonctionne :

  1. Allez dans la page Paiements de votre dashboard Vendaa.
  2. Cliquez sur "Créer un lien de paiement" (en haut à droite).
  3. Entrez un montant test (ex : 100 FCFA) et cliquez sur "Générer".
  4. Payez avec votre téléphone (Wave, Orange ou MTN). Même si le montant est petit, le flow complet se teste.
  5. Revenez sur la page Paiements. Si le statut affiche "Confirmé ✅" au lieu de "En attente ⏳" dans les 30 secondes, le webhook fonctionne.
⏳ Si le statut reste en attente après 2 minutes, le webhook n'a probablement pas été reçu. Revérifiez l'URL dans votre dashboard CinetPay et contactez le support Vendaa si le problème persiste.
🔗

Step 2 — Connecter CinetPay à votre dashboard Vendaa

Une fois CinetPay configuré, entrez vos identifiants dans Vendaa pour activer les paiements automatiques sur WhatsApp.

1 Accéder aux paramètres de paiement Vendaa

Dans votre dashboard Vendaa :

  1. Cliquez sur Paiements dans le menu latéral.
  2. En haut de la page, vous verrez une section "Configuration CinetPay" avec deux champs vides.
  3. Cliquez sur "Configurer CinetPay" pour ouvrir le panneau.
🔍

Où exactement : La section de configuration se trouve dans le bandeau vert en haut de la page /payments. Si vous ne la voyez pas, c'est que vous êtes peut-être sur un autre onglet — cliquez sur l'onglet "Configurer".

2 Entrer votre Site ID et API Key

Dans le formulaire de configuration :

  1. Entrez votre Site ID (le nombre trouvé à l'étape 1).
  2. Entrez votre API Key CinetPay.
  3. Cliquez sur Enregistrer.
🔒

Sécurité : Vos credentials sont chiffrés et stockés de manière sécurisée. Ils ne sont jamais affichés en clair après l'enregistrement — seul un indicateur de connexion est visible.

3 Vérifier le statut de connexion

Après l'enregistrement, vérifiez le badge de statut :

  • 🟢 Connecté — CinetPay est actif. Vos clients peuvent payer et vous recevrez les confirmations automatiquement.
  • 🔴 Erreur de connexion — Revérifiez le Site ID et l'API Key. Un caractère supplémentaire peut tout casser.
  • 🟡 Configuration incomplète — Certains champs manquent. Complétez-les.
🔄

Refresh automatique : Le statut se met à jour automatiquement après chaque modification. Pas besoin de recharger la page.

📦

Step 3 — Configurer votre catalogue produits

Plus votre catalogue est complet et bien décrit, mieux l'IA Vendaa peut conseiller vos clients sur WhatsApp.

1 Ajouter vos produits un par un

Allez sur la page Catalogue et cliquez sur "Nouveau produit" pour chaque article.

Pour chaque produit, remplissez :

  • Nom — Utilisez le nom que vos clients utilisent (ex : "Attièkè poulet", pas juste "Attièkè").
  • Prix — En FCFA, sans décimales (ex : 1500 pour 1 500 FCFA).
  • Catégorie — Important pour que l'IA.group les produits ("Plats", "Boissons", "Accessoires").
  • Description — Includez les détails utiles (ex : "avec alloco et braisé", "size M/L/XL"). L'IA s'en sert pour répondre aux questions.
  • Photo URL — Collez un lien vers une photo du produit. Idéal si la photo est déjà hébergée quelque part (WhatsApp, Google Drive en accès public, etc.).
  • Disponible — Activez/désactivez pour masquer les produits temporairement épuisés.
📸

Photos : Vous pouvez utiliser le lien d'une photo WhatsApp (envoyez la photo à votre propre WhatsApp, puis copiez le lien du message). Assurez-vous que le lien finit par .jpg ou .png.

2 Import massif avec fichier CSV

Si vous avez beaucoup de produits (plus de 10), utilisez l'import CSV pour gagner du temps.

Format CSV attendu
nom,prix,categorie,description,photo_url Attieké Poulet Braisé,1500,Plats,Vendues avec sauce tomate et alloco braisé, Riz Sauce Arachide,2000,Plats,Riz avec sauce arachide et légumes,https://example.com/riz.jpg Brochettes (5 pièces),1000,Grillades,Brochettes de boeuf marinées,https://example.com/brochettes.jpg Bissap,500,Boissons,Bissap frais sucrée,https://example.com/bissap.jpg Pagne Wax (6 yards),12000,Mode,Pagne wax 100% coton,https://example.com/pagne.jpg Coiffure Femme (tresses),15000,Services,Tresses avec extensions,https://example.com/coiffure.jpg

Pour importer : Allez sur Catalogue → cherchez le bouton "Importer CSV" → sélectionnez votre fichier → cliquez sur Importer.

⚠️ La première ligne du CSV doit être l'en-tête (nom,prix,categorie...). Le champ photo_url est optionnel. Séparateur : virgule.
3 Bonnes pratiques : 6-12 produits pour démarrer

L'IA Vendaa fonctionne mieux avec un catalogue maîtrisé. Voici pourquoi :

  • Moins de confusion : L'IA présente chaque produit naturellement. Avec 50+ produits, la conversation peut partir dans toutes les directions.
  • Meilleur résumé : L'IA fait un résumé groupé ("On a des plats à 1500-2500 FCFA et des boissons à 500-1000 FCFA"). Plus le catalogue est petit, plus le résumé est pertinent.
  • Focus client : Au lieu de lister tout, l'IA pose des questions pour affiner ("C'est pour emporter ou sur place ?") et propose les produits adaptés.
🚀

Recommandation : Commencez avec 6-12 produits vedettes (votre best-seller). Une fois le flow rodé, ajoutez le reste progressivement. L'ordre des produits dans le catalogue n'a pas d'importance — l'IA les restructure selon la conversation.

🧪

Step 4 — Tester le flow complet de vente

Avant de promouvoir votre boutique, vérifiez que le cycle complet fonctionne : client commande → paiement → confirmation.

1 Récupérer votre QR code et lien WhatsApp

Allez sur la page WhatsApp de votre dashboard :

  • QR Code — Téléchargeable en 300×300 px. Imprimez-le ou partagez-le par email/WhatsApp à un ami testeur.
  • Lien de boutique — Format : vendaa.app/s/votre-boutique. Partagez ce lien par SMS ou WhatsApp à votre testeur.
📱

Pour le test, utilisez un autre téléphone que celui qui est connecté à votre WhatsApp Business. Ainsi vous verrez exactement ce que vos clients verront.

2 Script de test : commande → paiement → confirmation

Demandez à votre testeur de suivre ces étapes :

Script de test complet
  1. Ouvrir le lien ou scanner le QR code → une conversation WhatsApp démarre.
  2. Envoyer : "Bonjour" → L'IA doit répondre avec votre message de bienvenue personnalisé.
  3. Envoyer : "Je veux commander" → L'IA doit lister vos produits (groupés par catégorie).
  4. Répondre : "Je prends [nom du produit]" → L'IA doit confirmer la commande avec le prix.
  5. Confirmer : "Oui je prends" → L'IA doit envoyer un lien de paiement CinetPay.
  6. Cliquer sur le lien → payer sur CinetPay (Wave/Orange/MTN).
  7. Après paiement : L'IA doit envoyer un message de confirmation "Paiement confirmé ✅" et la commande doit apparaître dans votre dashboard Commandes.

Vérifiez aussi que vous recevez une notification dans votre dashboard (badge sur l'icône Commandes).

3 Vérifier la commande dans le dashboard

Après le test :

  1. Allez sur la page Commandes.
  2. La nouvelle commande doit apparaître en haut de la liste avec le statut "Confirmée" (si le webhook a fonctionné) ou "En attente" (si le paiement n'est pas encore confirmé par le webhook).
  3. Cliquez sur la commande pour voir les détails : client, produits, montant, méthode de paiement.
  4. Vérifiez que le montant dans Vendaa correspond au montant réel payé sur CinetPay.
✅

Si tout fonctionne : Bravo ! Votre boutique est prête. Vous pouvez maintenant promouvoir votre QR code et votre lien WhatsApp.

👥

Step 5 — Ajouter des empleados (optionnel)

Si vous avez du personnel qui répond aux clients en plus de vous, vous pouvez leur donner accès au dashboard Vendaa.

1 Comment les empleados accèdent au dashboard

Chaque employée utilise le même compte que vous — pas de compte séparé pour le moment. Ils se connectent avec le même email et mot de passe que vous.

  • Créez un email professionnel pour votre empleado (ex : employe@boutique.com) ou partagez les identifiants existants.
  • L'employé peut accéder à toutes les pages : Tableau de bord, Catalogue, Messages, Commandes.
  • L'IA répond automatiquement sur WhatsApp — l'employé peut intervenir si nécessaire en répondant manuellement dans la conversation.
🔒 Important : L'employé aura accès complet au dashboard (modifier produits, voir paiements, répondre aux clients). Choisissez une personne de confiance. Pour le moment, il n'y a pas de niveaux d'accès limités.
2 Gérer les escalades clients

Quand l'IA ne peut pas répondre (question complexe, réclamation), elle escalade automatiquement :

  • Après 2 réponses infructueuses sur un même sujet, le client voit un message "Un conseiller va vous répondre".
  • Une badge "⚠️ Humain" apparaît dans votre liste de conversations pour vous alerter.
  • Vous (ou votre employée) pouvez alors répondre manuellement dans la conversation.
💡

Améliorer les réponses : Plus vous ajoutez de produits, de descriptions et de FAQ dans Mon business, moins l'IA aura besoin d'escaler.

❓

Questions fréquentes

  1. Vérifier le numéro WhatsApp du client — Le lien est envoyé par WhatsApp. Si le numéro est incorrect ou non enregistré sur WhatsApp, le message ne sera pas délivré.
  2. Vérifier le statut CinetPay — Allez sur Paiements. Si le lien est affiché mais pas cliqué, c'est un problème client. Demandez-lui de vérifier qu'il a accès à son WhatsApp.
  3. Créer un lien manuel — Dans la page Paiements, utilisez le bouton "Créer un lien de paiement" pour générer un lien que vous pouvez copier-coller dans la conversation manuellement.
  4. Problème de connexion CinetPay — Si le badge montre "Erreur de connexion", revérifiez vos credentials dans les paramètres.

Cela signifie que le webhook CinetPay n'a pas été reçu par Vendaa. Le paiement a été fait mais Vendaa ne le sait pas encore.

  1. Vérifiez le webhook dans CinetPay — L'URL de callback est bien configurée (voir Step 1.3).
  2. Testez le webhook manuellement — Depuis votre dashboard CinetPay, utilisez la fonction "Envoyer un test" pour envoyer un ping à Vendaa.
  3. Attendez 2-5 minutes — Parfois il y a un délai. Rafraîchissez la page Commandes.
  4. Si le problème persiste : contactez le support Vendaa avec le numéro de transaction CinetPay. Nous pourrons vérifier manuellement le paiement.

Note : Si un client vous confirme le paiement par un screenshot, vous pouvez marquer la commande comme "payée" manuellement dans le dashboard en attendant que le webhook arrive.

Les méthodes de paiement (Wave, Orange Money, MTN Money) sont gérées par CinetPay — vous n'avez rien à configurer de plus. Une fois CinetPay connecté, toutes les méthodes de paiement supportées par votre compte CinetPay sont automatiquement disponibles.

Pour vérifier quelles méthodes sont actives :

  1. Connectez-vous à votre dashboard CinetPay.
  2. Allez dans Paramètres → Moyens de paiement acceptés.
  3. Activez les méthodes que vous voulez accepter (Wave, Orange Money, MTN Money).

Vendaa affichera automatiquement les méthodes disponibles pour chaque client lors du paiement.

Si l'IA ne reconnaît pas certains produits ou répond mal :

  1. Vérifiez les noms dans le catalogue — Utilisez les termes que vos clients utilisent réellement. Ex : "attiéké" et pas "attieke" (caractère accentué).
  2. Ajoutez des descriptions détaillées — Plus le produit a de contexte, mieux l'IA comprend. Ex : "Poulet braisé avec attiéké et mayo" est mieux que "Poulet".
  3. Ajoutez des FAQ — Dans Mon business, ajoutez les questions fréquentes de vos clients avec les réponses. L'IA les utilise.
  4. Configurez votre message de bienvenue — Dans Mon business, écrivez un message qui explique clairement comment commander. Ex : "Bienvenue ! Dites-moi ce que vous cherchez et je vous propose nos produits."

CinetPay applique une commission sur chaque transaction réussie :

  • Commission CinetPay : environ 1,5% à 2% par transaction, selon votre formule.
  • Commission Vendaa : 5% sur chaque transaction (c'est ce qui permet de maintenir le service). L montant affiché dans votre dashboard Paiements est le montant net que vous recevez.

Exemple : Un client paie 10 000 FCFA. Vous recevez environ 9 800 FCFA (10 000 - 1,5% CinetPay - 5% Vendaa ≈ 9 350 FCFA après les deux commissions, selon les taux actuels).

Les commissions sont déjà déduites du montant affiché dans le dashboard. Le virement CinetPay arrive sur votre compte avec les commissions prélevues.

Les virements CinetPay sont généralement automatiques :

  • Wave : Virement instantané vers votre compte Wave.
  • Orange Money : Virement généralement sous 24h ouvrés vers votre compte Orange Money.
  • MTN Money : Virement sous 24-48h vers votre compte MTN.

Les délais dépendent de CinetPay et de votre formule de compte. Consultez votre dashboard CinetPay pour voir l'historique des virements.