30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# 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](https://stripe.com/docs/connect/charges#transfer-availability)
|
|
- [V0_603_RELEASE_SCOPE.md](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`
|