Aller au contenu

Marketplace e-commerce multi-vendeurs

Rethrow

Une marketplace complète où particuliers et professionnels vendent du matériel informatique vintage : paiements Stripe Connect, expédition Mondial Relay et back-office, de l'annonce au reversement.

  • Next.js
  • TypeScript
  • PostgreSQL
  • Prisma
  • Stripe Connect
  • Mondial Relay
  • Playwright
Page d'accueil de rethrow.io : moteur de recherche d'articles et accroche « Redécouvrez les machines d'hier »
Page d'accueil publique de rethrow.io (design et intégration de cette page : mon associé).

Contexte

Objectifs

  • Permettre à des vendeurs particuliers et professionnels d'encaisser en ligne, la plateforme prélevant une commission.
  • Rassurer l'acheteur : le vendeur n'est payé qu'une fois la livraison confirmée.
  • Automatiser l'expédition : point relais, étiquette et suivi du colis.
  • Donner à l'équipe un back-office pour piloter catalogue, commandes, litiges et finances sans développeur.

Le besoin

Une marketplace ne se résume pas à une boutique en ligne : l'argent de l'acheteur doit être réparti entre plusieurs vendeurs, la plateforme doit prélever sa part, et chaque vendeur ne doit être payé qu'une fois la commande bien reçue. Il faut aussi gérer les retours, les remboursements partiels et les litiges.

À cela s'ajoutent la logistique (chaque vendeur expédie son propre colis) et les obligations d'une plateforme européenne : vérification des vendeurs, modération motivée, conditions versionnées, déclaration fiscale des revenus des vendeurs.

La solution

J'ai mené la refonte complète de Rethrow au sein du studio Najumi : nouveau code Next.js, nouveau modèle de données, migration du catalogue de l'ancienne plateforme, puis mise en production. Le modèle s'inspire des grandes plateformes de collectionneurs : un catalogue de référence de près de 2 800 produits, sur lequel chaque vendeur publie ses propres annonces (prix, état, complétude).

Les paiements reposent sur Stripe Connect en « charges et transferts séparés » : la plateforme encaisse, puis transfère au vendeur son montant, commission déduite, au moment où la livraison est confirmée. L'expédition Mondial Relay est créée automatiquement à la commande.

Le parcours d'une commande

Schéma
  1. 01PaiementL'acheteur paie la plateforme (Stripe).
  2. 02ExpéditionÉtiquette Mondial Relay créée automatiquement pour chaque vendeur.
  3. 03SuiviLe statut du colis est synchronisé.
  4. 04Livraison confirméePar l'acheteur, ou automatiquement après un délai.
  5. 05ReversementLe vendeur reçoit son montant, commission déduite.
Schéma simplifié du flux d'argent et d'expédition mis en place.

Fonctionnalités principales

  • 01

    Paiements multi-vendeurs

    Vérification d'identité des vendeurs hébergée par Stripe, commission dégressive, reversement après livraison, remboursements partiels et suivi des litiges. Le vendeur consulte ses paiements, virements et solde dans son espace.

  • 02

    Expédition automatisée

    Choix du point relais, du locker ou de la livraison à domicile ; étiquette Mondial Relay générée à la commande ; suivi du colis synchronisé ; frais de port calculés côté serveur pour 10 pays.

  • 03

    Catalogue et annonces

    Fiches de référence et annonces vendeurs aux états normalisés, recherche à filtres partageables par URL, guide des prix alimenté par les ventes, liste d'envies avec alerte email de mise en vente.

  • 04

    Back-office complet

    Une trentaine de sections : commandes, annulations, litiges, versements, finances, catalogue avec import/export CSV, support, modération, journal des webhooks rejouables. Chaque section est protégée par des permissions dédiées.

  • 05

    Conformité marketplace

    Modération motivée avec procédure d'appel, CGU/CGV versionnées et acceptations tracées, données pour la déclaration fiscale DAC7, vérification des numéros de TVA, anonymisation RGPD.

  • 06

    Documents et emails

    Attestations de vente et factures de commission en PDF, 21 emails transactionnels (commande, expédition, alertes…), interface bilingue FR/EN.

Architecture et choix techniques

Next.js et TypeScript de bout en bout
Server Actions pour les mutations, routes API pour les webhooks et les intégrations. PostgreSQL et Prisma, avec des migrations versionnées.
Stripe Connect en charges et transferts séparés
La plateforme décide du moment du reversement : c'est ce qui permet de ne payer le vendeur qu'après la livraison. Les webhooks sont journalisés et rejouables depuis l'administration.
Sécurité et données
Authentification email et Google, limitation de débit sur les routes sensibles, contrôle du type réel des fichiers envoyés, chiffrement applicatif des identifiants fiscaux, stockage S3 auto-hébergé.
Qualité et exploitation
Plus de 650 tests automatisés écrits (unitaires Vitest et E2E Playwright) sur les règles sensibles : commission, TVA, livraison, remboursements. La CI bloque tout déploiement si un test échoue. Déploiement staging et production sur serveur privé, sauvegardes chiffrées.

Mon rôle

Développeur principal et responsable technique du projet au sein du studio Najumi, de mai 2025 à août 2026 : architecture, développement de l'application, intégrations de paiement et de transport, mise en production et exploitation. J'ai ensuite poursuivi les évolutions de la plateforme, notamment les remboursements partiels, l'export DAC7, la modération DSA et le versionnage des documents légaux (octobre 2026).

  • Architecture applicative et modèle de données.
  • Développement back-end et front-end.
  • Migration du catalogue de l'ancienne plateforme.
  • Intégrations Stripe Connect et Mondial Relay.
  • Back-office, conformité légale et fiscale.
  • Tests automatisés, CI/CD, hébergement et sauvegardes.

Ce qui n'est pas de moi

Mon associé chez Najumi a réalisé le design system et une partie des écrans front (notamment la page d'accueil).

Assistance IA · Depuis mars 2026, le développement est réalisé avec l'assistance de Claude Code, sous ma direction technique : conception, spécifications, architecture, revue et validation.

Résultats

  • Une marketplace en ligne qui couvre tout le cycle : annonce, paiement, expédition, reversement, litige.
  • Un catalogue de près de 2 800 références repris de l'ancienne plateforme.
  • Des flux d'argent conformes au modèle marketplace : commission, reversement après livraison, remboursements.
  • Un back-office qui permet à l'équipe d'opérer la plateforme sans développeur.

Galerie

Recherche de rethrow.io filtrée sur les articles en vente : filtres par catégorie et cartes produit avec photo, année et nombre d'annonces
Recherche à filtres, ici limitée aux articles en vente (page publique).
Page d'accueil de rethrow.io sur mobile
Page d'accueil sur mobile (page réalisée par mon associé).

Vous avez un projet similaire ?

Décrivez-moi votre besoin en quelques lignes. Nous verrons ensemble ce qui est faisable, dans quel ordre et avec quel budget.