API marketplace : annonces, panier, checkout et paiements vendeurs

Les API marketplace ChefSphere s'adressent aux équipes produit qui ont besoin de vrais parcours commerce — pas d'un simple dump de catalogue. Vous disposez d'annonces, panier, checkout, commandes, retours et payouts pour que acheteurs et vendeurs finalisent des transactions dans votre app. Le module s'articule avec le KYC vendeur, les wallets et les médias, pour un parcours cohérent sans assembler cinq prestataires pour un seul checkout.

Ce guide cible l'intention commerce : découverte, achat, remise en fulfillment et mouvement d'argent vendeur. Ce n'est ni une vue d'architecture multi-modules, ni le guide opérationnel vertical restaurant ; ces sujets ont leurs propres guides. Ici, on reste sur le fil listings → payouts, et sur la consommation de tokens prépayés quand le checkout coûte plus cher qu'une lecture catalogue.

Les annonces demandent un détail structuré, des références média et une propriété vendeur claire, pour que vos clients rendent l'UI sans inventer le schéma en cours de sprint. Panier et checkout exigent des snapshots de prix déterministes, une réservation sensible au stock, et des modes d'échec que le support peut expliquer. Commandes, retours et payouts doivent suivre des statuts liés à la vérification vendeur, pour que l'argent ne parte pas avant que la politique le permette.

Les lectures restent légères sur le ledger prépayé ; les écritures checkout pèsent davantage, car elles mutent argent et inventaire. C'est voulu : vous payez les opérations à risque métier, tandis que le parcours découverte reste abordable. Les tokens non utilisés restent sur votre solde, partagé entre tous les modules ChefSphere — pas verrouillés au seul commerce.

En accès anticipé, vous décrivez ce que vous construisez ; nous examinons la demande et vous contactons à l'ouverture des clés et de l'onboarding pour vos marchés et votre modèle vendeur. Les docs publiques incluent des formes OpenAPI illustratives pour planifier ; les contrats de production suivent une fois l'accès accordé.

L'authentification est de type Firebase : un en-tête X-API-Key à chaque appel, débité sur votre solde de tokens prépayés commun à toute la plateforme. Les packs Starter démarrent à 29 $ pour 200 000 tokens ; Growth et Scale augmentent volume et taux effectif dans la bande publique juillet 2026. Un seul solde finance marketplace, live, IA, social, billing et le reste des dix-neuf modules.

Dimensionnez selon votre mix réel, pas selon un coût moyen d'appel qui masque les pics checkout et KYC pendant l'onboarding vendeurs. Si la première version est surtout navigation avec peu de checkout, Starter peut suffire pour intégrer et valider. Si vous cumulez checkout concurrent, IA ou live le même mois, Growth à 79 $ ou Scale à 149 $ est la bande de planification honnête.

Choisissez ce module quand le commerce est l'épine dorsale : multi-vendeurs, panier, checkout, retours et payouts comme parcours principal. Tournez-vous vers les guides de composition (app food, fitness, etc.) quand catalogue, planning, social et commerce doivent cohabiter sous une même histoire produit. Préférez le guide backend marketplace restaurant quand découverte restos, menus et outils opérateur dominent face aux patterns multi-vendeurs génériques.

Demandez l'accès anticipé avec une note courte sur le modèle vendeur, la géographie et le besoin de KYC avant le premier payout. Les lectures associées (KYC vendeur, wallets, marketplace restaurant) aident à poser tôt le chemin argent et le récit vertical. Mieux vaut ça que brancher une vitrine sur des échantillons illustratifs sans plan de confiance ni de payout défendable face à la finance.