> ## 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.

# Payout — Introduction

> Envoyez des fonds à vos clients ou prestataires : Payout Client vers un wallet LigdiCash, ou Payout Marchand directement vers un compte mobile money.

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.

<CardGroup cols={2}>
  <Card title="Payout Client" icon="wallet" href="/api-paiement/payout/vers-wallet-ligdicash">
    Vers un wallet LigdiCash. Instantané. Avec option de virement automatique vers mobile money.
  </Card>

  <Card title="Payout Marchand" icon="paper-plane" href="/api-paiement/payout/vers-mobile-money">
    Directement vers un numéro mobile money. Non instantané.
  </Card>
</CardGroup>

## Tableau de décision

| Je veux…                                                                                       | Méthode         | `top_up_wallet` |
| ---------------------------------------------------------------------------------------------- | --------------- | --------------- |
| Envoyer vers le wallet LigdiCash du destinataire, il gère son retrait lui-même                 | Payout Client   | `1`             |
| Envoyer vers le wallet LigdiCash du destinataire, LigdiCash vire ensuite vers son mobile money | Payout Client   | `0`             |
| Envoyer directement vers un numéro mobile money (pas de compte LigdiCash requis)               | Payout Marchand | —               |

<Note>
  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.
</Note>

## 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.

<Warning>
  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.
</Warning>

## 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.

<Warning>
  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.
</Warning>

## 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](mailto:developper@ligdicash.com).

## Dans cette section

<CardGroup cols={2}>
  <Card title="Payout Client" icon="wallet" href="/api-paiement/payout/vers-wallet-ligdicash">
    `POST /pay/v01/withdrawal/create` — vers wallet LigdiCash avec option `top_up_wallet`
  </Card>

  <Card title="Payout Marchand" icon="paper-plane" href="/api-paiement/payout/vers-mobile-money">
    `POST /pay/v01/straight/payout` — envoi direct vers mobile money
  </Card>

  <Card title="Vérifier le statut" icon="circle-check" href="/api-paiement/payout/verifier-statut">
    `GET /pay/v01/withdrawal/confirm` — suivre le résultat d'un payout
  </Card>

  <Card title="Cas d'usage" icon="lightbulb" href="/api-paiement/payout/cas-usage">
    Remboursements, salaires, gains — exemples concrets
  </Card>
</CardGroup>