veza/docs/PAYOUT_MANUAL.md

Payout vendeurs — Transfert automatique (v0.603)

Contexte : Depuis v0.603, le transfert automatique vers les comptes Stripe Connect des vendeurs est opérationnel après chaque paiement réussi.

Implémentation v0.603

Le transfert automatique s'exécute à chaque webhook Hyperswitch payment.succeeded :

1. Paiement réussi → licences créées pour l'acheteur
2. Items regroupés par vendeur (product.seller_id)
3. Commission plateforme déduite (PLATFORM_FEE_RATE, défaut 10 %)
4. Transfer Stripe Connect exécuté vers le compte du vendeur
5. SellerTransfer enregistré en DB (table seller_transfers)

Les vendeurs peuvent consulter leur historique via GET /sell/transfers et la carte « Transfer History » dans SellerDashboard.

État actuel

• ✅ Onboarding Stripe Connect (POST /sell/connect/onboard)
• ✅ Balance vendeur (GET /sell/balance)
• ✅ Transfert automatique après paiement réussi
• ✅ Historique des transferts (GET /sell/transfers)
• ✅ Commission plateforme configurable (PLATFORM_FEE_RATE)

Références

• Stripe Connect Transfers
• V0_603_RELEASE_SCOPE.md § 5 — Détail technique
• veza-backend-api/internal/services/stripe_connect_service.go : CreateTransfer
• veza-backend-api/internal/core/marketplace/service.go : processSellerTransfers