# Soldes, frais et virements

Ce qu’un paiement vous rapporte après nos frais, comment il attend en solde en attente, et comment chaque virement à votre banque est enregistré et annoncé.

Un paiement réussi ajoute son **net** à votre solde : son montant, moins nos frais. En production,
notre partenaire de paiement agréé détient cet argent jusqu’à ce qu’il le verse sur votre compte
bancaire. Le tableau de bord suit chaque paiement de sa réussite à son virement, sous **Soldes** et
**Virements**.

## Nos frais

* **Un frais par paiement, selon le moyen de paiement** : un pourcentage du montant plus un montant
  fixe, la carte et les espèces ayant chacune les leurs. Il est arrondi au centime le plus proche, et
  ne dépasse jamais le paiement lui-même.
* **Fixé quand le paiement commence** : quand votre client ouvre la page carte ou reçoit le code
  espèces. Un changement de vos tarifs s’applique aux paiements commencés après lui ; un paiement
  déjà commencé garde son tarif, payé ou pas encore.
* **Les mêmes tarifs en mode test et en production**, pour que votre solde de test bouge comme un
  solde réel.
* **Affiché sur chaque paiement.** La page d’un paiement, dans le tableau de bord, montre ses frais
  et son net, et le paiement garde le tarif qui a servi à les calculer, sous le nom `feeRate` : le
  pourcentage et le montant fixe.
* **Conservé lors d’un remboursement.** Un remboursement rend le montant à votre client et le prend
  sur votre solde ; nos frais ne sont pas rendus. Voir [Remboursements](https://pay-docs.adpromax.com/fr/payments/refunds).

## Le parcours de votre argent

|                      | Mode test                                                                           | Production                                                                                                      |
| -------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Un paiement réussit  | Son net est **en attente**                                                          | Son net est **en attente**                                                                                      |
| Ensuite              | Il devient **disponible** 120 secondes plus tard, et reste dans votre solde de test | Il reste en attente, sans délai fixe, jusqu’à ce que notre partenaire de paiement agréé le verse à votre banque |
| Versé à votre banque | Jamais : aucun argent ne bouge                                                      | Dans un **virement**, que notre équipe enregistre d’après le rapport de règlement du partenaire                 |

Quand notre équipe enregistre un virement, chaque paiement qu’il couvre est **réglé** :

* sur la page **Soldes**, la ligne du paiement indique *Réglé le* et le jour où le partenaire l’a
  versé (`settledOn`, un jour au Maroc), avec son virement ; la page du paiement dit la même chose ;
* une ligne **Virement** pour ce même paiement (type `payout`, négative) sort de votre solde ce qui a
  été versé à votre banque. Un paiement réglé n’est ni dans votre solde en attente, ni dans votre
  solde disponible.

Un remboursement fait **avant** le règlement d’un paiement réduit ce qui est versé pour lui : un
paiement de 500,00 MAD remboursé de 100,00 MAD est réglé pour 400,00 MAD, moins nos frais. Un
remboursement fait **après** le règlement prend son montant sur votre solde disponible, qui peut
alors passer sous zéro.

La page **Soldes** liste chaque ligne qui a fait bouger votre solde, de la plus récente à la plus
ancienne : paiements, remboursements et virements. Filtrez-la par **Type** pour ne voir que les
virements ; son export, un fichier CSV, contient les mêmes lignes.

## Virements

Un **virement** (`po_…`) est ce que notre partenaire de paiement agréé a versé sur votre compte
bancaire pour un moyen de paiement et un jour, tel que notre équipe l’a enregistré. Les virements
n’existent qu’en production : le mode test ne verse rien.

**Virements**, dans le groupe Argent du tableau de bord, les liste, du jour le plus récent au plus
ancien, avec des filtres par moyen et par jour. La page d’un virement montre le jour du versement, son
moyen, le nombre de paiements qu’il couvre et quand notre équipe l’a enregistré, puis chaque paiement
avec son montant, nos frais, ce qui a été remboursé avant son règlement et le montant réglé.

* **Un virement est `paid`** : il enregistre de l’argent déjà versé à votre banque, jamais de
  l’argent promis.
* **Un virement ne change plus** une fois listé. Un paiement enregistré plus tard pour le même jour
  fait l’objet d’un virement distinct : un même jour peut donc montrer deux virements.
* **Qui les voit** : le Propriétaire, les Administrateurs, Finance et les Analystes, comme pour les
  soldes. Voir [Équipe et rôles](https://pay-docs.adpromax.com/fr/account/team-and-roles).

## Événements

En production, chaque virement envoie deux événements, une seule fois, quand notre équipe
l’enregistre :

| Événement           | Son objet                                                                                                                                                                                                |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payout.paid`       | Le virement : `id`, `amount`, `currency`, `status` (`paid`), `method` (`card` ou `cash`), `arrival_date` (le jour du versement, `YYYY-MM-DD`, heure du Maroc), `payment_count`, `livemode` et `created`. |
| `balance.available` | Votre solde une fois le virement enregistré : `pending` et `available`, `currency` et `livemode`. Chacun des deux montants peut être sous zéro.                                                          |

Les montants sont en centimes, comme partout dans l’API. Les paiements d’un virement ne sont pas dans
son événement : lisez-les sur sa page du tableau de bord. Abonnez un endpoint de webhook de
production à ces événements comme à tout autre : voir [Webhooks](https://pay-docs.adpromax.com/fr/webhooks).
