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

# Cas d'usage du payout

> Remboursements, salaires, gains, paiement de prestataires — choisir la bonne méthode payout selon le contexte.

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.

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

<Warning>
  Les frais contractuels LigdiCash s'appliquent à tout payout, y compris les remboursements. Le client ne recevra pas nécessairement le montant exact qu'il a payé. Anticipez cette différence dans votre politique de remboursement.
</Warning>

<Steps>
  <Step title="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`.
  </Step>

  <Step title="Initier le payout">
    Appelez `POST /pay/v01/straight/payout` avec le montant à rembourser et un `transaction_id` lié à la commande d'origine.
  </Step>

  <Step title="Confirmer via callback">
    Attendez le callback sur votre `callback_url`. Une fois `status: "completed"` reçu, mettez à jour le statut de la commande et notifiez le client.
  </Step>
</Steps>

```json Exemple custom_data theme={null}
{
  "transaction_id": "REFUND-ORD-2024-001"
}
```

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

<Warning>
  Le Payout Marchand n'est pas instantané. Pour des paiements groupés (bulk), envoyez les requêtes en séquence et suivez chaque `token` retourné. Ne considérez un paiement comme finalisé qu'à réception du callback `status: "completed"`.
</Warning>

## 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`)

<Tabs>
  <Tab title="Gains utilisables sur la plateforme">
    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.
  </Tab>

  <Tab title="Gains versés directement sur mobile money">
    Utilisez `top_up_wallet: 0` — les fonds arrivent d'abord dans le wallet LigdiCash de l'utilisateur, puis LigdiCash déclenche automatiquement le virement vers son mobile money. L'utilisateur reçoit les fonds sans action de sa part.

    **Idéal pour :** gains de tournois, primes, récompenses que l'utilisateur doit recevoir en cash.
  </Tab>
</Tabs>

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

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

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

## Pages associées

* [Payout Client](/api-paiement/payout/vers-wallet-ligdicash)
* [Payout Marchand](/api-paiement/payout/vers-mobile-money)
* [Vérifier le statut d'un payout](/api-paiement/payout/verifier-statut)
* [Le compte marchand LigdiCash](/concepts/compte-marchand)