Skip to main content
Sur chaque encaissement Connect, le brut se partage entre trois parties : le vendeur, vous, et Yabetoo. Cette page décrit exactement ce que chacun reçoit, et pourquoi certaines commissions sont refusées.

​
Le barème Yabetoo

Deux lignes s’appliquent à un encaissement Connect. Elles sont distinctes et se cumulent. Sur 10 000 XAF de brut, Yabetoo perçoit donc 375 + 100 = 475 XAF.
Ce barème est négociable par organisation. N’écrivez jamais 4,5 % en dur dans votre code : lisez votre grille réelle avec GET /v1/commissions/types et POST /v1/commissions/calculate.
Le frais fixe rend le taux effectif dépendant du montant. Les 25 XAF ne se diluent pas :C’est ce que le vendeur subit. Cela ne change en revanche rien au refus décrit plus bas, qui est une comparaison de taux.

​
Déclarer votre commission

Vous déclarez votre commission à chaque encaissement, sur l’intention de paiement, sous la forme d’un taux.
Les deux champs vont ensemble ou aucun. N’en fournir qu’un rend 422 connect.incomplete_request.
application_fee_rate s’exprime en pourcentage : 5 signifie 5 %. 0.05 signifierait 0,05 %.
Pourquoi un taux et pas un montant. Le brut est converti dans la devise du pays choisi au moment de la confirmation : une intention de 100 EUR confirmée au Congo capture environ 65 000 XAF, alors qu’un montant fixe de 20 resterait 20. Le taux, lui, s’applique au brut réel.Si vous avez besoin d’un montant plat, calculez-le chez vous et exprimez-le en taux pour la vente concernée.
fee_payer ne se transmet pas. Il est lu sur la relation de contrôle, telle que vous l’avez fixée à l’activation. Le poster est refusé.

​
La forme taux répercute notre frais fixe (mode marketplace uniquement)

En mode controller, un taux de 5 % ne facture pas 5 % au vendeur : il facture 5 % + notre part fixe. Vous ne déclarez qu’un nombre : le fixe est le nôtre, répercuté automatiquement, pour que votre marge ne dépende pas du panier.
Votre marge vaut exactement 0,5 % × brut dans les deux cas : elle ne dépend plus du panier.
Dites-le à vos vendeurs. Sur une vente de 100 XAF, le vendeur reçoit 70, pas 95 : les 25 XAF de frais fixe sont à l’intérieur de ce que vous lui facturez. Annoncez « 5 % + 25 XAF », pas « 5 % ».

​
Les deux modes : fee_payer

Le mode décide qui supporte les frais Yabetoo. Il déplace la charge, il ne la supprime jamais : la surcharge Connect s’applique dans les deux modes.
Les frais Yabetoo sont prélevés sur votre commission. Le vendeur ne subit qu’un seul prélèvement : le vôtre.
Votre marge est le résidu. C’est pour cela qu’il existe un plancher, et que notre part fixe s’y répercute : votre commission finance nos frais.
Le même taux ne rapporte pas la même chose. Un contrôleur qui déclare 5 % sur une vente de 10 000 XAF garde 50 en mode marketplace (le résidu au-dessus des 475 de Yabetoo) et 500 en mode plateforme (sa marge entière). Un facteur dix. Et le vendeur reçoit 9 475 dans le premier cas contre 9 025 dans le second.

​
Tableau comparatif

Sur 10 000 XAF de brut, barème standard, avec application_fee_rate : Dans les trois cas la somme fait exactement 10 000 : Connect ne crée ni ne détruit d’argent.
Ligne « commission effectivement prélevée » : en mode controller, les 25 XAF de frais fixe sont ajoutés à votre taux (1 000 + 25) ; en mode account, ils ne le sont pas : le vendeur les paie déjà séparément, les répercuter les lui ferait payer deux fois.

​
Les refus, et comment les éviter

​
connect.application_fee_too_low (400)

​
controller uniquement
Votre commission doit dépasser (pas seulement couvrir) les frais Yabetoo. L’égalité est refusée : elle vous laisserait à zéro net, ce qui n’est pas une opération viable.
​
number
Le plancher de taux, en pourcentage. Sur le barème standard il vaut 4,5 % : le taux de collection (3,5 %) plus celui de Connect (1 %).Il est dit excluded parce que la borne est stricte : à 4,5 % pile, c’est encore refusé.
​
number
Le taux que vous avez envoyé.
Ce refus ne dépend pas du montant. Notre part fixe étant répercutée dans votre commission, elle apparaît des deux côtés de la comparaison et s’annule. La garde se réduit à :
Un taux au-dessus du plancher passe à tous les montants. Un taux égal ou inférieur est refusé à tous les montants. Vous ne verrez pas « quelques » captures échouer, vous les verrez toutes échouer.La remédiation est donc de revoir votre tarification, jamais la vente en cours.
En mode account, il n’y a aucun plancher : votre commission n’a rien à financer, elle peut être nulle. Ce refus ne s’y produit jamais.
La règle simple : déclarez un taux strictement supérieur au plancher de votre grille, et vous ne serez jamais refusé pour ce motif, quel que soit le montant de la vente.

​
connect.application_fee_too_high (400)

Votre commission dépasse le montant encaissé.

​
connect.vendor_net_not_positive (422)

Après tous les prélèvements, le vendeur recevrait zéro ou moins. Il n’y a rien à créditer.

​
connect.incomplete_request (422)

on_behalf_of et application_fee_rate doivent être fournis ensemble.

​
connect.fee_payer_unset (422)

Le compte connecté visé n’a pas de fee_payer exploitable. Activez Connect sur votre compte avant d’encaisser. Voir Activer Connect.

​
E_CONNECT_PRICING_UNAVAILABLE (503)

La grille de commission n’a pas pu être résolue. Connect échoue fermé : il ne facture jamais un tarif de repli. Réessayez ; si le refus persiste, contactez le support : une ligne de barème manque pour votre organisation.

​
Arrondis

Les montants sont calculés en décimal exact puis arrondis à deux décimales (HALF_UP pour les frais, ROUND_DOWN pour le montant capturé). Le résidu d’arrondi revient à Yabetoo : le vendeur et vous recevez des montants déterministes.
Le XAF n’a pas de sous-unité. Les montants qui quittent réellement le système vers l’opérateur sont entiers ; les fractions restent internes au grand livre.

​
Et le mode différé ?

Une allocation porte elle aussi la surcharge Connect de 1 %, calculée sur le montant alloué, pas sur le brut d’origine. Sans cela, « encaisser sans vendeur puis allouer » atteindrait le même résultat économique en payant 1 % de moins. Le fee_payer de la relation s’y applique de la même façon : en mode controller vous êtes débité de montant + 1 % et le vendeur reçoit montant ; en mode account le vendeur reçoit montant − 1 %.