Profil : VTC, livraison, plateforme de freelance. Collecte les paiements clients, reverse aux prestataires selon leur volume.

Différence avec Marketplace

Dans une marketplace, le split est par transaction (chaque commande paye son vendeur). Dans la gig economy, le split est par cycle (paie hebdo / quotidienne de TOUS les chauffeurs / livreurs accumulant leur dû).

Workflow type

Privilégiez les transferts internes (payouts.createInternal) quand le prestataire est aussi sur IzichangePay : gratuits et instantanés (voir plus bas). Sinon, émettez un payout unitaire par prestataire (payouts.create).

Code

Le payout groupé (batch) arrivera en V2. Aujourd’hui, on émet un payout par prestataire dans une boucle, chacun idempotent grâce à sa propre idempotencyKey.

Tracking par prestataire

Webhook payout.confirmed / payout.failed (un par payout) :

Cas où le prestataire est aussi sur IzichangePay

Préférable : utilisez createInternal (gratuit, instantané). Le prestataire peut ensuite settle vers son mobile money lui-même (auto-settlement configuré sur son compte).
Avantages :
  • Gratuit (0 gas)
  • Instantané (pas d’attente blockchain)
  • Le prestataire choisit lui-même son rail de cash-out (Wave, OM, MTN, IBAN, etc.) sans que vous ayez à gérer ses préférences

Limites

  • Approbation (TAP) : un payout dépassant le seuil (défaut 500 USD) passe en awaiting_approval et exige l’approbation d’un ou plusieurs administrateurs plateforme (politique Travel-rule), pas d’un membre de votre équipe. Le seuil est une politique plateforme, non self-service
  • Whitelist : si activée, chaque adresse prestataire doit avoir atteint sa maturation (24h, réglage plateforme). Recommandation : onboarding qui demande l’adresse au prestataire à l’inscription, ainsi la maturation est passée avant le premier payout
Pour les gros volumes par cycle, contactez le support : info@izichange.com.