Prélèvement au fil de l'eau : fonctionnement de la commission minimale

Il est facile de vérifier que le montant de la part marketplace est bien supérieur au montant minimal attendu :

Exemple de d'implémentation de contrôle de montant minimum en PHP

function checkCommission($order, $commissionRatio, $commissionFix, $tvaRatio): bool
{
    $commission = getTotalCommissionAmount($order);
    $min = getMinimumAllowedCommission($order, $commissionRatio, $commissionFix, $tvaRatio);
    return  $commission >= $min;
}
/**
 * Returns the total commodity amount of the order (i.e. net commission).
 */
function getTotalCommodityAmount($order): float
{
    $totalCommodity = 0;
    foreach($order->items as $item)
    {
        if (!isset($item->is_commission))
        {
            $itemCommodityAmount = $item->amount;
            if (isset($item->commission_amount))
            {
                $itemCommodityAmount -= $item->commission_amount;
            }
            $totalCommodity += $itemCommodityAmount;
        }
    }
    return $totalCommodity;
}
/**
 * Returns the total commission amount of the order.
 */
function getTotalCommissionAmount($order): float
{
    $totalCommission = 0;
    foreach($order->items as $item) {
        if($item->is_commission ?? false) {
            $totalCommission += $item->amount;
        }  elseif($item->commission_amount ?? false) {
            $totalCommission += $item->commission_amount;
        }
    }
    return $totalCommission;
}
function getOrderTotalAmount($order): float
{
    return getTotalCommodityAmount($order) + getTotalCommissionAmount($order);
}
function getMinimumAllowedCommission($order, $commissionRatio, $commissionFix, $tvaRatio): float
{
    $totalAmount = getOrderTotalAmount($order);
    $nbTransactions = getTransactionNbFromPaymentConfig($order->payment_config ?? 'SINGLE');
    return round(
        ceil(($commissionRatio * $totalAmount + $nbTransactions * $commissionFix) * (1 + $tvaRatio) * 100) / 100, 2
    );
}
function getTransactionNbFromPaymentConfig($paymentConfig): int {
    if($paymentConfig === 'SINGLE') return 1;
    try {
        $configArray = explode(":", $paymentConfig);
        $config = $configArray[0];
        $values = $configArray[1];
        if ($config === 'MULTI_EXT') {
            $transactions = explode(";", $values);
            return count($transactions);
        }
        if ($config === 'MULTI') {
            $params = explode(";", $values);
            foreach ($params as $param) {
                $args = explode("=", $param);
                if ($args[0] === 'count') {
                    return intval($args[1]);
                }
            }
            throw new Exception("Missing 'count' param in paymentConfig $paymentConfig", 500);
        }
        throw new Exception("paymentConfig should be one of SINGLE, MULTI or MULTI_EXT. Found $paymentConfig.", 500);
    } catch (Exception $e) {
        throw new Exception("Error when trying the evaluate the payment config setting.
        Please check the paymentConfig $paymentConfig against the Marketplace API documentation.", 500);
    }
}

Mais si la part minimale n'est pas satisfaite, il est un peu moins trivial de la déterminer à partir du montant de la commande hors commission et vente en propre, c'est-à-dire à partir du montant net sous-vendeurs.

Mathématiquement, cela correspond à cette formule :

Avec les valeurs suivantes :

Symbole	Définition	Exemple 1	Exemple 2
a	Coefficient de la part minimale au prorata du montant total de la commande	2%	1%
b	frais fixe par transaction	0,50€	0,20€
M	Montant net sous-vendeur (i.e. hors commissions et ventes en propre)	100€	100€
n	Nombre de transactions de la commande	1	3
tva	Taux de TVA	20%	20%
	Développement du calcul
Partmin	Part minimale	= 307,37 arrondi à 308, i.e. 3,08€	= 194.33 arrondi à 195, i.e. 1,95€

Exemple d'implémentation du calcul de la part minimale en PHP

function computeMinimimumCommissionAmount($order, $commissionRatio, $commissionFix, $tvaRatio): float
{
    $commodityAmount = getTotalCommodityAmount($order);
    $nbTransactions = getTransactionNbFromPaymentConfig($order->payment_config ?? 'SINGLE');
    return round(
        ceil(
        ($commissionRatio * $commodityAmount + $nbTransactions * $commissionFix) / (
            (1 / (1 + $tvaRatio)) - $commissionRatio)
        * 100) / 100, 2
    );
}