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.

Lorsque vous signez un contrat LigdiCash, vous obtenez un compte marchand. C’est l’entité centrale qui regroupe tous vos flux financiers : paiements reçus de vos clients (payin) et versements que vous effectuez (payout). Comprendre sa structure est indispensable pour anticiper où votre argent se trouve et pourquoi certaines opérations peuvent échouer.

Un sous-compte par opérateur

Votre compte marchand n’est pas un compte unique avec un solde global. Il est composé de sous-comptes distincts — un par opérateur activé dans votre contrat.
Compte marchand MonApp
├── Sous-compte Orange Burkina    → solde : 125 000 XOF
├── Sous-compte Moov Burkina      → solde :  48 500 XOF
├── Sous-compte Wave Sénégal      → solde :  12 000 XOF
└── ...
Ces sous-comptes sont indépendants. Il n’existe pas de mutualisation automatique des soldes entre eux.
Un sous-compte est créé automatiquement lors de la première transaction reçue via cet opérateur — pas à l’activation du projet.

Flux entrants — le payin

Lorsqu’un client paie avec Orange Burkina, les fonds sont crédités dans votre sous-compte Orange Burkina. S’il paie avec Moov Burkina, les fonds vont dans votre sous-compte Moov Burkina. Chaque payin alimente exclusivement le sous-compte correspondant à l’opérateur utilisé. Vous pouvez également alimenter un sous-compte manuellement via un Cashin : vous envoyez une demande à LigdiCash en précisant le code du sous-compte à créditer et le montant, puis vous effectuez un virement bancaire vers le compte LigdiCash. Une fois le virement vérifié, LigdiCash crédite votre sous-compte.
Le code de chaque sous-compte est disponible à tout moment depuis le Dashboard LigdiCash. Il est requis pour toute demande de Cashin ou Cashout.

Flux sortants — le payout

Lors d’un payout, les fonds quittent le sous-compte correspondant à l’opérateur du numéro destinataire. Si vous envoyez de l’argent vers un numéro Orange Burkina, les fonds sont prélevés sur votre sous-compte Orange Burkina.
Les soldes ne sont pas mutualisés entre opérateurs. Un payout vers Orange Burkina ne peut pas être financé par votre sous-compte Moov Burkina. Si le sous-compte de l’opérateur destinataire est insuffisant, le payout échoue — même si vos autres sous-comptes sont bien approvisionnés.
Vous pouvez retirer des fonds d’un sous-compte via un Cashout : vous envoyez une demande à LigdiCash en précisant le code du sous-compte à débiter, le montant et vos coordonnées bancaires. LigdiCash déduit le montant et effectue un virement vers votre compte bancaire. En combinant un Cashout sur un sous-compte et un Cashin sur un autre, vous pouvez rééquilibrer vos soldes entre opérateurs — utile avant un payout massif vers un opérateur spécifique.
Les demandes de Cashin et Cashout se font par email auprès de l’équipe LigdiCash. Il n’existe pas d’endpoint API pour ces opérations.

Retirer vos fonds depuis le dashboard

En dehors du Cashout (virement bancaire via l’équipe LigdiCash), vous pouvez initier un retrait directement depuis le dashboard sans passer par l’équipe support. Depuis le dashboard : Marchands → Comptes → Actions → Nouveau retrait marchand. Deux modes de retrait sont disponibles : Transfert mobile — vous envoyez les fonds vers un numéro mobile money. Le numéro doit être saisi au format indicatif + numéro, sans espace (22670XXXXXXX). Le numéro destinataire doit appartenir à la même zone monétaire que l’opérateur du sous-compte : vous ne pouvez pas envoyer des fonds d’un sous-compte Orange Burkina vers un numéro guinéen, qui n’est pas dans la zone UEMOA. En revanche, un numéro Moov Burkina ou Orange Mali sera accepté depuis un sous-compte Orange Burkina. Transfert bancaire — vous envoyez les fonds vers un compte bancaire. Dans le champ « Détails bancaires », renseignez les informations nécessaires pour le virement : nom du titulaire, nom de la banque, numéro de compte ou RIB. Dans les deux cas, un récapitulatif affiche le montant reçu, les frais éventuels et le montant débité avant confirmation.
Le dashboard affiche la liste de tous vos sous-comptes marchands (projets API et projets PayLink confondus). Vous pouvez filtrer par opérateur ou par projet pour retrouver le compte à débiter.

Consulter vos soldes

La consultation des soldes se fait exclusivement depuis le Dashboard LigdiCash. Il n’existe pas d’endpoint API pour lire le solde d’un sous-compte. Prévoyez un suivi manuel ou des alertes basées sur vos propres logs de transactions si vous avez besoin de surveiller vos soldes en temps réel.

Ce que ça change pour votre intégration

Côté payin — vous n’avez rien à gérer : les fonds arrivent automatiquement dans le bon sous-compte selon l’opérateur du client. Côté payout — vérifiez toujours que le sous-compte de l’opérateur destinataire est suffisamment approvisionné avant d’initier un payout. Si vous faites régulièrement des payouts vers plusieurs opérateurs, surveillez vos soldes par opérateur, pas globalement.

Pages associées