> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercy-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payouts

> Un payout verse des fonds de votre solde vers un compte mobile money. Il est servi par le solde du pays et de l'opérateur choisis.

Un **payout** transfère des fonds de votre solde vers un compte mobile money. C'est la seule façon de faire sortir de l'argent de Mercy Pay vers vous ou vos bénéficiaires.

## Ce qui débite le solde

Un payout puise dans le **solde du même pays, du même opérateur et de la même devise** que le bénéficiaire, pour la même raison qu'un encaissement y crédite : l'argent ne traverse jamais les frontières de ce triplet. Pour verser 4 000 XAF vers un numéro MTN du Cameroun, il vous faut un solde `CMR · MTN_MOMO_CMR` en XAF qui couvre ce montant : pas un solde Orange, pas un solde dans une autre devise, même équivalente.

## Conditions

Trois conditions, toutes nécessaires : votre KYC doit être approuvé, la demande doit utiliser une clé **live** (les payouts n'existent pas en sandbox : il n'y a rien à simuler, un virement est réel ou n'a pas lieu), et le solde concerné doit couvrir le montant demandé.

## Commission

Mercy Pay retient **2 %** du montant demandé, le temps du virement. Un payout de 4 000 XAF débite bien 4 000 XAF de votre solde, mais seuls 3 920 XAF partent effectivement vers le bénéficiaire.

| Champ | Exemple | Signification |
| - | - | - |
| `amount` | `4000` | Montant demandé, débité de votre solde |
| `fee_amount` | `80` | Commission Mercy Pay (2 % de `amount`) |
| `net_amount` | `3920` | Montant réellement envoyé au bénéficiaire |

`fee_amount` et `net_amount` sont figés au moment de la création du payout. Un changement de taux de commission plus tard dans votre historique ne les recalcule jamais rétroactivement.

## Statuts

| Statut | Signification |
| - | - |
| `requested` | Demande enregistrée, en attente d'approbation |
| `approved` | Approuvé par Mercy Pay, envoyé à l'opérateur |
| `processing` | Virement en cours chez l'opérateur |
| `paid` | Versé sur le compte du bénéficiaire |
| `failed` | Échec côté opérateur, le motif est dans `failure_reason` |
| `rejected` | Refusé par Mercy Pay, le motif est dans `failure_reason` |

Le solde n'est débité qu'au passage à `paid`. Un payout `failed` ou `rejected` ne touche jamais votre solde, même s'il a été approuvé entre-temps. Le montant doit simplement être disponible au moment de la demande.

## Destination

```json theme={null}
{
  "type": "mobile_money",
  "country": "CMR",
  "provider": "MTN_MOMO_CMR",
  "phone": "237680000000"
}
```

Le numéro s'écrit avec l'indicatif du pays, sans le `+` (`237` pour le Cameroun).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.