Présentation de la Marketplace

La plateforme de paiement propose des services de paiement pour des Marketplaces (places de marché), qui vendent des produits ou des services sur Internet pour le compte de vendeurs avec lesquels elles ont signé un accord commercial en ce sens.

Principe des flux bancaires :

Vocabulaire Description
Cash-in Paiement de l'acheteur à la Marketplace (CB, VISA...).
Cash-out Virement de la Marketplace vers les Sellers.

Les paiements des acheteurs sont ventilés vers les comptes de paiements des sellers. La plateforme de paiement déclenche ensuite des virements vers les comptes bancaires des Sellers de la Marketplace.

Principe de commission

La commission représente la part du montant de la commande qui revient à la Marketplace.

Remarque :

C'est sur cette commission qu'est déduite la part affectée à Lyra Collect. Par conséquent, la commission de la Marketplace doit permettre de couvrir les frais de Lyra Collect. Pour cette raison, le montant global des commissions comprises dans la commande est contrôlé avant le paiement de la commande.

Calcul de la commission minimale

Pour éviter de soulever une erreur lors contrôle de la commission, vous pouvez préalablement vérifier que le montant de la commission envoyé à l'API marketplace est supérieur ou égal à la commission minimale, dont la formule est donnée ci-dessous :

Symbole Définition Exemple 1 Exemple 2
Commin Commission minimale
a Coefficient de la commission au prorata 2% 1%
b Commission fixe par transaction 50 20
M Montant hors commission de la commande 10000 10000
n Nombre de transactions de la commande 1 3
tva Taux de TVA 20% 20%

Remarque :

  • a, b et tva sont paramétrés au niveau de l'API marketplace. Si vous ne les connaissez pas, renseignez-vous auprès de votre contact commercial.
  • De son côté, la marketplace qui transmet l'order à l'API marketplace maîtrise M et n.

La commission minimale s'obtient par la formule suivante :

Avec les montants donnés en exemple, on a donc une commission minimale à :

L'unité étant le centime, la commission minimale totale de la commande devra donc être au moins égale à 308 dans l’exemple 1, et de 195 dans l’exemple 2.

Méthodes d'envoi

Deux méthodes permettent de renseigner le montant de la commission :

  1. la commission est définie au niveau de la commande : le montant de la commission est indiqué à travers un item de type commission, marqué par l'attribut is_commission=true. Le seller de cet item doit être le seller Marketplace, c'est-à-dire celui dont l'attribut is_marketplace_seller vaut "true". Dans ce cas, le montant de la commission s'ajoute au montant des autres items.

    Exemple :
    "items": [{
    						"seller": "4d20a9d4-0526-4474-b452-e936dc25418d",
    						"reference": "produit_sous_marchand",
    						"description": "Produit",
    						"amount": 10000,
    						"quantity": 1
    						},
    						{
    						"seller": "72ccc2ff-b455-4653-847e-deb6fee99f8d",
    						"reference": "marketplace_commission",
    						"description": "Commission",
    						"amount": 1000,
    						"quantity": 1,
    						"is_commission": true
    						}]			

    Dans cet exemple, si la devise de la commande est EUR et qu'elle contient 2 items, dont 1 item de 100€, plus 1 item de 10€ de commission, alors le montant total de la commande est de 100 + 10 = 110€.

    Le seller recevra 100€ et la marketplace recevra 10€ (moins la part affectée à Lyra Collect).

  2. la commission est définie au niveau d'un item : le montant de la commission est indiqué en valorisant l'attribut commission_amount de l'item. Dans ce cas, le montant de la commission vient en déduction du montant associé à l'item.

    Exemple :

    {
    	"seller": "72ccc2ff-b455-4653-847e-deb6fee99f8d",
    	"reference": "abcdef",
    	"description": "Restaurant",
    	"amount": 10000,
    	"quantity": 1,
    	"commission_amount": 1000,
    	"is_commission": false
    }				

    Dans cet exemple, si la devise de la commande est EUR, l'item vaut 100€ et l'attribut commission_amount est renseigné à 10€, la Marketplace percevra 10€, et le marchand de l'item recevra 100 – 10 = 90€.

    Cette modalité est utile pour maîtriser la répartition des commissions entre les différents items (et donc entre les différents sellers).

Notes :

  • Il est possible de combiner les deux modes, c'est-à-dire de définir un commission_amount dans un ou plusieurs items, et d'ajouter un item de type commission. Dans ce cas, les commissions définies au niveau de la commande s'ajoutent aux commissions définies au niveau des items.
  • En revanche, il ne fait pas sens – et il n'est pas possible – de définir un commission_amount sur un item de type commission.
  • La valeur par défaut de l'attribut is_commission est "false". Il n'est donc pas nécessaire de l'indiquer pour les items non-commission.

Un exemple de création d'order est donné au chapitre Réaliser un paiement.