Versements et réconciliation

Lorsqu'un client paie via FlowAlp Pay, l'argent n'arrive pas immédiatement sur votre compte bancaire : il est d'abord collecté dans votre solde FlowAlp Pay, puis transféré sous forme de versement (payout). Ce guide explique comment fonctionne ce règlement, ce que contient un versement et comment réconcilier les versements avec vos commandes et votre relevé bancaire — manuellement dans le dashboard ou automatiquement via l'API.

Comment vos fonds sont réglés#

Chaque paiement confirmé augmente votre solde du montant de la transaction moins les frais de transaction. Au moment du versement, FlowAlp Pay regroupe l'activité accumulée dans un seul versement consolidé et le transfère sur le compte bancaire (IBAN) configuré pour votre compte. Un versement couvre donc généralement de nombreuses transactions plus les frais associés, et porte un texte statement qui apparaît sur votre relevé bancaire, une date de versement (date), une currency et les coordonnées du compte de destination (destination) — tout ce qu'il faut pour rapprocher le crédit bancaire.

Le cycle de vie d'un versement#

Ce que contient un versement#

À l'intérieur d'un versement se trouve une liste de transferts. La plupart des entrées sont de type transaction : elles portent le montant brut du paiement et les frais de transaction déduits comme items séparés, plus l'uuid et le reference_id de la transaction (votre numéro de commande). D'autres types de transferts couvrent les frais de versement, les ajustements, les litiges et les réserves. Tous les montants sont en unités mineures, et les items d'un transfert s'additionnent toujours à son montant net — un paiement de CHF 300.00 avec CHF 3.00 de frais apparaît comme 30000 et -300, contribuant 29700 au versement.

Réconcilier les versements avec votre comptabilité#

1. Listez les versements de la période avec l'API Payouts et repérez le versement qui correspond au crédit bancaire (même date, même montant et même texte statement).
2. Chargez ses transferts page par page via l'endpoint de détails — une taille de page de 100 entrées est recommandée.
3. Rattachez chaque transfert transaction à une commande de votre système grâce au reference_id ou à l'uuid de la transaction.
4. Comptabilisez séparément les items de frais (transaction-fee, payout-fee) afin de distinguer chiffre d'affaires brut et charges.
5. Vérifiez que la somme de tous les transferts est égale à l'amount du versement et au montant crédité par votre banque.

Le lien fonctionne aussi dans l'autre sens : chaque transaction réglée expose un payoutUuid, ce qui permet de partir d'une commande et de retrouver le versement qui l'a contenue — voir Lister et récupérer les Transactions. Pour les contrôles manuels, votre dashboard FlowAlp Pay sur https://pay.flowalp.com affiche les mêmes données de versement.

curl "https://api.pay.flowalp.com/v1.16/Payout/C6B438B9/details?instance=<tenant>&limit=100&offset=0" \
  -H "x-api-key: <api-secret>"

Automatiser le suivi des versements#

Plutôt que d'interroger l'API en boucle, laissez FlowAlp Pay vous prévenir : des notifications webhook sont envoyées lorsqu'un versement atteint les statuts processing, sent ou failed (aucune notification pour initiated, pending ou under-review). C'est le déclencheur le plus simple pour lancer une réconciliation automatisée — voir Configurer les webhooks.