Profil : plateforme intermédiaire qui collecte des paiements pour le compte de tiers (vendeurs) et prélève une commission. Exemples : Etsy-like, food delivery, immobilier.

Architecture

Option A : vendeurs sur IzichangePay (recommandé)

Si vos vendeurs ont aussi un compte IzichangePay (typiquement vous les onboarderiez à l’inscription) :
  • Transferts internes : sans frais de gas, sans commission, crédités immédiatement sur la balance du vendeur
  • Chaque vendeur gère son auto-settlement vers son compte mobile money

Option B : vendeurs externes (paiement sur leur propre wallet)

Émettez un payout unitaire par vendeur (payouts.create). Le payout groupé (batch) arrivera en V2.
Pour cette option, activez la whitelist (payoutMode = whitelist_only, défaut allow_all) et pré-enregistrez chaque adresse vendeur. La maturation des adresses (24h) est un réglage plateforme : un payout vers une adresse non mature est rejeté en 403 DESTINATION_NOT_MATURED. Cela évite qu’un compte vendeur compromis ne modifie son adresse pour un vol immédiat.

Tracking des splits

Votre DB doit tracer chaque split pour la compta / reporting vendeur :
À chaque webhook payout.confirmed (ou payout.failed), mettez à jour la ligne correspondante via izipay_payout_id.

Gestion des litiges

Si un client conteste un paiement après split :
  • disputeManager = merchant recommandé sur votre compte plateforme
  • À la décision refund : votre balance n’a peut-être plus le montant (déjà splitté)
  • Solution : retenez la commission + un buffer pendant N jours (configurable) avant de la débloquer
  • Implémenter cette logique côté votre app : IzichangePay ne gère pas l’escrow

KYB cascade

Si vos vendeurs reçoivent leur argent via IzichangePay, ils doivent eux aussi avoir un compte business avec KYB approuvé. Vous pouvez automatiser l’onboarding via le wizard officiel (voir Mise en route).