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

# Reversement et frais

> Configurez et suivez les reversements, et comprenez les frais appliqués aux paiements et aux retraits.

iMoney Encaissement permet aux marchands de demander le reversement des paiements collectés depuis la page **Demandes de reversement**. Le fonctionnement actuel repose sur une configuration préalable du mode de reversement, puis sur la sélection des transactions éligibles à reverser.

> **Note :** le parcours décrit sur cette page est disponible dans le dashboard marchand. Aucune API publique de création de reversement n'est actuellement déclarée dans le contrat `/api/v1` documenté.

Seuls les paiements réussis datant de plus de 3 jours sont proposés pour une demande de reversement. Les paiements plus récents restent visibles dans vos transactions, mais ils ne peuvent pas encore être sélectionnés pour un reversement.

## Configurer un mode de reversement

Avant de soumettre une demande, vous devez configurer votre mode de reversement depuis le bouton **Configurer un mode de reversement**.

Les modes disponibles sont :

| Mode                           | Informations requises                            | Frais de retrait                   |
| ------------------------------ | ------------------------------------------------ | ---------------------------------- |
| **My NITA**                    | Numéro de téléphone.                             | 1% du montant demandé.             |
| **Amana**                      | Numéro de téléphone.                             | 1% du montant demandé.             |
| **Virement bancaire**          | Nom de la banque, IBAN, nom du titulaire et RIB. | 0% dans la configuration actuelle. |
| **Rechargement compte PayOUT** | Nom du compte PayOUT.                            | 0% dans la configuration actuelle. |

Pour un virement bancaire, le RIB est obligatoire.

## Créer une demande de reversement

Le bouton **Nouvelle demande** ouvre la liste des transactions éligibles. Vous pouvez rechercher et filtrer les transactions par référence ou par période, puis sélectionner les paiements à inclure dans la demande.

La liste affiche uniquement les paiements qui peuvent être reversés. Un paiement doit donc avoir été validé depuis plus de 3 jours avant d'apparaître dans cette liste.

Une transaction est éligible au reversement lorsqu'elle respecte les conditions suivantes :

* elle est réussie ;
* elle n'a pas encore été reversée ;
* elle n'est pas déjà rattachée à une demande de reversement ;
* elle a été validée ou créée depuis plus de 3 jours.

Vous pouvez sélectionner les transactions de la page courante ou toutes les transactions correspondant aux filtres appliqués.

## Frais d'encaissement

iMoney Encaissement applique des frais selon le moyen de paiement utilisé, la configuration du compte marchand et la manière dont les frais sont supportés. Chaque paiement enregistré contient plusieurs montants :

* **Montant** : montant payé par le client ou montant demandé au client.
* **Frais de Transaction** : frais appliqués sur l'opération.
* **Montant net** : montant réellement disponible pour le marchand après application des frais lorsque ceux-ci sont supportés par le marchand.

Les taux exacts dépendent du moyen de paiement activé sur votre compte. Ils peuvent varier selon l'opérateur, le pays et les conditions commerciales associées à votre compte marchand.

### Frais par moyen de paiement

Le champ `payment_method` d'une transaction indique le moyen de paiement utilisé par le client. Chaque moyen dispose de sa propre configuration de frais. Les moyens disponibles dépendent de ceux activés sur votre compte :

| Catégorie      | Moyens de paiement                                            | Type de frais                                  |
| -------------- | ------------------------------------------------------------- | ---------------------------------------------- |
| Mobile money   | MTN Bénin, MOOV Bénin, MOOV Niger, AIRTEL Niger, Zamani Niger | Frais mobile money configurés sur le compte.   |
| Carte bancaire | Carte bancaire                                                | Frais carte bancaire configurés sur le compte. |
| STA            | Amana, Nita Online                                            | Frais spécifiques Amana et Nita.               |
| Autres moyens  | BOA Niger                                                     | Frais spécifiques BOA Niger.                   |

Seul le mobile money est disponible en appel direct à `POST /payments` (`Ipay-Payment-Type: mobile`). Tous les autres moyens passent par les [liens de paiement](/api-reference/liens-de-paiement).

### Frais supportés par le client ou par le marchand

Pour chaque moyen de paiement, iMoney Encaissement peut être configuré de deux manières :

* **Frais supportés par le client** : le client paie le montant demandé et les frais sont ajoutés ou pris en compte dans le montant total traité.
* **Frais supportés par le marchand** : les frais sont déduits du montant collecté avant que le solde soit disponible pour reversement.

Cette configuration est propre à chaque compte marchand et à chaque moyen de paiement. Elle est visible dans les montants affichés dans les pages **Transactions** et **Détails du paiement**.

## Frais de reversement

Les frais de retrait par mode figurent dans le tableau des modes ci-dessus. Lors de la sélection des transactions, l'interface affiche :

* le nombre de transactions sélectionnées ;
* le montant brut ;
* les frais de retrait lorsque le mode configuré en applique ;
* le montant net reversé si les frais sont inclus dans la demande.

Si l'option **Inclure les frais dans le montant reversé** est cochée, les frais sont déduits du montant de la demande. Si elle n'est pas cochée, les frais sont prélevés sur le solde disponible du compte. Dans ce cas, le solde doit être suffisant pour couvrir les frais.

## Suivre les demandes

La page **Demandes de reversement** liste les demandes créées avec les colonnes suivantes :

* **Référence** : référence de la demande.
* **Montant total** : montant brut demandé.
* **Nb transactions** : nombre de paiements inclus.
* **Statut** : état actuel de la demande.
* **Date** : date de création.
* **Voir** : ouvre le détail de la demande.

Les statuts possibles sont :

* **En attente** : la demande est créée et attend le traitement.
* **Validé** : la demande a été approuvée et réglée.
* **Rejeté** : la demande a été refusée. Une raison de rejet peut être affichée dans le détail.

## Détails d'une demande

La page de détail affiche la référence, le montant total, le statut, les frais de retrait, le montant net reversé, le mode de reversement configuré et la liste des transactions sélectionnées. Pour un virement bancaire, les informations bancaires et le RIB peuvent être consultés lorsque disponibles.

> **Attention :** une fois une demande soumise, les transactions sélectionnées sont réservées pour cette demande et ne peuvent plus être utilisées dans une autre demande de reversement.

> **Note :** les frais affichés dans votre interface peuvent dépendre de votre contrat marchand et des moyens de paiement activés. En cas de doute, contactez le support iMoney Encaissement pour confirmer les frais appliqués à votre compte.
