Skip to main content
Yabetoo Connect permet à une marketplace d’encaisser des paiements au nom de vendeurs qu’elle a connectés, de prélever sa commission au passage, et de reverser aux vendeurs sur leur destination de versement. Vous gardez une seule intégration, une seule clé API et un seul flux de trésorerie. Yabetoo tient le grand livre de chaque vendeur.
Environnements. Connect s’utilise sur les mêmes hôtes que le reste de l’API Yabetoo : https://pay.sandbox.yabetoopay.com avec une clé sk_test_, et https://pay.api.yabetoopay.com avec une clé sk_live_. Les deux servent les mêmes endpoints.

​
Les trois acteurs

Connect met en relation trois parties. Le vocabulaire est fixe dans toute la documentation et dans l’API. Le confondre est la première source d’erreur d’intégration.

​
Comment l’argent circule

L’argent atterrit toujours sur l’identité opérateur de Yabetoo, puis Connect le découpe au grand livre. Il n’y a aucun routage vers un compte opérateur tiers : le partage est scriptural, donc atomique.
1

Vous créez un vendeur

Un appel API crée son compte, son organisation et son portefeuille. Voir Créer un compte connecté.
2

Le vendeur passe la vérification

Vous lui envoyez un lien d’onboarding hébergé par Yabetoo. Il y dépose ses pièces d’identité et sa destination de versement. Voir Onboarding et vérification.
3

Vous encaissez

Soit vous nommez le vendeur au moment de la capture et le partage est fait immédiatement (mode direct), soit vous encaissez sur votre propre compte et vous répartissez plus tard (mode différé).
4

Les fonds mûrissent

Tout crédit vendeur arrive en solde en attente et devient disponible après un délai configurable. Voir Soldes et disponibilité.
5

Vous payez le vendeur

Vous commandez le retrait de son solde disponible vers sa destination de versement, à la demande ou selon une cadence automatique.

​
Les deux modes de commission

Connect porte deux configurations économiques, choisies une fois pour toutes à l’activation de votre compte. C’est le réglage fee_payer, et il décide qui supporte les commissions Yabetoo.

Mode marketplace

fee_payer = controllerVous prélevez une commission sur la vente, et les frais Yabetoo sortent de votre commission. Le vendeur ne voit qu’un seul prélèvement : le vôtre.

Mode plateforme

fee_payer = accountLe vendeur est facturé par Yabetoo comme un marchand ordinaire, et votre commission s’y ajoute. Vous encaissez votre commission en entier.
Le même taux ne rapporte pas la même chose dans les deux modes. Un contrôleur qui déclare 5 % garde 50 sur une vente de 10 000 XAF en mode marketplace, et 500 en mode plateforme. Lisez Commissions et tarification avant de choisir.

​
Ce que Connect fait, et ne fait pas

Le lien de contrôle est posé à la création et il est immuable. Il n’existe aucun endpoint pour délier un vendeur, ni pour le transférer à une autre marketplace. Le multi-rattachement n’est pas supporté.
La profondeur de contrôle est limitée à 1. Un compte connecté ne peut pas devenir marketplace.
On ne peut pas débiter a posteriori le portefeuille d’un vendeur. Yabetoo n’avance donc jamais de fonds : un remboursement qui n’est pas couvert par les soldes disponibles est refusé, il ne crée pas de dette. Voir Remboursements.
Un vendeur est créé dans la devise de sa marketplace. Le multi-devise n’est pas supporté en v1 : une devise différente est refusée à la création.
Par défaut un compte connecté n’a ni login, ni clé API, ni dashboard. Il dépose ses pièces via le lien d’onboarding, et c’est vous qui commandez ses retraits.

​
Prochaine étape

Démarrage rapide

Un parcours complet, de l’activation au premier reversement.

Activer Connect

Choisir votre mode et activer Connect sur votre compte.