Virement automatique des vendeurs d'une marketplace a Douala : architecture 2026

Le verdict en trois phrases

Au-dela de quelques dizaines de vendeurs, le paiement manuel devient une source d'erreurs et de retards : il faut un split automatique a l'encaissement et un payout planifie via API. Sur une commande de 20 000 FCFA a 15 % de commission, 17 000 FCFA reviennent au vendeur et 3 000 FCFA a la plateforme, calcules automatiquement. Batcher 500 payouts/semaine au lieu de 500 declenchements manuels supprime les oublis et fiabilise la reconciliation comptable.

Architecture du split et du payout

Le principe : chaque paiement client est immediatement decompose en part vendeur et commission plateforme, puis les parts vendeurs s'accumulent dans un solde jusqu'au payout planifie. Voici les composants et leurs roles.

Ce decouplage entre l'encaissement (temps reel) et le payout (batch) est ce qui permet de tenir la charge tout en gardant des comptes justes.

Cout par payout et cadence optimale

Le cout d'un payout API depend du montant et du provider. Batcher reduit le nombre d'appels et donc les frais fixes, mais il faut equilibrer avec le delai vendeur. Voici des ordres de grandeur 2026 pour une marketplace a Douala/Lagos.

Au Nigeria, batcher 500 payouts/semaine via une API de transferts evite 500 declenchements manuels : moins d'erreurs de saisie, une seule reconciliation par batch, et un taux d'echec traçable.

Taux d'echec et strategie de retry

Un payout automatique echoue parfois : numero invalide, compte plafonne, provider indisponible. Une bonne architecture prevoit un retry intelligent et une file d'echecs. Voici des ordres de grandeur.

La cle est l'idempotence : chaque payout porte un identifiant unique pour qu'un retry ne genere jamais un double versement. Sans cela, un timeout suivi d'un retry peut payer deux fois un vendeur.

Mini cas pratique

Nadege, fondatrice d'une marketplace artisanale a Douala, traite 500 commandes/semaine a 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 a un batch hebdomadaire avec retry idempotent, elle supprime environ 3h de travail manuel/semaine et ramene son taux d'erreur de versement de 4 % a moins de 0,5 %, evitant des litiges vendeurs couteux.

FAQ

Comment fonctionne le split automatique ? A chaque paiement confirme par webhook, le moteur calcule instantanement la part vendeur et la commission. Sur 20 000 FCFA a 15 %, le vendeur recoit 17 000 FCFA et la plateforme 3 000 FCFA, sans intervention manuelle.

Pourquoi batcher les payouts ? Regrouper 500 versements en un seul batch hebdomadaire reduit les frais fixes, limite les erreurs de saisie et permet une seule reconciliation par cycle au lieu de 500.

Qu'est-ce que l'idempotence et pourquoi c'est vital ? C'est le fait qu'un meme payout, meme rejoue apres un timeout, ne s'execute qu'une seule fois. Sans elle, un retry peut verser deux fois un vendeur et creer un trou de tresorerie.

Quel taux d'echec anticiper ? Comptez un ordre de grandeur de 2 a 4 % d'echecs cumules (numeros invalides, timeouts, plafonds). Une file de retry et des alertes ramenent l'echec net a moins de 0,5 %.

Comment gerer un float insuffisant ? Une alerte automatique declenche un top-up avant le batch. Sans float suffisant, les payouts se mettent en file et le delai vendeur derape de plusieurs heures.

Discutons de votre projet. Nous construisons votre moteur de split et de payout automatique avec retry idempotent et reconciliation. WhatsApp +221 77 596 93 33.