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

# Rembourser un paiement

> Rendez tout ou partie d'un paiement à votre client, depuis le tableau de bord ou par l'API, et suivez son arrivée.

Un remboursement rend **tout ou partie** du paiement au client : sur son numéro mobile money, ou sur la carte qui a servi à payer. Plusieurs remboursements partiels peuvent se suivre jusqu'à rendre tout le paiement, un à la fois.

## Les règles

* Un paiement se rembourse jusqu'à **90 jours** après lui.
* Un paiement par carte se rembourse une fois ses fonds disponibles sur votre solde. Avant, la transaction indique la date à partir de laquelle ce sera possible.
* Votre solde est débité du montant rendu et de **frais de remboursement de 1 % de ce montant, au moins 100 FCFA par remboursement**. La commission du paiement n'est pas rendue.
* Un remboursement doit être arrivé ou avoir échoué avant d'en demander un autre sur le même paiement.
* Le solde disponible, retraits déjà réservés déduits, doit couvrir ce total. Sinon le remboursement est refusé.
* Un paiement en FCFA débité en euros sur une carte est remboursé en euros : la même part des euros pour un remboursement partiel, et exactement ce qui reste pour le dernier.

## Depuis le tableau de bord

Ouvrez la transaction et choisissez **Rembourser**. Le montant proposé est ce qui reste à rendre : réduisez-le pour un remboursement partiel. Le montant rendu, les frais et le total débité s'affichent avant de confirmer. Pour de l'argent réel, une confirmation de votre identité est demandée, comme pour un retrait.

Seuls le propriétaire et les administrateurs de la boutique peuvent rembourser.

## Par l'API

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://mercy-pay.com/api/v1/payments/pay_0b76919140c74c4c99d52f5c1734b743/refunds \
  -H "Authorization: Bearer $MERCY_PAY_KEY" \
  -H "Idempotency-Key: refund-commande-1042" \
  -H "Content-Type: application/json" \
  -d '{"amount": 2500, "reason": "Une partie de la commande annulée"}'
```

Sans `amount`, tout ce qui reste à rendre est remboursé. Le champ `amount_refunded` du paiement donne ce qui a déjà été rendu.

L'en-tête `Idempotency-Key` est obligatoire : la même clé renvoie le même remboursement, jamais un second. Voir [Rembourser un paiement](https://docs.mercy-pay.com/api/refunds/create.md) dans la référence.

## Suivre un remboursement

| Statut | Signification |
| - | - |
| `pending` | Envoyé, réponse attendue |
| `processing` | En route vers le client |
| `succeeded` | Arrivé chez le client. Le paiement passe à `refunded` une fois tout son montant rendu ; avant, il reste `succeeded` avec `amount_refunded` à jour. |
| `failed` | Non envoyé : le montant et les frais sont revenus sur votre solde |
| `canceled` | Annulé pendant qu'il attendait un opérateur indisponible |

Quand l'opérateur du client est indisponible, le remboursement attend son retour (`status_detail` vaut `delayed`). Vous pouvez alors l'annuler depuis la transaction ou par [`POST /api/v1/refunds/{id}/cancel`](https://docs.mercy-pay.com/api/refunds/cancel).

Les événements `refund.succeeded`, `refund.failed`, `refund.canceled` et `payment.refunded` vous préviennent à chaque étape. Votre client reçoit un e-mail quand son argent revient, si son adresse est connue.


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