Cinématique du cashout

L'objet transfer fait la médiation entre la transaction et le cashout.

En effet, dans le cadre d'une Marketplace :
  • une transaction peut concerner plusieurs articles de plusieurs sous-vendeurs différents, pour un seul acheteur
  • et un cashout agrège plusieurs transactions de plusieurs commandes différentes, pour un seul vendeur.

Le transfer représente la part qu'un article occupe pour une seule transaction (sachant qu'une commande peut elle-même, être répartie en plusieurs transactions).

Il est entièrement géré par l'API Marketplace.

Par exemple, une Marketplace donne à M. Martin la possibilité de payer ses 3 articles ci-dessous en 3 fois. Les transferts représentent le corps du tableau, tandis que les marges en ligne représentent les articles, et les marges en colonne correspondent aux transactions.

Transactions Total Articles
1ére tranche 2ème tranche 3ème tranche
Articles Ordinateur 740,88 € 740,88 € 518,23 € 1 999,99 €
Grand écran 926,10 € 926,10 € 647,79 € 2 499,99 €
Barre de son 333,02 € 333,02 € 232,96 € 899,00 €
Total Transactions 2 000,00 € 2 000,00 € 1 398,98 € 5 398,98 €

Dans cette commande, 9 transferts sont donc générés, en utilisant une règle de répartition proportionnelle. Par exemple, le transfert correspondant au grand écran sur la première transaction est de 926,10€ (= 2000,00 x 2499,99 / 5398,98). Et si vous faites les calculs exacts, vous pourrez remarquer qu'un article (ici, la barre de son) et qu'une transaction (la dernière) sont utilisés pour rectifier l'arrondi au centime près.

Dans la cinématique globale de la Marketplace, le transfer est en quelques sortes la plus petite unité de décomposition d'une commande, et la clé de transformation des cash-in en cash-out. Étant à l'articulation des deux mouvements, il est généré dès que la transaction est identifiée comme étant remisée (c'est-à-dire passée au statut SUCCEEDED). Il prend alors le statut CREATED.

Une fois le cash-out remisé, celui-ci passe au statut SUCCEEDED. Ce statut est communiqué au transfer qui lui est associé, et qui passe lui aussi au statut SUCCEEDED.

REMARQUE

Par définition, les produits vendus en propre par l'opérateur de la Marketplace ne font pas l'objet de cashouts. Donc seuls les sous-marchands de la Marketplace sont concernés par les virements. Et par conséquent, les transferts en direction de la Marketplace (vente en propre et item commission) conservent le statut CREATED pendant toute leur durée de vie.