Le settlement report, seule vérité sur ce que le PSP doit au marchand
Le settlement report (rapport de règlement) est le document par lequel le PSP décompose chaque versement en ses constituants : transactions réglées, remboursements, chargebacks, frais, corrections. Il constitue la pièce pivot du niveau 2 de réconciliation, puisqu'il est le seul document qui rattache le montant réellement reçu aux opérations qui l'ont formé. En son absence, le montant d'un payout ne peut être rapproché d'aucune vente en particulier.
Les rapports transactionnels, qui listent les paiements autorisés/capturés, relèvent d'un objet différent. Une transaction capturée n'est pas encore réglée, et une transaction réglée peut figurer dans un lot autre que celui attendu, à la suite d'un retry, d'un litige ou d'une correction. Le settlement report relie ces deux plans, celui des transactions et celui de l'argent effectivement versé.
- Granularité transaction : une ligne par événement (règlement, refund, chargeback, frais unitaire), ce qui est indispensable au matching automatique.
- Granularité batch : totaux par lot de règlement, utile au contrôle de cohérence et au rapprochement bancaire.
- Identifiants pivots : référence PSP (
pspReference,balance_transaction), référence marchand (numéro de commande), numéro de batch/payout.
Règlement brut vs règlement net
Le mode de règlement désigne la manière dont le PSP répercute ses commissions sur les sommes qu'il verse au commerçant. Deux modèles coexistent sur le marché. Avec le règlement net (Stripe, Adyen, PayPal…), le PSP déduit ses frais de chaque versement, qui arrive donc amputé et sans total de ventes correspondant. Avec le règlement brut (modèle historique des acquéreurs de proximité type Worldline/banques acquéreurs CB), le montant intégral des remises est crédité et les commissions font l'objet d'une facture séparée, souvent mensuelle et prélevée en une fois.
| Critère | Règlement net | Règlement brut + facture |
|---|---|---|
| Lisibilité du relevé bancaire | Faible : le virement ne correspond à aucun total de ventes | Bonne : le crédit = total de la remise |
| Réconciliation des frais | Ligne à ligne dans le settlement report (colonnes commission/interchange/scheme fees) | Contrôle de la facture mensuelle contre le volume remis |
| Comptabilisation | Obligation de reconstituer le brut : CA au brut, frais en charges (en France, compte 627) | Directe : remises au brut, facture en charges |
| Trésorerie | Frais lissés au fil de l'eau | Prélèvement de frais concentré (pic mensuel) |
| TVA sur commissions | À reconstituer depuis le rapport (frais souvent exonérés, mais pas tous) | Portée par la facture |
Le mapping transaction → payout
Le mapping transaction vers payout désigne la chaîne de clés qui relie la transaction unitaire au virement reçu en banque, maillon par maillon et sans rupture. Toute la mécanique de réconciliation niveau 2 repose sur cette chaîne. Chaque PSP a son vocabulaire propre, alors que la structure reste invariante et compte toujours quatre maillons, transaction → lot de règlement → payout → écriture bancaire.
- Chez Adyen :
pspReference(transaction) →Batch Number(lot) → ligneMerchantPayoutdu même batch → virement dont le libellé contient le numéro de batch. - Chez Stripe :
charge id→balance_transaction→automatic_payout_id(po_…) → virement dont le libellé/référence contient l'identifiant de payout ou le statement descriptor. - Chez un acquéreur CB classique : numéro de remise (télécollecte) → crédit de remise J+1. Le ticket de télécollecte du TPE est la clé.
EndToEndId). La plupart des PSP le proposent en paramétrage. Le matching bancaire passe alors de probabiliste (montant + date) à déterministe (référence exacte), sans fenêtre de tolérance à régler ni arbitrage à rendre.Exemple : le Settlement details report d'Adyen
Adyen génère à chaque batch un Settlement details report (CSV, ~30 colonnes) qui porte une ligne par événement imputé au lot. Les colonnes de montants distinguent le brut (Gross) du net (Net), et détaillent les frais en quatre composantes : Commission (marge Adyen), Markup, Scheme Fees (frais réseau) et Interchange (commission d'interchange reversée à l'émetteur).
# Les lignes commencant par # sont des annotations pedagogiques (absentes du fichier reel).
# 1 ligne = 1 evenement impute au batch de reglement n° 43, verse le 11/07/2026.
Company Account,Merchant Account,Psp Reference,Merchant Reference,Type,Creation Date,Gross Currency,Gross Debit (GC),Gross Credit (GC),Net Currency,Net Debit (NC),Net Credit (NC),Commission (NC),Markup (NC),Scheme Fees (NC),Interchange (NC),Batch Number
# Vente reglee : brut 120,00 - frais 1,06 (0,11+0,10+0,10+0,75) = net 118,94
AcmeGroup,AcmeECOM_FR,LZM7XW9T2QK8N5D2,CMD-100234,Settled,2026-07-08 14:12:33,EUR,,120.00,EUR,,118.94,0.11,0.10,0.10,0.75,43
# Deuxieme vente reglee : brut 45,50 - frais 0,48 = net 45,02
AcmeGroup,AcmeECOM_FR,QW83JD0S7PL2M4A9,CMD-100235,Settled,2026-07-08 16:41:05,EUR,,45.50,EUR,,45.02,0.11,0.05,0.07,0.25,43
# Remboursement : debit du brut 30,00 + commission de traitement 0,11 = net debite 30,11
AcmeGroup,AcmeECOM_FR,PK52RB8V1XC3T7E6,CMD-100198,Refunded,2026-07-09 09:02:11,EUR,30.00,,EUR,30.11,,0.11,,,,43
# Chargeback : la transaction d'origine (CMD-100150) est reprise integralement
AcmeGroup,AcmeECOM_FR,HD91MN4Q6ZS8W2R5,CMD-100150,Chargeback,2026-07-09 18:55:47,EUR,89.90,,EUR,89.90,,,,,,43
# Frais forfaitaires de chargeback, factures au batch (ligne de type Fee, sans pspReference)
AcmeGroup,AcmeECOM_FR,,,Fee,2026-07-09 23:59:59,,,,EUR,15.00,,,,,,43
# Ligne MerchantPayout : le virement emis vers la banque du marchand. Elle equilibre le batch :
# credits 118,94 + 45,02 = 163,96 ; debits 30,11 + 89,90 + 15,00 = 135,01 ; payout = 28,95
AcmeGroup,AcmeECOM_FR,,,MerchantPayout,2026-07-11 06:00:00,,,,EUR,28.95,,,,,,43- Types de lignes usuels :
Settled,Refunded,Chargeback,ChargebackReversed,SecondChargeback,Fee,InvoiceDeduction,DepositCorrection,Balancetransfer,MerchantPayout. Merchant Referenceporte le numéro de commande du marchand : c'est la clé du matching niveau 1 (ventes ↔ PSP).Batch Numberest la clé du matching niveau 3 : le virement bancaire d'Adyen référence ce numéro.
MerchantPayout incluse) = 0,00. Ce contrôle d'intégrité doit s'exécuter automatiquement à la réception de chaque rapport, avant même le début du matching. Un échec signale un fichier incomplet ou corrompu, qu'il devient inutile de chercher à rapprocher.Exemple : balance transactions et payout reconciliation chez Stripe
Le modèle de Stripe repose sur la balance transaction (txn_…). Chaque événement monétaire (charge, refund, dispute, frais, payout) crée une ligne dans le solde Stripe, avec gross, fee et net. Le rapport payout_reconciliation.itemized liste toutes les balance transactions rattachées à un payout donné, ce qui en fait l'équivalent fonctionnel du settlement details d'Adyen.
# Toutes les lignes ci-dessous sont rattachees au meme virement automatique po_1PcgT4KiAcme8812.
balance_transaction_id,created_utc,available_on_utc,currency,gross,fee,net,reporting_category,source_id,description,automatic_payout_id
# Vente 120,00 - frais 2,05 (1,5 % + 0,25 EUR, carte EU standard) = net 117,95
txn_3PZkX1KiAcme0451,2026-07-08 14:12:33,2026-07-10 00:00:00,eur,120.00,2.05,117.95,charge,ch_3PZkX1KiAcme0451,CMD-100234,po_1PcgT4KiAcme8812
# Vente 45,50 - frais 0,93 = net 44,57
txn_3PZmB4KiAcme0777,2026-07-08 16:41:05,2026-07-10 00:00:00,eur,45.50,0.93,44.57,charge,ch_3PZmB4KiAcme0777,CMD-100235,po_1PcgT4KiAcme8812
# Remboursement : gross negatif, les frais initiaux ne sont pas restitues
txn_3PZnC5KiAcme0810,2026-07-09 09:02:11,2026-07-10 00:00:00,eur,-30.00,0.00,-30.00,refund,re_3PZnC5KiAcme0810,REMBOURSEMENT CMD-100198,po_1PcgT4KiAcme8812
# Litige (dispute) : reprise de 89,90 + frais de litige 15,00 = net -104,90
txn_3PZpD6KiAcme0933,2026-07-09 18:55:47,2026-07-10 00:00:00,eur,-89.90,15.00,-104.90,dispute,du_3PZpD6KiAcme0933,LITIGE CMD-100150,po_1PcgT4KiAcme8812
# Controle : 117,95 + 44,57 - 30,00 - 104,90 = 27,62 EUR = montant exact du payout po_1PcgT4Ki...La colonne available_on_utc porte le délai de disponibilité des fonds (schedule de règlement). Une charge du 08/07 devient disponible le 10/07 et part dans le payout du jour. En API, GET /v1/balance_transactions?payout=po_… restitue la même décomposition en JSON, format commode pour une réconciliation intégrée sans dépôt de fichiers.
description reprend ici la référence de commande parce que le marchand l'a passée dans les métadonnées de la charge. La propagation de la référence commande dans chaque appel de paiement est la décision d'architecture la plus rentable de toute la chaîne de réconciliation, puisqu'elle fait remonter le numéro de commande jusque dans le rapport du PSP, où il devient la clé du matching de niveau 1.Réconcilier les commissions et maîtriser les fréquences de versement
Le contrôle des commissions consiste à recalculer les frais ligne à ligne à partir de la grille contractuelle et à les comparer aux colonnes de frais du settlement report. En tarification interchange++, chaque composante est contrôlable séparément ; en tarification blended, seul le taux global l'est.
| Modèle | Composition | Contrôle possible | Pièges |
|---|---|---|---|
| Blended | Taux unique (ex. 1,4 % + 0,25 €) quel que soit le type de carte | Recalcul simple : taux × brut + fixe, au centime près | Le taux « moyen » masque les cartes commerciales et hors EEE, souvent surfacturées |
| Interchange++ | Interchange réel (plafonné à 0,2 %/0,3 % intra-EEE consommateur, règlt UE 2015/751) + frais scheme réels + markup PSP | Contrôle composante par composante contre les grilles publiées Visa/Mastercard | Grilles d'interchange complexes (centaines de lignes) ; vérifier que le markup seul rémunère le PSP |
| Prestataire | Fréquence par défaut | Délai de disponibilité | Brut / net |
|---|---|---|---|
| Stripe | Quotidienne (rolling) | J+2 à J+3 ouvrés en France | Net |
| Adyen | Quotidienne ou hebdomadaire (configurable) | J+1 à J+2 selon moyen de paiement | Net, frais détaillés par ligne |
| PayPal | Continue vers le solde marchand | Retrait vers la banque : 1 à 3 jours ouvrés | Net |
| Acquéreur CB « classique » | Par remise (télécollecte quotidienne) | J+1 ouvré | Brut + facture de commissions mensuelle |
| American Express | Selon contrat | J+3 à J+7 (option accélérée payante) | Net d'escompte |