pismile

Le connecteur au quotidien

La vie d'une demande de paiement, les délais, les limites, le quota de votre offre et la sécurité, expliqués simplement.

5 min de lecture · Mis à jour le · API v1

Connectez-vous pour voir vos propres identifiants sandbox dans les exemples.

Une fois Odoo branché, vous n'avez plus qu'un geste à faire : Demander le paiement PI-SPI sur une facture. Cette page explique ce qui se passe ensuite, et pourquoi.

La vie d'une demande#

Chaque demande a un statut. Vous le voyez dans l'onglet PI-SPI de la facture, dans Demandes PI-SPI d'Odoo et dans la console pismile.

Statut

Ce que ça veut dire

Et la facture ?

En attente

La demande est chez votre client, il n'a pas encore répondu.

Reste à payer. Pas de nouvelle demande possible tant que celle-ci est en attente.

Payée

Le client a validé. L'argent est sur votre compte.

Paiement enregistré et lettré, facture Payée (ou partiellement payée pour un acompte).

Refusée

Le client a refusé, ou sa banque a rejeté le paiement.

Reste à payer. Vous pouvez renvoyer une demande.

Expirée

Le client n'a pas répondu avant la date limite.

Reste à payer. Vous pouvez renvoyer une demande.

Annulée

La demande a été annulée avant paiement.

Reste à payer.

Échec d'envoi

Votre banque ou mobile money n'a pas accepté la demande (accès invalide, alias inconnu…).

Reste à payer. Vérifiez l'alias et votre accès participant.

Combien de temps a le client pour payer ?#

  • Si la facture a une date d'échéance dans le futur, c'est elle qui sert de date limite.

  • Sinon, le client a 72 heures.

  • La date limite ne peut pas dépasser 7 jours. Passé ce délai, la demande expire : relancez-la si besoin.

Les limites, pour protéger vos clients#

PI-SPI est un moyen de paiement grand public. Pour éviter qu'un client soit submergé de demandes (par erreur ou par malveillance), pismile applique des garde-fous simples :

Règle

Valeur

Demandes en attente en même temps pour un même client

3 au plus

Demandes envoyées à un même client sur 24 heures

10 au plus

Montant d'une demande

de 1 à 5 000 000 F CFA

Une facture

une seule demande en attente à la fois

Si une limite est atteinte, Odoo affiche un message qui explique la raison. Il suffit d'attendre que le client réponde, ou le lendemain.

Le quota de votre offre#

Chaque offre inclut un nombre d'encaissements payés par mois (ou illimité). Seules les demandes payées et hors test comptent.

  • Vous suivez votre consommation dans Plan et usage → Connecteurs, avec une barre de progression.

  • Selon l'offre, au-delà du quota, soit vous continuez normalement, soit les nouvelles demandes sont suspendues jusqu'au mois suivant. Les offres concernées portent la mention « Plafonnés ».

  • Le compteur repart à zéro le 1er de chaque mois.

Ce que voit votre client#

Votre client ne voit ni pismile, ni Odoo. Il voit, dans sa propre application bancaire ou mobile money :

  • le nom de votre organisation, toujours en premier ;

  • le motif, par défaut « Facture » suivi du numéro ;

  • le montant en F CFA et la date limite.

Il n'a rien à installer, aucun compte à créer, aucun numéro de compte à recopier.

Comment Odoo apprend que le client a payé#

pismile prévient Odoo de deux façons, qui se complètent :

  1. Le webhook : dès que la demande change, pismile envoie un message signé à votre Odoo. La facture se met à jour en quelques secondes.

  2. La relecture : toutes les 5 minutes, Odoo demande à pismile s'il y a du nouveau. Si votre serveur était éteint ou injoignable, rien n'est perdu : Odoo rattrape tout au redémarrage.

Si un webhook échoue, pismile réessaie automatiquement pendant environ deux jours (après 1 min, 5 min, 30 min, 2 h, 6 h, 12 h et 24 h). Vous voyez chaque essai dans la console, installation → Événements → Derniers envois, et pouvez Renvoyer à la main.

Le rapprochement bancaire#

Chaque paiement enregistré par Odoo porte la référence PI-SPI du virement (son identifiant de bout en bout). C'est la même référence que celle de votre relevé bancaire : le rapprochement se fait sans chercher.

Plusieurs sociétés, plusieurs logiciels#

  • Plusieurs sociétés dans un même Odoo : chaque société a ses propres réglages pismile. Créez une installation (donc une clé) par société.

  • Plusieurs bases Odoo (par exemple test et production) : une installation par base. Une clé de test pour la base de test, une clé pmc_live_ pour la production.

  • Le nombre d'installations possibles dépend de votre offre.

La sécurité, en bref#

  • L'argent ne passe jamais par pismile : il va directement du compte du client au vôtre.

  • Les clés sont affichées une seule fois et pismile n'en garde qu'une empreinte : même nous ne pouvons pas les relire. Une clé perdue ou exposée se renouvelle ou se révoque en un clic dans la console.

  • Les webhooks sont signés : Odoo vérifie la signature et refuse tout message qui ne vient pas de pismile ou qui est trop ancien.

  • Vos identifiants PI-SPI sont chiffrés et ne sont jamais affichés.

  • Les alias de vos clients sont masqués dans la console et les journaux.

Votre facturation pismile#

Élément

Quand

Où le voir

Abonnement de l'offre

au début de chaque période (mois ou année)

Plan et usage → Connecteurs

Frais par encaissement payé (si votre offre en prévoit)

ajoutés à la facture de renouvellement

Plan et usage → Connecteurs

Facture de renouvellement

émise 7 jours avant l'échéance

Plan et usage → À payer

Historique des factures

à tout moment

Plan et usage → Factures

Pour arrêter, Ne pas renouveler : vous gardez le service jusqu'à la fin de la période payée. Le détail est dans Intégrer Odoo pas à pas, partie 5.

Cette page vous a-t-elle aidé ?