MonCashConnectDocumentation
MarketplaceMulti-vendeurs · Livraison · Services · Mise en relation

MonCashConnect pour marketplaces multi-vendeurs

Vous opérez une marketplace en Haïti — food delivery, services à domicile, petites annonces, app de mise en relation — et vous devez collecter en MonCash auprès des clients, puis reverser à plusieurs vendeurs. MonCashConnect vous donne le rail de collecte et le rail de payouts ; à vous de tenir le ledger interne et la logique de split.

Le problème

  • ·Une marketplace doit encaisser de chaque client final puis verser à plusieurs vendeurs distincts. Le portail MonCash standard ne gère pas ce pattern : il voit juste « une transaction = un marchand ».
  • ·Sans webhook signé, vous ne pouvez pas confier au client mobile ou au vendeur la confirmation de paiement — il faut un évènement serveur fiable pour incrémenter le solde dû à chaque vendeur.
  • ·Faire des virements MonCash manuels vers chaque vendeur ne scale pas dès qu'il y en a plus d'une dizaine — il vous faut une API de payouts batchables.
  • ·Les litiges (livraison ratée, commande annulée) demandent de retenir temporairement les fonds avant de payer le vendeur. Aucun produit MonCash natif ne fait ça.

Comment MonCashConnect aide

Collecte unifiée : chaque commande sur votre marketplace crée un paiement MCC, le client paie une seule fois, l'argent atterrit sur votre solde marketplace.

Webhooks signés HMAC-SHA256 : à chaque payment.completed votre service débite le crédit du vendeur correspondant dans VOTRE base — c'est votre ledger interne, pas une feature gateway.

Payouts MonCash vers vendeurs via API ou dashboard : déclenchez un batch quotidien ou hebdomadaire, chaque ligne va vers le numéro MonCash du vendeur.

Délai de garantie configurable côté votre code : vous ne lancez le payout vendeur qu'après confirmation de livraison ou après J+N pour absorber les litiges.

Dashboard avec filtres par reference_id, par statut, export CSV — vous réconciliez par vendeur ou par cohorte.

Pattern split payouts : food delivery

Une commande de 2 500 HTG sur votre app de livraison, dont 2 000 HTG pour le restaurant, 300 HTG pour le livreur et 200 HTG de commission marketplace :

  1. 1. Client paie 2 500 HTG. Vous créez un paiement reference_id: "order_77321". Le client confirme sur MonCash, l'argent arrive sur votre solde MCC.
  2. 2. Webhook payment.completed. Votre service décompose dans votre ledger marketplace : credit(restaurant_42, 2000), credit(driver_18, 300), credit(marketplace_account, 200).
  3. 3. Livraison confirmée. Quand le livreur tape « livré » dans l'app, vous flippez order.eligibleForPayout = true.
  4. 4. Batch payout quotidien. Votre cron 22h prend tous les vendeurs avec un crédit eligibleForPayout, génère un batch de payouts MonCash via API, et marque les crédits comme payés.
  5. 5. Litige éventuel. Si le client appelle pour signaler un problème AVANT 22h, vous flippez eligibleForPayout = false sur l'ordre concerné — le restaurant et le livreur ne sont pas inclus dans le batch ce jour-là, le temps d'investiguer.

Pseudo-code du handler de webhook côté marketplace :

// Sur payment.completed pour une commande marketplace
async function onOrderPaid(orderId) {
  const order = await db.orders.findById(orderId);
  const split = computeSplit(order);          // votre logique métier

  await db.tx(async (t) => {
    await t.ledger.credit(order.vendorId, split.vendor);
    await t.ledger.credit(order.driverId, split.driver);
    await t.ledger.credit("marketplace",   split.platform);
    await t.orders.update(orderId, { status: "paid" });
  });
}
Le ledger est votre code. MonCashConnect garantit l'évènement signé d'entrée et le rail de payout en sortie ; entre les deux, c'est votre métier qui décide qui touche combien, quand, et sous quelle condition.

Quel plan vous convient

Une marketplace a besoin de retraits illimités (vous payez beaucoup de vendeurs en parallèle) et de plusieurs projets pour isoler les environnements.

Marketplace multi-vendeurs

Dizaines à centaines de vendeurs, batch payouts réguliers, besoin d'isoler prod / staging / intégrations partenaires.

Business — 5 000 HTG / mois

Business débloque les retraits illimités côté plateforme (les frais réseau Digicel à 5 % par payout restent évidemment) et 5 projets. C'est la configuration normale pour une marketplace en exploitation. Vous pouvez démarrer en Pro pendant un POC à faible volume, mais dès que vous lancez les payouts vendeurs, passez en Business.

Voir tarifs complets.

FAQ — Marketplaces

MonCashConnect offre-t-il un vrai split de paiement comme Stripe Connect ?+
Pas au sens Stripe Connect : on ne route pas automatiquement une fraction du paiement vers un compte MonCash tiers à l'instant T. Le pattern marketplace est plus simple : vous collectez 100 % sur votre compte MCC, vous tenez votre propre ledger de qui doit quoi à qui, et vous lancez des batches de payouts MonCash vers les vendeurs sur le cycle de votre choix (quotidien, hebdomadaire).
Comment je suis ce que je dois à chaque vendeur ?+
C'est à votre application de tenir cette comptabilité. À chaque payment.completed pour une commande, vous incrémentez le crédit_vendeur correspondant dans votre base. MCC vous donne le rail de paiement et l'évènement signé ; le ledger marketplace (sous-comptes virtuels, calcul de commission, historique des payouts) reste votre logique métier.
Comment je verse les fonds aux vendeurs ?+
Vous lancez des payouts vers leurs comptes MonCash depuis votre dashboard ou via API. Les frais réseau Digicel (5 %) s'appliquent à ces payouts. Vous pouvez batcher pour réduire le nombre d'opérations, mais le frais 5 % reste par transaction MonCash.
Que faire en cas de litige client (commande non livrée) ?+
Le pattern recommandé : retardez le payout vendeur jusqu'à la confirmation de livraison. Le client a payé, l'argent est sur votre solde marketplace, mais vous ne déclenchez le payout vers le vendeur qu'après J+N ou après confirmation explicite. Si litige, vous remboursez le client depuis le solde, le vendeur ne reçoit rien.
Quelle commission je peux prélever moi-même sur chaque transaction ?+
Celle que vous voulez. MonCashConnect ne vous limite pas. Si vous prenez 15 % sur chaque vente, le calcul est : montant collecté = total client ; reversé au vendeur = total client − 15 % − frais réseau. Vous gardez les 15 % sur votre solde marketplace.
Le plan Business suffit pour une marketplace en croissance ?+
Business (5 000 HTG/mois) débloque les retraits illimités, ce qui est critique pour une marketplace qui doit verser à beaucoup de vendeurs en parallèle. 5 projets vous laissent isoler prod, staging, intégration partenaire et dev. Au-delà d'un certain volume, contactez l'équipe pour discuter d'arrangements custom.
Le ledger marketplace (qui doit quoi à qui, à quelle date, sous quel statut) reste votre responsabilité. MonCashConnect fournit le rail de paiement et le rail de payout, pas le moteur de marketplace lui-même.

Lectures recommandées :

RestaurantsTransport / TaxiE-commerceDocumentation APITarifsRéférence API complète