Les principaux objets et leurs relations
Ci-dessous un glossaire des principaux objets et une représentation simplifiée de leurs relations. En vert les objets associés à la phase d'encaissement et en bleu, les objets associés à la phase de décaissement :
| Nom commun | Désignation API | Description |
|---|---|---|
| vendeur | seller | Un vendeur peut proposer divers articles. En tant que vendeur, l'opérateur de la marketplace peut lui-même proposer de la vente en propre. |
| Articles | item | Il s'agit d'un article d'un vendeur dans une commande. Un article ne peut appartenir qu'à une seule commande. |
| Commande | order | La commande représente l'objet fondamental du flux d'affaires. A chaque commande correspond un seul acheteur. A contrario, chaque commande peut contenir plusieurs articles, eux-mêmes potentiellement en provenance de vendeurs différents. Et s'il n'y a qu'un seul paiement par commande, il peut y avoir plusieurs transactions, comme dans le cas du paiement fractionné ou du paiement en N fois. |
| Transaction | transaction | A la différence du paiement (qui représente une séquence d'authentification et de validation d'un paiement), une transaction représente un mouvement de fonds. Cette notion est particulièrement utile pour le paiement N fois (pour les marketplace exemptées) et pour le paiement en cascade, dans la mesure où chaque transaction est associée à un (et un seul) moyen de paiement, pour le paiement en cascade. Dans ces deux cas, une même commande sera associée à plusieurs transactions associées. |
| Transfert | transfer | Puisqu'il est possible d'avoir plusieurs articles et plusieurs transactions pour une même commande, il est utile de disposer d'un objet qui représente la part d'un seul article pour une seule transaction. Ainsi, à chaque transfert correspond une seule transaction et un seul article. Et son montant correspond, sauf effets d'arrondis, à la proportion que l'article représente dans le panier à l'échelle de la transaction. C'est un objet à usage essentiellement interne, mais partagé avec la marketplace pour d'éventuels besoins de suivi et de comptabilité. |
| Décaissement | cashout | Le "cashout" correspond à un virement vers le compte bancaire du vendeur. Il est donc associé à un seul vendeur, lequel peut par contre recevoir plusieurs décaissements. Son montant est la somme de tous les transferts liés aux articles du vendeur en question, moins les remboursements qui seraient intervenus entretemps. |
| Remboursement | refund | Un remboursement ressemble à une commande en sens inverse, sauf :
|