MonCashConnectDocumentation
TransportTaxi · VTC · Livraison · Course in-app

MonCashConnect pour apps de transport en Haïti

Votre app de taxi, VTC ou livraison opère en Haïti. Vous voulez que les clients paient leur course en MonCash en fin de trajet, sans cash entre les mains du chauffeur, et que les chauffeurs reçoivent leurs gains automatiquement. MonCashConnect vous donne le rail de collecte et le rail de payout.

Le problème

  • ·Le cash à bord crée des risques de sécurité pour les chauffeurs, des problèmes de monnaie, et zéro traçabilité comptable pour l'opérateur de l'app.
  • ·Une app de transport doit collecter chaque course, prélever sa commission, puis reverser le solde au chauffeur — pattern marketplace classique que MonCash natif ne couvre pas.
  • ·Le timing compte : la course est terminée, le chauffeur veut partir, le client a juste un téléphone. Le paiement doit se faire en moins de 30 secondes, sans terminal physique.
  • ·Lutter contre la fraude (courses fantômes, collusion chauffeur-client) demande un délai de carence avant payout, qu'aucun outil natif MonCash ne permet.

Comment MonCashConnect aide

Paiement de course in-app : à la clôture, votre app crée un paiement MCC reference_id = ride:r123:fare et ouvre l'URL MonCash dans le webview ou via deep-link.

Webhook payment.completed signé : votre backend reçoit l'évènement en <30s, marque la course payée, libère le chauffeur dans la file de dispatch.

Ledger marketplace côté votre code : chaque course crédite le chauffeur (montant - commission - frais) dans votre base, votre plateforme garde sa commission.

Payouts batches vers chauffeurs : quotidiens, hebdomadaires ou à la demande, via API ou dashboard MCC. Vous décidez de la fréquence selon votre politique de carence anti-fraude.

Dashboard temps réel : voir les courses encaissées, les remboursements en cours, les payouts à venir, exporter pour la compta.

Flow : course de 850 HTG, commission plateforme 15 %

  1. 1. Chauffeur clôture la course dans son app. Votre backend calcule le montant final : tarif de base + temps + distance = 850 HTG.
  2. 2. Bouton « Payer » côté client. L'app client affiche le récapitulatif, le client appuie. Votre backend crée un paiement MCC avec amount: 850 et reference_id: "ride_r4421:fare".
  3. 3. Redirection MonCash. L'app ouvre l'URL MCC dans un webview (ou deep-link vers le navigateur). Le client confirme dans son MonCash, 850 HTG sont débités.
  4. 4. Webhook payment.completed. Votre backend décompose en ledger : 722 HTG crédités au chauffeur (850 − 15 % commission = 722,5, arrondi), 127 HTG à la plateforme. La course passe en statut paid.
  5. 5. Chauffeur libéré. L'app chauffeur reçoit la notification « course payée », le chauffeur retourne en file de dispatch. Le crédit dans son wallet plateforme n'est pas encore payé en MonCash — il attend le batch.
  6. 6. Payout quotidien. Votre cron 23h prend tous les chauffeurs éligibles (crédit dépassant 200 HTG, course antérieure à J-1 pour la carence anti-fraude) et envoie un batch de payouts MonCash via API.
Le délai de carence (24h ou 48h) entre la course et le payout chauffeur est votre arme principale contre la fraude. Pendant cette fenêtre, vous pouvez détecter une anomalie (GPS incohérent, plainte client) et bloquer le payout.

Quel plan vous convient

Une app de transport en exploitation cumule deux besoins forts : retraits illimités pour payer les chauffeurs sans plafond quotidien, et plusieurs projets pour isoler prod / staging / back-office.

App de transport en exploitation

Dizaines à centaines de chauffeurs actifs, batchs de payouts quotidiens, besoin d'isoler plusieurs environnements (prod, staging, dispatch interne).

Business — 5 000 HTG / mois

Business débloque les retraits illimités côté plateforme — critique quand vous payez beaucoup de chauffeurs chaque jour — et 5 projets. Pendant un POC ou une phase pilote restreinte (un quartier, quelques chauffeurs), Pro (2 500 HTG/mois) peut suffire ; passez à Business avant la généralisation.

Comparatif sur la page Tarifs.

FAQ — Transport et VTC

Faut-il que le client paie pendant la course ou à la fin ?+
À la fin. Quand le chauffeur clôture la course dans l'app, le client reçoit dans l'app la facture (course + commission + frais) avec un bouton « Payer maintenant » qui ouvre l'URL MonCash. Le chauffeur peut quitter la zone — la confirmation arrive en webhook côté votre serveur.
Comment je verse les chauffeurs ?+
C'est le pattern marketplace : vous collectez 100 % du montant côté client, vous tenez votre ledger interne (combien vous devez à chaque chauffeur, après commission plateforme et frais réseau), et vous lancez un batch de payouts MonCash quotidien ou hebdomadaire vers les chauffeurs. Voir le use case Marketplaces pour le détail.
Et si le client n'a pas assez de solde MonCash à la fin de course ?+
Le paiement échoue côté MonCash, vous recevez payment.failed. Votre app affiche au client « solde insuffisant, recharger ou choisir autre paiement ». La course reste marquée non-payée dans votre système ; vous gérez la procédure (relance, paiement cash hors-app, escalade) selon votre charte plateforme.
Peut-on permettre les pourboires ?+
Oui — vous créez le paiement avec le montant course + pourboire choisi par le client avant validation. Le pourboire est juste une portion du reference_id que votre ledger reverse intégralement au chauffeur (sans prendre votre commission dessus, si c'est votre politique).
Comment je détecte les courses fantômes (chauffeur qui clôture sans réelle course) ?+
C'est votre logique applicative — pas une feature gateway. MCC vous donne la trace fiable que de l'argent a transité ; la lutte contre la fraude (correspondance GPS, durée, profil chauffeur) reste votre couche métier. Une bonne pratique : retarder le payout vers le chauffeur d'au moins 24h pour avoir le temps de détecter une anomalie avant que l'argent sorte.
Quel plan pour une app de transport en exploitation ?+
Business (5 000 HTG/mois) est l'arrangement standard : retraits illimités pour payer beaucoup de chauffeurs en parallèle, et 5 projets pour isoler prod / staging / intégration partenaire / dispatch back-office. Pendant un POC à petit volume, Pro peut tenir, mais dès que vous lancez les payouts chauffeurs réguliers, Business est nécessaire.
MonCashConnect est une plateforme indépendante d'intégration. Une app de transport est en général un cas d'usage marketplace ; vérifiez en plus avec votre conseil juridique les obligations locales (assurance chauffeur, déclaration d'activité) — MonCashConnect couvre la partie paiement, pas la partie régulation transport.

Lectures recommandées :

MarketplacesRestaurantsE-commerceDocumentation APITarifsRéférence API complète