Frais et tarification
Ce que Wajub facture sur un encaissement et un payout, et où retrouver ces frais.
Wajub prélève un pourcentage sur les deux mouvements, mais uniquement lorsqu'une opération réussit. Un paiement qui échoue ne coûte rien, tout comme un payout qui n'atteint jamais son destinataire.
Les frais Wajub ne comprennent aucune part fixe ni aucun minimum. Le taux dépend de votre plan. Le
calcul consiste en une simple multiplication, arrondie selon la précision de la devise. Pour XAF,
dont la précision est nulle, les frais correspondent à un nombre entier de francs.
Coût d'un encaissement
Le taux est lu dans votre plan pour chaque canal. Voici les taux configurés aujourd'hui.
| Plan | MTN et Orange Cameroun | Tous les autres canaux |
|---|---|---|
| Pay as you go | 2,0 % | 2,0 % |
| Growth | 1,7 % | 2,0 % |
| Scale | 1,5 % | 2,0 % |
| Enterprise | 1,2 % | 2,0 % |
La deuxième colonne n'est pas un arrondi de la première. Seuls cm.mtn et cm.orange bénéficient
d'un taux négocié. Tous les autres canaux, y compris Express Union et tous les pays hors Cameroun,
reviennent au taux par défaut de la plateforme, soit 2 %, quel que soit le prix de votre plan.
Il s'agit d'un manque dans la grille tarifaire, pas d'une règle. Renseignez-vous avant de calculer
vos marges sur un corridor autre que ces deux canaux.
Ces taux viennent de la plateforme, pas de cette page
Les taux ci-dessus correspondent à la configuration actuelle des plans, et non à un engagement commercial. Votre propre accord peut remplacer chacun d'eux. La Konsole affiche le taux réellement appliqué à votre compte.
Personne qui paie les frais
Par défaut, le marchand les paie. Le client est débité du montant, vous êtes crédité de ce même montant, puis les frais vous sont débités.
Le champ bearer de POST /payments permet de les transférer. Avec "bearer": "customer", le
payeur est débité du montant et des frais, tandis que vous recevez l'intégralité du montant demandé.
Les frais correspondent à la différence et ne passent jamais par votre solde.
Ce champ accepte uniquement merchant ou customer. Si vous l'omettez, sa valeur est merchant.
Solde duquel les frais sont prélevés
Les frais d'encaissement ne sont pas soustraits du crédit. Le paiement crédite intégralement votre solde, puis un débit séparé en retire les frais. Ce débit touche le même solde que celui crédité par le paiement.
Ce point est important, car un nouvel encaissement reste dans pending pendant sa période de
rétention. Ses frais sont aussi prélevés sur pending. Ils ne peuvent donc jamais rendre
available négatif pour un compte dont les fonds ne sont pas encore disponibles. La page
Solde détaille ces soldes et la période de rétention.
Coût d'un payout
Le taux fixe est de 1 % sur les quatre plans. Contrairement aux encaissements, aucun plan ne le réduit actuellement et aucun canal n'applique un taux différent.
Le moment du prélèvement peut surprendre. Les frais sont estimés et réservés avec le principal dès
la création du transfert. Envoyer 10 000 XAF rend donc immédiatement 10 100 XAF indisponibles. Les
frais ne sont réellement débités que lorsque le payout atteint succeeded.
| État final du payout | Frais |
|---|---|
succeeded | Débités, et la réservation est réglée |
failed | Jamais débités. Le principal et l'estimation reviennent dans available |
cancelled | Jamais débités, même libération |
Un payout avec votre propre prestataire n'entraîne aucuns frais Wajub
Le taux de 1 % s'applique aux payouts routés et financés par Wajub. Un payout qui passe par un prestataire que vous avez apporté ne touche pas le registre Wajub. Il ne réserve rien et n'est pas facturé ici. Ce prestataire vous facture directement selon ses propres conditions.
La sandbox facture 2 % sur les deux mouvements
La sandbox possède son propre taux fixe, différent du taux live. Un encaissement et un payout dans la sandbox sont tous deux facturés 2 %. Un payout sandbox coûte donc deux fois plus cher que le payout live qu'il est censé simuler.
Ne reproduisez pas les calculs de la sandbox en production
Les frais d'un payout sandbox sont aussi ajoutés au montant au lieu d'en être déduits. Ils ne sont pas rendus en cas d'échec du payout. Ces deux comportements diffèrent du mode live. Si vous développez le calcul du coût d'un payout, basez-vous sur les règles live et testez les montants séparément.
Retrouver des frais
Il n'existe aucun endpoint pour les frais. L'API ne permet ni de les lister, ni d'en récupérer un,
ni d'obtenir leur total. Les paiements et transferts ne possèdent pas non plus de champ fee.
La seule interface programmable est le webhook fee.charged, émis une fois pour chaque frais au
moment de son prélèvement.
Quatre caractéristiques de ce payload sont à connaître avant de l'utiliser.
idstringfacultatifpo_ et pay_.percentagenumberfacultatif1 signifie donc un pour cent, et non une fraction.applied_tostringfacultatiftransaction pour un encaissement, transfer pour un payout. Un encaissement n'est pas appelé paiement ici.fixed_amountnullfacultatifnull pour des frais Wajub. Seule la commission d'une plateforme peut contenir une part fixe, comme expliqué ci-dessous.Le quatrième point constitue un manque plutôt qu'une particularité. Il détermine votre méthode de rapprochement.
Les frais d'un payout n'indiquent pas le payout concerné
Lorsque les frais concernent un encaissement, l'événement contient un objet payment avec son
id. Pour un payout, il ne contient rien de similaire. Vous recevez un montant, une devise et
applied_to: "transfer", sans pouvoir les attribuer à un transfert à partir du seul événement.
Faites la correspondance entre le montant et l'horodatage dans vos propres enregistrements de
payouts, ou effectuez le rapprochement depuis la Konsole.
Les champs du registre ont disparu
Une ancienne version de la documentation recommandait de calculer les frais en soustrayant
ledger_balance_before de ledger_balance_after sur le transfert. Ces deux champs ont été retirés
de l'objet transfert dans la version 2026-09-01 de l'API. Il s'agissait d'instantanés internes
du registre qui n'auraient pas dû être publics. Seuls les clients ayant fixé une version antérieure
les reçoivent encore.
Ne calculez pas des frais par soustraction. Lisez fee.charged ou exportez-les depuis la Konsole.
Si vous êtes une plateforme
Le paiement d'un compte connecté peut comporter des frais supplémentaires totalement distincts :
votre propre commission, calculée selon la règle tarifaire Sync définie pour ce compte. Son type
est sync_fee, et non platform_fee. Il s'agit des seuls frais de la plateforme pouvant comprendre
à la fois un pourcentage et une part fixe.
Ils produisent deux événements au lieu d'un, afin que les deux parties voient le même mouvement.
| Événement | Destinataire | Signification |
|---|---|---|
fee.charged | Le compte connecté | Votre commission lui a été facturée |
fee.received | Vous | Vous l'avez gagnée, avec le champ account indiquant son origine |
Les propres frais platform_fee de Wajub s'ajoutent séparément. La page Sync explique les
règles tarifaires et la configuration d'un compte connecté.
Pages associées
- Solde et règlementsLes soldes entre lesquels les frais circulent et la période de rétention.
- TransfertsCe qu'un payout réserve à sa création et ce qui libère cette réservation.
- Catalogue des événementsLe catalogue complet, y compris les événements liés aux frais.
- SyncLes comptes connectés, les règles tarifaires et votre propre commission.