Intégrer Odoo pas à pas

Ce guide suit un exemple concret : Boutique Awa, une PME de Lomé qui facture ses clients dans Odoo. À la fin, Awa clique sur un bouton dans sa facture, son client paie depuis son téléphone, et la facture passe Payée toute seule.

Comptez 30 minutes pour tout faire en mode test, sans vrai paiement.

Vue d'ensemble#

Partie 1 — Dans la console pismile#

1. 1. Créez votre compte

   Rendez-vous sur pismile.com/signup et créez votre compte avec votre adresse e-mail. Ce compte est personnel : c'est vous, pas votre entreprise.

2. 2. Créez votre organisation

   L'organisation représente votre activité. Depuis votre espace, cliquez sur Nouvelle organisation :

   • Nom affiché : le nom que vos clients connaissent, par exemple « Boutique Awa ».

   • Pays : le pays de votre activité.

   • Type de compte : « Entreprise » si vous avez une société (RCCM, NIF), « Développeur indépendant » sinon. Ce choix ne pourra plus être modifié.

   • Que voulez-vous faire avec pismile ? : cochez Encaissement.

   Cliquez sur Créer l'organisation. Vous arrivez dans la console, en mode test.

3. 3. Activez l'encaissement et enregistrez votre accès PI-SPI

   a. Le module. Console → Modules → Encaissement PI-SPI → Activer (si vous ne l'avez pas coché à la création).

   b. Votre accès. Votre banque ou votre mobile money vous fournit un accès PI-SPI (souvent dans un espace « Accès API » chez eux). Console → Encaissement → Accès participant, puis recopiez :

   • le Participant (le nom de votre banque ou mobile money) ;

   • l'URL de l'API et l'URL du jeton ;

   • l'Identifiant client et le Secret client ;

   • l'Alias qui reçoit les paiements : le compte où l'argent arrivera.

   Cliquez sur Enregistrer et tester. Le statut doit indiquer que le test a réussi.

4. 4. Choisissez une offre pour le connecteur Odoo

   Console → Plan et usage → section Connecteurs → Offres Odoo.

   Comparez les offres (prix, encaissements inclus par mois, nombre d'installations), puis cliquez sur Mensuel ou Annuel. Vous êtes redirigé vers la page de paiement sécurisée ; une fois le paiement validé, l'abonnement est actif immédiatement. Une offre gratuite s'active d'un clic sur Activer.

5. 5. Créez la clé de votre installation Odoo

   Console → Encaissement → Connecteurs. Dans la carte Odoo, sous Nouvelle installation :

   • donnez un nom, par exemple « Odoo Boutique Awa » ;

   • laissez Test coché pour commencer ;

   • cliquez sur Créer la clé.

   La clé s'affiche, elle commence par pmc_test_.

Partie 2 — Dans Odoo#

1. 6. Installez le module pismile

   Le module s'appelle pismile_connecteur. Votre intégrateur ou votre hébergeur le copie dans le dossier des modules d'Odoo (le dossier « addons » de votre installation), puis :

   1. Activez le mode développeur : Paramètres → tout en bas, Activer le mode développeur.

   2. Ouvrez Applications → Mettre à jour la liste des applications.

   3. Cherchez « pismile », retirez le filtre « Applications », puis cliquez sur Activer devant pismile — Encaissement PI-SPI.

2. 7. Branchez Odoo sur pismile

   a. La connexion. Dans Odoo : Facturation → Configuration → Paramètres, bloc pismile — Encaissement PI-SPI :

   Champ	Ce qu'il faut mettre
   Adresse de l'API pismile	https://pismile.com/api/connect/v1
   Clé pismile	la clé pmc_test_… copiée à l'étape 5
   Journal des encaissements PI-SPI	votre journal de Banque, celui du compte qui reçoit les paiements
   Enregistrer les paiements de test	coché pendant les essais

   Cliquez sur Enregistrer, puis sur Tester la connexion. Odoo affiche le nom de votre organisation : c'est branché.

   b. Le webhook (mise à jour immédiate). Toujours dans le bloc pismile, la ligne Webhook affiche l'adresse de votre Odoo, par exemple :

   TexteCopier

   https://odoo.boutique-awa.tg/pismile/webhook/1

   1. Copiez cette adresse.

   2. Dans la console pismile : Encaissement → Connecteurs → votre installation → Événements.

   3. Collez l'adresse, cliquez sur Enregistrer l'adresse. pismile affiche un secret de signature qui commence par whsec_.

   4. Copiez ce secret dans Odoo, champ Secret du webhook, puis Enregistrer.

   5. Revenez dans la console et cliquez sur Envoyer un test. La ligne doit afficher 200 dans Derniers envois.

3. 8. Renseignez l'alias PI-SPI de vos clients

   Ouvrez la fiche d'un client (Facturation → Clients → Clients). Sous le numéro fiscal, remplissez Alias PI-SPI : en général son numéro de téléphone, par exemple +22890123456.

   C'est à cet alias que la demande de paiement arrive. Pas besoin de le faire à l'avance pour tous : vous pouvez aussi le saisir au moment de la première demande, Odoo le retient pour la suite.

Partie 3 — Votre première facture payée#

1. 9. Envoyez une demande de paiement

   1. Créez une facture client en F CFA, par exemple 35 000 F CFA, et cliquez sur Confirmer.

   2. Cliquez sur Demander le paiement PI-SPI.

   3. Vérifiez l'alias du client et le montant. Vous pouvez demander une partie seulement (un acompte), jamais plus que le reste à payer. Le motif est ce que le client lit dans sa banque ; par défaut « Facture » suivi du numéro.

   4. Cliquez sur Envoyer la demande.

   Un message apparaît dans l'historique de la facture : « demande FAC/2026/00001 envoyée ». Un onglet PI-SPI affiche le suivi.

2. Votre client paie

   Votre client reçoit une notification dans son application bancaire ou mobile money : une demande de 35 000 F CFA avec le motif « Boutique Awa - Facture FAC/2026/00001 ». Le nom de votre organisation est toujours affiché en premier, pour que votre client sache qui lui demande de payer. Il vérifie et valide.

   En mode test, rien n'arrive sur un vrai téléphone : pismile simule la réponse du client en une dizaine de secondes.

3. La facture passe « Payée »

   Dès que le client a payé, Odoo, sans aucune action de votre part :

   • crée le paiement dans votre journal de Banque, avec la référence PI-SPI (utile pour le rapprochement bancaire) ;

   • le lettre avec la facture, qui passe Payée ;

   • ajoute un message dans l'historique de la facture.

Essayer tous les cas en mode test#

Avec une clé de test, le résultat dépend des derniers chiffres du montant :

Si une demande est refusée ou expirée, la facture reste à payer. Cliquez à nouveau sur Demander le paiement PI-SPI : Odoo envoie une nouvelle demande avec la référence FAC/2026/00002-2.

Suivre toutes vos demandes#

• Dans Odoo : Facturation → Clients → Demandes PI-SPI. Filtrez par statut (en attente, payées, sans suite) ou regroupez par client.

• Dans la console pismile : Encaissement → Connecteurs → Demandes.

Partie 4 — Passer aux vrais paiements#

1. Vérifiez les conditions

   • Votre organisation est vérifiée (console → Vérification).

   • Votre accès participant est enregistré et le test réussit.

   • Votre abonnement Odoo est en cours.

   • Votre Odoo est en https si vous utilisez le webhook.

2. Créez une clé de production

   Console → Encaissement → Connecteurs → carte Odoo → Nouvelle installation, nom « Odoo production », Test décoché, Créer la clé. La clé commence par pmc_live_. Configurez son webhook comme à l'étape 7b : chaque installation a son propre secret.

3. Mettez à jour Odoo

   Dans les paramètres pismile d'Odoo, remplacez la clé de test par la clé pmc_live_…, remplacez le secret du webhook, puis Tester la connexion.

4. Faites un premier essai réel

   Envoyez une petite facture à vous-même ou à un collègue, par exemple 100 F CFA. Quand elle passe « Payée », vérifiez que l'argent est bien sur votre compte. Vous pouvez ensuite révoquer l'installation de test dans la console.

Partie 5 — Votre facture pismile#

Le connecteur est facturé par pismile, à part de vos encaissements : l'argent de vos clients ne transite jamais par pismile, il n'y a donc rien à prélever dessus.

Ce que vous payez#

• L'abonnement de votre offre Odoo, au mois ou à l'année (l'annuel est moins cher).

• Des frais par encaissement payé, si votre offre en prévoit (un montant fixe et/ou un pourcentage). Seules les demandes payées comptent : une demande refusée, expirée ou de test ne coûte rien.

Exemple chiffré#

Comment se passe le renouvellement#

1. 7 jours avant l'échéance

   pismile émet votre facture de renouvellement : le prix de l'offre pour la période suivante, plus les frais d'encaissement depuis la dernière facture.

2. Vous payez en ligne

   Console → Plan et usage → À payer → Payer. Le paiement est sécurisé et l'abonnement est prolongé dès sa confirmation.

3. Vous retrouvez vos factures

   Toutes vos factures, avec leur numéro légal, sont dans Plan et usage → Factures.

Suivre et arrêter#

• Plan et usage → Connecteurs affiche votre offre, l'échéance et le nombre d'encaissements payés ce mois-ci par rapport à votre quota.

• Pour arrêter, cliquez sur Ne pas renouveler : l'abonnement reste actif jusqu'à la fin de la période déjà payée, puis s'arrête. Vous pouvez revenir sur ce choix avec Renouveler.

En cas de souci#

Pour le détail des statuts, délais et limites, lisez Le connecteur au quotidien.