Identifier les flux et les responsabilités
Une marketplace met en relation au moins trois acteurs : acheteur, vendeur et plateforme. Chaque mouvement financier doit être attribué à l'un d'eux, en cohérence avec les conditions commerciales et les règles applicables.
Le modèle de commission, les frais, les délais de reversement et les éventuelles cautions influencent directement le parcours utilisateur et les données à conserver.
Dessiner les scénarios avant les écrans
Une transaction réussie n'est qu'un scénario parmi d'autres. Le produit doit aussi expliquer ce qui se passe si un vendeur annule, si l'acheteur demande un remboursement ou si un paiement échoue.
Un diagramme d'états partagé avec l'équipe métier évite d'improviser les règles au fil du développement.
- Paiement autorisé, capturé, échoué ou remboursé.
- Commission, reversement et éventuel ajustement.
- Litiges, annulations et délais de traitement.
S'appuyer sur un prestataire adapté
Des solutions comme Stripe Connect peuvent prendre en charge certaines opérations liées aux comptes vendeurs et aux paiements. Leur intégration exige néanmoins de comprendre les modèles de charges et de transferts, les responsabilités et les pays pris en charge.
Le bon montage dépend du contrat commercial et du fonctionnement réel de la marketplace. Les conditions exactes doivent être validées avec les équipes juridiques et financières compétentes.
Traiter les webhooks comme des événements métier
Les événements peuvent arriver plusieurs fois ou dans un ordre inattendu. Votre backend doit vérifier leur authenticité, retrouver la transaction concernée et appliquer des mises à jour idempotentes.
Un journal des événements et des mécanismes de reprise permettent de diagnostiquer un incident sans modifier manuellement les soldes.
Rendre les opérations explicables
Support client, comptabilité et responsables métiers doivent pouvoir répondre à une question simple : où en est cet argent et pourquoi ?
Pour y parvenir, distinguez les états de la commande, du paiement et du reversement. C'est souvent la meilleure façon de prévenir les incohérences visibles dans l'administration.
