​
Paiement mobile money

Locayo s’integre avec PawaPay pour permettre aux locataires de payer leur loyer directement via Wave, Orange Money ou MTN MoMo. Le paiement est enregistre automatiquement, un reçu PDF est genere, et le bailleur est notifie en temps reel.

​
Comment ça fonctionne

1

Le locataire initie le paiement

Depuis le portail locataire, le locataire clique sur Payer mon loyer et saisit :
  • Le montant a payer (en FCFA)
  • Le moyen de paiement (Wave, Orange Money, MTN MoMo)
  • Son numero de telephone mobile money
2

Envoi de la demande a PawaPay

Locayo envoie une demande de depot a l’API PawaPay. PawaPay envoie un USSD push directement sur le telephone du locataire. Le locataire n’est pas redirige — il reste sur Locayo.
PawaPay est un agregateur de paiement mobile money specialise en Afrique subsaharienne. Il gere la communication avec les operateurs (Wave, Orange, MTN, Moov) via des requetes USSD directes.
3

Validation par l'operateur

Selon l’operateur choisi :
  • Wave : une notification de confirmation s’affiche dans l’application Wave
  • Orange Money : un code USSD ou une notification push demande la validation
  • MTN MoMo : une validation par PIN est requise sur le telephone
Le locataire valide le paiement depuis son telephone.
4

Confirmation et notification

Une fois le paiement valide par l’operateur :
  1. PawaPay envoie un callback a Locayo
  2. Locayo enregistre le paiement avec la reference unique
  3. Un reçu PDF est genere automatiquement
  4. Le bailleur recoit une notification (push + email)

​
Operateurs disponibles

Wave

Disponible en : Cote d’Ivoire, SenegalOperateur mobile money le plus utilise en Afrique de l’Ouest. Transactions rapides, frais reduits.

Orange Money

Disponible en : Cote d’Ivoire, CamerounAdosse au reseau Orange. Large couverture geographique, compatible avec les transferts internationaux.

MTN MoMo

Disponible en : Cote d’Ivoire, CamerounMobile money de MTN. Forte penetration au Cameroun et dans les zones urbaines.

​
Paiement partiel

Locayo autorise les paiements partiels. Un locataire peut payer une partie de son loyer a un moment et completer plus tard dans le mois.
Cette fonctionnalite est essentielle pour les locataires aux revenus irreguliers (commerçants, artisans, travailleurs informels). Ils peuvent payer 50 000 FCFA le 5 du mois et les 50 000 FCFA restants le 20, par exemple.
Exemple : Loyer mensuel de 100 000 FCFA
PaiementDateMontantRestant
Paiement 15 mars 202660 000 FCFA40 000 FCFA
Paiement 218 mars 202640 000 FCFA0 FCFA
Le systeme suit automatiquement le montant reçu vs le montant attendu et affiche le solde restant.
Le montant d’un paiement individuel ne peut pas depasser le loyer mensuel. Si le locataire tente de payer plus que le loyer, le systeme refusera la transaction.

​
Reference unique

Chaque paiement mobile money genere une reference unique au format UUID : 
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Cette reference est :
  • Generee par Locayo lors de l’initiation
  • Transmise a PawaPay pour le suivi
  • Enregistree dans l’historique des paiements
  • Imprimee sur le reçu PDF
Conservez la reference du paiement. Elle permet de retrouver la transaction en cas de contestation aupres de l’operateur mobile money.

​
Matching automatique

Lorsque Locayo recoit un callback de PawaPay, le systeme identifie automatiquement :
  1. Le portefeuille du bailleur correspondant au numero de telephone destinataire
  2. Le bail actif associe a ce bailleur
  3. Le mois d’echeance en cours
Pour que le matching fonctionne, le bailleur doit avoir configure au moins un portefeuille avec son numero mobile money.

​
Securite

Le processus de paiement est securise a plusieurs niveaux :
CoucheProtection
TransportHTTPS (TLS 1.3)
Authentification webhookSignature HTTP RFC-9421 (PawaPay)
IdempotenceChaque reference est unique, un paiement ne peut etre enregistre qu’une fois
AutorisationSeul le locataire lie au bail peut initier un paiement
OperateurValidation par PIN/notification cote operateur

​
Que faire en cas d’echec ?

Si le paiement echoue :
  1. Verifiez le solde de votre compte mobile money
  2. Verifiez le numero de telephone saisi
  3. Reessayez apres quelques minutes (les operateurs peuvent avoir des interruptions temporaires)
  4. Si le probleme persiste, contactez le support PawaPay ou l’operateur concerne
  5. En dernier recours, le bailleur peut enregistrer un paiement manuel