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

# Retraits

> Un retrait verse des fonds de votre solde vers un compte mobile money, ou vers un compte bancaire pour un solde carte. Il est servi par le solde choisi.

Un **retrait** transfère des fonds de votre solde vers un compte mobile money. Un solde carte peut aussi partir vers un compte bancaire (IBAN ou RIB), depuis le tableau de bord uniquement : l'API n'accepte que des destinations mobile money. C'est la seule façon de sortir de l'argent de Mercy Pay.

> [card] [Demander un retrait](https://docs.mercy-pay.com/payouts/request-a-payout.md)
>
> Depuis le tableau de bord, frais affichés avant de confirmer.

> [card] [Retraits par l'API](https://docs.mercy-pay.com/api/payouts/create.md)
>
> Une demande de retrait depuis votre serveur.

## Ce qui débite le solde

Un retrait 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 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. Pour retirer vers un autre opérateur du même pays, [virez d'abord entre vos soldes](https://docs.mercy-pay.com/payouts/balances.md#virer-entre-deux-operateurs).

## Conditions

En live, deux conditions : votre KYC doit être approuvé, et le solde concerné doit couvrir le montant demandé.

En sandbox, un retrait part tout de suite, sans KYC ni validation, depuis votre solde de test et vers un numéro Mobile Money de test. Voir [Environnements](https://docs.mercy-pay.com/start/environments.md).

## Validation

En live, notre équipe valide chaque retrait à la main : ceux du tableau de bord, ceux de l'API et les retraits automatiques. Un compte suspendu ne peut plus en demander, et un retrait en attente n'est pas validé tant que la suspension dure.

## Commission

Mercy Pay retient **2 %** du montant demandé, le temps du virement. Un retrait 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 retrait. 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` |
| `canceled` | Annulé avant son examen, ou pendant qu'il attendait un opérateur indisponible |

Le champ `status_detail` précise un retrait encore en route :

| `status_detail` | Signification |
| - | - |
| `delayed` | L'opérateur est indisponible : le retrait attend son retour. Vous pouvez l'annuler depuis le tableau de bord. |
| `pending_processing` | Le retrait n'est pas encore parti. Il partira automatiquement, sans action de votre part. |

Le solde n'est débité qu'au passage à `paid`. Un retrait `failed`, `rejected` ou `canceled` 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.

## Origine

Le champ `origin` dit d'où vient le retrait : `dashboard`, `api` ou `automatic`. Tous arrivent dans la même liste du tableau de bord, filtrable par origine.

## Destination

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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). Pour le Congo, la Côte d'Ivoire et le Bénin, gardez le `0` qui fait partie du numéro local.


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