Skip to main content
Un vendeur qui vient d’être créé ne peut rien recevoir. Il lui faut d’abord ouvrir son dossier de vérification, y déposer ses pièces et sa destination de versement. Yabetoo héberge ce parcours. Vous générez un lien, vous le transmettez au vendeur, il le complète.

Générer un lien d’onboarding

Le corps de la requête est vide.
201
Pas d’Idempotency-Key sur cette route, contrairement à la création de vendeur. L’appel reprend une session en cours au lieu d’en ouvrir une seconde : vous pouvez le rejouer autant de fois que nécessaire pour régénérer le lien d’un vendeur qui a perdu le sien.

Champs refusés

Ce que le vendeur y fait

1

Il ouvre le lien

La page est hébergée par Yabetoo (verify.yabetoo.com). Vous pouvez l’ouvrir dans un onglet, l’envoyer par e-mail, ou l’intégrer en iframe.
2

Il dépose ses pièces

Pièce d’identité et selfie pour le niveau 1. Justificatif d’adresse ou registre de commerce pour le niveau 2, qui relève les plafonds.
3

Il enregistre sa destination de versement

C’est sa destination de versement. C’est le vendeur qui la dépose, pas vous, et c’est pour cela que phone est refusé à la création du compte.
4

Yabetoo instruit le dossier

Vérification automatique quand elle est possible, revue humaine sinon.
Il n’y a pas de return_url. Connect v1 n’expose aucun paramètre de redirection : le vendeur termine sur une page Yabetoo. Si vous chargez le lien en iframe, la fin de parcours vous est notifiée par postMessage. Sinon, suivez l’avancement par les webhooks ou en interrogeant le compte.

Pendant la vérification

C’est délibéré : votre vendeur peut vendre dès le premier jour, mais l’argent ne quitte pas le système tant que son identité n’est pas établie.
Conséquence à connaître. Un vendeur peut accumuler des fonds puis voir son dossier refusé. Ses fonds sont alors remboursés aux acheteurs, charge par charge. Ne promettez pas à un vendeur non vérifié que son solde lui est acquis.

Suivre l’avancement

Lisez la conformité du vendeur : l’état de son dossier et ce qu’il est autorisé à faire.
200
  • verification.status suit le dossier : null tant que le vendeur n’a pas ouvert le lien, puis createddocuments_submittedin_reviewapproved (ou rejected, needs_info).
  • capabilities.allowed_operations dit ce que le vendeur peut faire : withdraw n’y apparaît qu’une fois le dossier approuvé.
Le status de GET /v1/connect/accounts/{acct} est celui du compte (active dès la création), pas celui du dossier. Pour savoir si un vendeur est vérifié, lisez compliance.
Aucun webhook n’est émis au changement d’état du dossier : interrogez cet endpoint quand vous en avez besoin. Détail des champs : référence API.

Erreurs

Les codes 403 ne distinguent jamais « ce vendeur n’existe pas » de « ce vendeur n’est pas le vôtre ». C’est voulu : sinon l’API deviendrait un moyen de tester l’existence des comptes d’autrui.