MobupayMobupay
Chargement de vos clés API…

Commissions à plusieurs niveaux

La commission que votre logiciel prélève sur les paiements de ses clients.

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 la commande d'un paiement émis avec la clé que vous détenez pour votre client, à côté de order.platformConfig, jamais dedans.

  1. Par article : un montant seulement, order.items[].itemIntegratorCommission.
  2. Par commande : une règle de calcul, order.integratorCommission (un pourcentage ou un montant fixe que Mobupay applique), ou un montant fourni, order.orderIntegratorCommission. 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 client : La commission propre à un client, réglée une fois pour toutes, sans code : espace marchand, page Intégrateur, Clients, action « Régler la commission » sur la ligne du client.
  4. Par défaut : Votre commission pour tous vos clients, réglée une fois pour toutes, sans code : même page, bouton « Commission par défaut » en haut à droite.

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 %.

"order": {
  "reference": "CMD-1042",
  "amount": 10000,
  "currency": "XPF",
  "items": [
    { "product": "Menu du jour", "unitPrice": 4000, "quantity": 1,
      "itemIntegratorCommission": { "commissionAmount": 300 } },
    { "product": "Boissons", "unitPrice": 6000, "quantity": 1 }
  ],
  "integratorCommission": { "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

  • Vous fixez librement votre commission : Mobupay n'impose ni minimum ni maximum. La somme des montants fournis (articles et commande) ne dépasse pas le montant de la commande (422 INTEGRATOR_COMMISSION_INVALID sinon).
  • Ces champs ne sont acceptés que sur un paiement émis avec la clé que vous détenez pour ce client (422 INTEGRATOR_COMMISSION_NOT_ALLOWED sinon).
  • Un montant par article n'est pas accepté sur une commande répartie entre sous-marchands, quand votre client est une plateforme (400 INTEGRATOR_ITEM_COMMISSION_NOT_SUPPORTED) : employez le montant de commande ou la règle.
  • Votre commission est servie la dernière, sans jamais dépasser ce qui reste du paiement ; le reste dû est repris sur les encaissements suivants.
  • Les montants s'expriment dans la devise de la commande, taxe comprise (taxAmount est la part de taxe comprise dans commissionAmount).
  • Les frais Mobupay du paiement sont payés par défaut par votre client. Si votre boutique intégrateur est réglée pour les payer, votre logiciel les prend à sa charge, calculés sur sa grille et prélevés après votre commission : voir « Qui paie les frais Mobupay » dans le guide du mode intégrateur.

Pour aller plus loin