Paiements
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é.
Sur cette page
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.
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.
É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.