En-têtes
Corps de la requête
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
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êmeIdempotency-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
Un vendeur appartient à une seule marketplace, pour toujours
Un vendeur appartient à une seule marketplace, pour toujours
Le lien de contrôle est posé ici et il est immuable. Il n’existe ni déliaison, ni
transfert vers une autre marketplace.
Un vendeur ne peut pas connecter d'autres vendeurs
Un vendeur ne peut pas connecter d'autres vendeurs
La profondeur est limitée à 1.
La devise doit être celle de votre compte
La devise doit être celle de votre compte
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.