Les erreurs qui coûtent cher
- Définir les flux après le dev.
- Oublier la réconciliation.
- Sous-estimer KYC et l’onboarding vendeurs.
Modèles de paiement (vue simple)
- Destination charges + application fee.
- Separate charges & transfers.
Le choix dépend :
- du modèle de responsabilité,
- des pays,
- des contraintes de remboursement.
Connect : ce qu’il faut décider avant de coder
- Responsabilité : qui est le marchand of record ?
- Pays : où sont les vendeurs, quelles contraintes KYC.
- Flux refunds/disputes : qui supporte le risque et les frais.
- Commissions : application fee, logique de calcul, cas limites.
KYC / Onboarding
- Données requises.
- Vérifications.
- Gestion des refus.
- Communication vendeurs.
Réconciliation
Définir la “source of truth” : Stripe vs ERP.
Modèle mental (très simple)
Un paiement marketplace = une série d’événements :
- charge
- fee
- transfer (ou payout)
- refund (si besoin)
- dispute (si besoin)
L’objectif : pouvoir expliquer à tout moment :
- combien a payé l’acheteur,
- combien a reçu le vendeur,
- combien a gagné la plateforme,
- quels écarts existent avec l’ERP.
Pipeline de réconciliation
- Identifier les événements : charge, fee, transfer, refund, dispute.
- Mettre en place un pipeline d’export et des contrôles d’écarts.
Remboursements et litiges
- Qui rembourse ?
- Comment répercuter les frais ?
- Workflow support.
Checklist
- Modèle Connect choisi et documenté
- Application fee définie
- Onboarding/KYC outillé
- Exports et réconciliation
- Workflow refunds/disputes
Checklist de réconciliation (extrait)
- Définir la source de vérité (Stripe vs ERP) + règles d’arbitrage
- Exporter les événements (automatisé) et versionner le schéma
- Contrôles d’écarts (montants, volumes, statuts)
- Gestion des cas limites (chargebacks, partial refunds, multi-currency)
Erreurs fréquentes
- Choisir le modèle Connect sans avoir mappé les flux refunds/disputes.
- Pas de réconciliation automatisée (écarts découverts en fin de mois).
- KYC “on verra plus tard” (bloquant en production).
- Pas de gestion des cas limites (chargebacks, partial refunds).
FAQ
Destination charges ou separate charges ? Destination charges est plus simple pour démarrer. Separate charges donne plus de contrôle pour les cas complexes (multi-vendeurs par commande, multi-devises).
La réconciliation est-elle vraiment nécessaire dès le lancement ? Oui. Sans réconciliation, les écarts s’accumulent et deviennent impossibles à corriger après quelques mois d’activité.