Passer au contenu principal

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.

Le payout vous permet d’envoyer des fonds depuis votre compte marchand LigdiCash vers un destinataire. Deux méthodes existent selon que le destinataire possède un compte LigdiCash ou non.

​
Payout Client vs Payout Marchand

Payout Client — vous envoyez vers le numéro de compte LigdiCash du destinataire. Les fonds arrivent instantanément dans son wallet LigdiCash. Vous choisissez ensuite, via le paramètre top_up_wallet, si les fonds restent dans son wallet LigdiCash ou si LigdiCash déclenche automatiquement un virement vers son compte mobile money. Payout Marchand — vous envoyez directement vers un numéro mobile money, sans wallet LigdiCash intermédiaire. Cette méthode n’est pas instantanée : le traitement peut prendre de quelques secondes à plusieurs jours selon l’opérateur.

Payout Client

Vers un wallet LigdiCash. Instantané. Avec option de virement automatique vers mobile money.

Payout Marchand

Directement vers un numéro mobile money. Non instantané.

​
Tableau de décision

Je veux…Méthodetop_up_wallet
Envoyer vers le wallet LigdiCash du destinataire, il gère son retrait lui-mêmePayout Client1
Envoyer vers le wallet LigdiCash du destinataire, LigdiCash vire ensuite vers son mobile moneyPayout Client0
Envoyer directement vers un numéro mobile money (pas de compte LigdiCash requis)Payout Marchand—
Avec le Payout Client (top_up_wallet: 0), les fonds arrivent toujours d’abord dans le wallet LigdiCash du destinataire — instantanément. C’est le virement automatique subsequent vers son mobile money qui peut prendre du temps.

​
Comptes marchands et soldes par opérateur

Votre compte marchand LigdiCash est composé de sous-comptes distincts par opérateur activé dans votre contrat. Les paiements reçus via Orange Burkina alimentent votre sous-compte Orange Burkina. Ceux reçus via Moov Burkina alimentent votre sous-compte Moov Burkina, et ainsi de suite. Lors d’un payout, les fonds quittent le sous-compte correspondant à l’opérateur du numéro destinataire.
Si le sous-compte de l’opérateur concerné n’est pas suffisamment approvisionné, le payout échoue — même si vos autres sous-comptes ont un solde disponible. Assurez-vous que le bon sous-compte est crédité avant d’initier un payout.

​
Cas d’usage typiques

  • Remboursements — rembourser un client après annulation de commande
  • Gains et cashback — reverser des gains, récompenses ou commissions
  • Paiement de prestataires — régler des freelances ou partenaires
  • Salaires — verser des rémunérations vers des comptes mobile money

​
Commissions

Chaque payout est soumis aux frais définis dans votre contrat LigdiCash. Ces frais sont systématiquement prélevés par LigdiCash — il n’existe pas de payout à zéro frais. Le montant effectivement reçu par le bénéficiaire peut donc être inférieur au montant envoyé selon la structure tarifaire de votre contrat.
Anticipez les frais dans votre logique métier. Un remboursement de 5 000 XOF ne reversera pas nécessairement 5 000 XOF au bénéficiaire. Consultez votre contrat LigdiCash pour connaître le barème applicable.

​
Prérequis

  • Le sous-compte opérateur concerné doit disposer d’un solde suffisant.
  • Le payout doit être activé sur votre projet API.
  • Vos adresses IP serveur doivent être whitelistées par LigdiCash. Les requêtes payout provenant d’adresses IP non whitelistées sont rejetées. Communiquez vos adresses IP à l’équipe LigdiCash avant de commencer l’intégration.
Pour l’activation du payout et le whitelisting de vos IPs, contactez developper@ligdicash.com.

​
Dans cette section

Payout Client

POST /pay/v01/withdrawal/create — vers wallet LigdiCash avec option top_up_wallet

Payout Marchand

POST /pay/v01/straight/payout — envoi direct vers mobile money

Vérifier le statut

GET /pay/v01/withdrawal/confirm — suivre le résultat d’un payout

Cas d'usage

Remboursements, salaires, gains — exemples concrets