Le choix entre Payout Client et Payout Marchand dépend du destinataire et de la destination finale des fonds. Cette page présente les cas d’usage les plus courants et la méthode recommandée pour chacun.Documentation Index
Fetch the complete documentation index at: https://developers.ligdicash.com/llms.txt
Use this file to discover all available pages before exploring further.
Remboursement de commande
Un client demande un remboursement après une annulation ou un retour produit. Vous devez lui reverser le montant payé. Méthode recommandée : Payout Marchand (/pay/v01/straight/payout)
Le client n’a pas nécessairement un compte LigdiCash. Le Payout Marchand envoie directement vers son numéro mobile money, sans prérequis de son côté.
Récupérer le numéro mobile money du client
Utilisez le numéro que le client a fourni lors de son paiement — il est disponible dans le callback du payin d’origine via
operator_id et customer.Initier le payout
Appelez
POST /pay/v01/straight/payout avec le montant à rembourser et un transaction_id lié à la commande d’origine.Exemple custom_data
Paiement de salaires
Vous devez verser des rémunérations à des employés ou des agents terrain sur leurs comptes mobile money. Méthode recommandée : Payout Marchand (/pay/v01/straight/payout)
Les destinataires n’ont pas nécessairement de compte LigdiCash. Le Payout Marchand permet d’envoyer directement vers n’importe quel numéro mobile money.
Distribution de gains et cashback
Vous souhaitez créditer des gains, des récompenses ou du cashback à vos utilisateurs — qu’ils puissent utiliser sur votre plateforme ou retirer sur leur mobile money. Méthode recommandée : Payout Client (/pay/v01/withdrawal/create)
- Gains utilisables sur la plateforme
- Gains versés directement sur mobile money
Utilisez
top_up_wallet: 1 — les fonds arrivent dans le wallet LigdiCash de l’utilisateur. Il peut s’en servir pour payer sur les plateformes LigdiCash. Le retrait vers mobile money reste à son initiative.Idéal pour : cashback, crédits fidélité, gains de jeu conservés dans l’écosystème LigdiCash.Paiement d’agents et de prestataires
Vous devez régler des freelances, des agents terrain ou des fournisseurs qui ont réalisé une prestation. Méthode recommandée : Payout Marchand (/pay/v01/straight/payout)
Les prestataires n’ont généralement pas de compte LigdiCash. Le Payout Marchand envoie directement vers leur numéro mobile money, quel que soit l’opérateur — à condition que le sous-compte correspondant soit approvisionné.
Si vous payez régulièrement vers plusieurs opérateurs différents, surveillez vos soldes par sous-compte depuis le Dashboard LigdiCash. Un payout échoue si le sous-compte de l’opérateur destinataire est insuffisant, même si vos autres sous-comptes sont créditeurs.
Tableau récapitulatif
| Cas d’usage | Méthode | top_up_wallet |
|---|---|---|
| Remboursement client | Payout Marchand | — |
| Salaires et rémunérations | Payout Marchand | — |
| Cashback / crédits plateforme | Payout Client | 1 |
| Gains versés sur mobile money | Payout Client | 0 |
| Paiement de prestataires | Payout Marchand | — |