Skip to main content
Un compte connecté représente un vendeur. Sa création lui donne son identité, son organisation et son portefeuille chez Yabetoo, mais pas encore le droit de recevoir de l’argent : il lui faut d’abord passer la vérification.

En-têtes

Idempotency-Key est obligatoire sur cette route, contrairement à la plupart des endpoints Yabetoo. La création d’un vendeur est irréversible : sans clé, un simple retry réseau créerait deux vendeurs permanents, et aucun endpoint ne permet de délier ou de fusionner.

Corps de la requête

email est obligatoire et doit être celui du vendeur, pas le vôtre. C’est le seul canal par lequel Yabetoo joint le vendeur, notamment pour le code de confirmation de ses retraits.
country et currency sont acceptés dans n’importe quelle casse ; l’API les rend normalisés en majuscules.
Le pays est un choix métier, pas une copie du vôtre. Il détermine le barème de conformité du dossier KYC de votre vendeur. Une marketplace congolaise peut connecter un vendeur d’un autre pays supporté.

Champs refusés

Trois champs sont explicitement rejetés en 422 (ils ne sont jamais ignorés en silence) : Si vous en envoyez plusieurs, ils sont tous nommés dans la même réponse : vous n’avez pas à corriger champ par champ.

Exemple

Réponse

201
status: "active" ne veut pas dire « prêt à encaisser ». À cet instant le vendeur n’a ni dossier KYC, ni destination de versement, ni portefeuille. Rien ne pourra sortir de son compte tant qu’il n’a pas terminé son onboarding. Ce champ dit seulement que le compte existe.
L’environment du vendeur est hérité de la clé utilisée : une sk_test_ ne peut produire qu’un vendeur de test. Il est ensuite impossible de viser un vendeur live avec une clé de test : la réponse est un 401.

Rejeu

Réutiliser la même Idempotency-Key rend le même 201 avec le même id, dans les 24 h (cache de réponse) comme au-delà (unicité en base). Vous ne créerez jamais deux vendeurs par accident. Une clé déjà en cours de traitement rend 409 E_IDEMPOTENCY_CONFLICT : réessayez après la fin du premier appel.

Erreurs

Contraintes du modèle

Le lien de contrôle est posé ici et il est immuable. Il n’existe ni déliaison, ni transfert vers une autre marketplace.
La profondeur est limitée à 1.
Le multi-devise n’est pas supporté : une allocation ou un split entre deux devises différentes est refusé en 422 E_CURRENCY_MISMATCH.

Ensuite

Onboarding et vérification

Envoyez au vendeur son lien de vérification.