MobupayMobupay
Chargement de vos clés API…

Commissions à plusieurs niveaux

La commission que votre plateforme prélève sur chaque sous-marchand.

Les quatre niveaux

Une commission se fixe à quatre niveaux, du plus précis au plus général. Les deux premiers passent par l'API, dans la commande ; les deux derniers se règlent une fois pour toutes. Dans chaque entrée de order.platformConfig : la commission se fixe sous-marchand par sous-marchand.

  1. Par article : un montant seulement, items[].itemPlatformCommission.
  2. Par commande : une règle de calcul, platformCommission (un pourcentage ou un montant fixe que Mobupay applique), ou un montant fourni, orderPlatformCommission. Dans la règle, value s'exprime en centièmes de pour cent pour un pourcentage (1000 = 10 %), dans la plus petite unité de la devise pour un montant fixe.
  3. Par sous-marchand : La commission propre à un sous-marchand, réglée dans votre espace marchand, écran Partenaires, sans code.
  4. Par défaut : La commission de votre plateforme pour tous ses sous-marchands, réglée au même endroit, sans code.

Comment ils se combinent

  • Les articles qui portent leur propre montant sont isolés. Leur commission est la somme de leurs montants, et ils sortent de l'assiette du reste.
  • Le reste de la commande est couvert par le montant fourni par commande s'il est présent, sinon par la règle de calcul, appliquée au seul reste.
  • Montant fourni et règle ensemble : le montant l'emporte, sans erreur. La règle est ignorée.
  • La commission totale est la somme des articles isolés et de la commission du reste.
  • Dès que la commande porte une commission, à l'un ou l'autre des deux premiers niveaux, vos réglages (niveaux 3 et 4) ne s'appliquent pas. Sans aucune commission dans la commande, c'est le niveau 3, sinon le niveau 4.
Des montants par article sans règle ni montant de commande laissent le reste de la commande sans commission : vos réglages ne le couvrent pas. Ajoutez une règle ou un montant de commande pour le reste.

Un exemple

Une commande de 10 000 XPF : un menu à 4 000 XPF qui porte sa commission de 300 XPF, et des boissons à 6 000 XPF. La règle demande 10 %.

"platformConfig": [
  {
    "merchantId": "mer_…",
    "amount": 10000,
    "items": [
      { "product": "Menu du jour", "unitPrice": 4000, "quantity": 1,
        "itemPlatformCommission": { "commissionAmount": 300 } },
      { "product": "Boissons", "unitPrice": 6000, "quantity": 1 }
    ],
    "platformCommission": { "type": "PERCENTAGE", "value": 1000 }
  }
]
  • Le menu est isolé : 300 XPF.
  • La règle s'applique au reste, les boissons : 10 % de 6 000 XPF, soit 600 XPF.
  • Commission totale : 900 XPF.
  • Avec en plus un montant fourni par commande de 500 XPF, la règle serait ignorée : 300 + 500, soit 800 XPF.
  • Sans aucune commission dans la commande, vos réglages s'appliqueraient à la commande entière.

À savoir

  • La commission d'un sous-marchand ne dépasse jamais sa part : à la création, la somme des montants fournis (articles et commande) au-delà de la part est refusée (400 PLATFORM_COMMISSION_EXCEEDS_SHARE), et à l'encaissement, tout excédent est ramené à la part.
  • Une entrée qui désigne votre plateforme elle-même (isPlatform) ne porte aucune commission.
  • Les montants s'expriment dans la devise de la commande, taxe comprise (taxAmount est la part de taxe comprise dans commissionAmount).

Pour aller plus loin