Portefeuilles & transactions

Swaloo suit les flux d'argent liés aux livraisons à l'aide de portefeuilles (wallets) et de transactions. Chaque encaissement, règlement ou commission est tracé.

Portefeuilles

Un portefeuille détient un solde dans une devise donnée. On distingue :

• le portefeuille chauffeur — représente l'argent physiquement détenu par le chauffeur (« cash en main »), en attente de règlement à l'organisation ;
• le portefeuille organisation — alimenté lorsque les chauffeurs reversent les sommes encaissées ;
• le portefeuille plateforme (isPlatformWallet) — reçoit les commissions de Swaloo.

Un portefeuille chauffeur est créé automatiquement au premier encaissement si nécessaire.

Types et catégories de transaction

Chaque transaction est un crédit ou un débit et porte une catégorie précisant sa nature.

Type de transaction

Catégorie de transaction

Chaque transaction conserve le solde après opération (balanceAfter) et, le cas échéant, la tâche de livraison associée.

Ce qui se passe à la livraison

Lorsqu'une livraison avec contre-remboursement est confirmée, Swaloo enchaîne plusieurs opérations :

1. Encaissement COD → portefeuille chauffeur — le total à collecter (voir COD) est crédité au portefeuille du chauffeur, avec une transaction credit de catégorie cash_collection.
2. Rémunération du chauffeur — la part revenant au chauffeur (driverFee) est calculée et enregistrée sur la tâche. Le solde du portefeuille reste cependant égal au cash réellement détenu : la rémunération est suivie séparément et n'est pas débitée à ce stade.
3. Commission plateforme — pour une livraison réalisée par un chauffeur en mode freelance, la marge de Swaloo est créditée au portefeuille plateforme via une transaction credit de catégorie platform_commission.

Règlement (settlement)

Le règlement transfère tout ou partie du solde d'un portefeuille chauffeur vers le portefeuille de l'organisation :

• le portefeuille chauffeur est débité (catégorie settlement) ;
• le portefeuille organisation est crédité du même montant (catégorie settlement).

Le montant réglé peut être total (par défaut) ou partiel, mais ne peut jamais dépasser le solde disponible.

Réconciliation

La réconciliation aide l'administrateur d'organisation à solder les portefeuilles :

• elle liste les chauffeurs de l'organisation ayant un solde de portefeuille strictement positif, classés par solde décroissant ;
• elle permet de déclencher le règlement d'un portefeuille chauffeur vers l'organisation.