Le verdict en trois phrases
Au-delà de quelques dizaines de vendeurs, le paiement manuel devient une source d'erreurs et de retards : il faut un split automatique à l'encaissement et un payout planifie via API. Sur une commande de 20 000 FCFA à 15 % de commission, 17 000 FCFA reviennent au vendeur et 3 000 FCFA à la plateforme, calculés automatiquement. Batcher 500 payouts/semaine au lieu de 500 déclenchements manuels supprime les oublis et fiabilise la réconciliation comptable.
Architecture du split et du payout
Le principe : chaque paiement client est immédiatement décompose en part vendeur et commission plateforme, puis les parts vendeurs s'accumulent dans un solde jusqu'au payout planifié. Voici les composants et leurs rôles.
| Composant | Rôle | Fréquence |
|---|---|---|
| Webhook d'encaissement | Confirme le paiement client | Temps réel |
| Moteur de split | Calculé part vendeur / commission | À chaque commande |
| Ledger vendeur | Accumule le solde dû à chaque vendeur | Continu |
| Batch de payout | Regroupe les versements dus | Hebdomadaire |
| API de disbursement | Exécute les virements Wave/OM/MTN | Au batch |
| Réconciliation | Rapproche payouts et commandes | Après batch |
Ce découplage entre l'encaissement (temps réel) et le payout (batch) est ce qui permet de tenir la charge tout en gardant des comptes justes.
Coût par payout et cadence optimale
Le coût d'un payout API dépend du montant et du provider. Batcher réduit le nombre d'appels et donc les frais fixes, mais il faut équilibrer avec le délai vendeur. Voici des ordres de grandeur 2026 pour une marketplace à Douala/Lagos.
| Cadence | Payouts/semaine | Coût frais indicatif | Délai vendeur |
|---|---|---|---|
| Quotidien | 3 500 | Élevé | 1 jour |
| 2x/semaine | 1 000 | Moyen | 3-4 jours |
| Hebdomadaire | 500 | Faible | 7 jours |
| À la demande | Variable | Frais/retrait | Immédiat (payant) |
| Seuil 25 000 FCFA | Réduit | Optimisé | Variable |
Au Nigeria, batcher 500 payouts/semaine via une API de transferts évite 500 déclenchements manuels : moins d'erreurs de saisie, une seule réconciliation par batch, et un taux d'échec traçable.
Taux d'échec et stratégie de retry
Un payout automatique échoue parfois : numéro invalide, compte plafonné, provider indisponible. Une bonne architecture prévoit un retry intelligent et une file d'échecs. Voici des ordres de grandeur.
Besoin d'un site web professionnel ?
Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.
| Cause d'échec | Fréquence indicative | Stratégie |
|---|---|---|
| Numéro/compte invalide | 1 à 2 % | Notifier le vendeur, corriger |
| Plafond wallet atteint | < 1 % | Retry après 24h |
| Provider indisponible | 0,5 à 1 % | Retry auto x3 espacés |
| Float insuffisant | Variable | Alerte + top-up |
| Timeout réseau | 1 à 2 % | Retry immédiat idempotent |
La clé est l'idempotence : chaque payout porte un identifiant unique pour qu'un retry ne génère jamais un double versement. Sans cela, un timeout suivi d'un retry peut payer deux fois un vendeur.
Mini cas pratique
Nadège, fondatrice d'une marketplace artisanale à Douala, traite 500 commandes/semaine à un panier moyen de 20 000 FCFA et 15 % de commission. Le split automatique reverse 17 000 FCFA/commande au vendeur, soit 8 500 000 FCFA/semaine de payouts, et retient 1 500 000 FCFA de commission. En passant du paiement manuel à un batch hebdomadaire avec retry idempotent, elle supprime environ 3h de travail manuel/semaine et ramène son taux d'erreur de versement de 4 % à moins de 0,5 %, évitant des litiges vendeurs coûteux.
FAQ
Comment fonctionne le split automatique ? À chaque paiement confirmé par webhook, le moteur calcule instantanément la part vendeur et la commission. Sur 20 000 FCFA à 15 %, le vendeur reçoit 17 000 FCFA et la plateforme 3 000 FCFA, sans intervention manuelle.
Pourquoi batcher les payouts ? Regrouper 500 versements en un seul batch hebdomadaire réduit les frais fixes, limite les erreurs de saisie et permet une seule réconciliation par cycle au lieu de 500.
Qu'est-ce que l'idempotence et pourquoi c'est vital ? C'est le fait qu'un même payout, même rejoue après un timeout, ne s'exécute qu'une seule fois. Sans elle, un retry peut verser deux fois un vendeur et créer un trou de trésorerie.
Quel taux d'échec anticiper ? Comptez un ordre de grandeur de 2 à 4 % d'échecs cumulés (numéros invalides, timeouts, plafonds). Une file de retry et des alertes ramènent l'échec net à moins de 0,5 %.
Comment gérer un float insuffisant ? Une alerte automatique déclenche un top-up avant le batch. Sans float suffisant, les payouts se mettent en file et le délai vendeur dérape de plusieurs heures.
Discutons de votre projet. Nous construisons votre moteur de split et de payout automatique avec retry idempotent et réconciliation. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.
