Skip to main content

​
Vue d’ensemble

Le KYC (Know Your Customer) est le dossier d’identité de votre marchand — c’est son approbation qui fait passer kyc_status à VERIFIED et active réellement votre compte (is_active: true). Un dossier appartient toujours à UN marchand précis : deux marchands possédés par le même compte dashboard ont chacun leur propre dossier.
Tout ce groupe est dashboard uniquement en écriture. Soumettre un dossier, y attacher un document ou uploader un fichier ne fonctionne jamais avec une clé API (Authorization: Bearer sk_...) — utilisez le jeton de session obtenu par connexion, voir Créer un compte et obtenir une clé API. Une tentative via clé API renvoie 403 dashboard_only. La lecture (historique, détail) reste, elle, accessible via clé API.
Aucune validation croisée n’est faite côté serveur entre kyc_type et les champs remplis : soumettre un dossier BUSINESS sans company_name/rccm_number/ifu_number est accepté (tous ces champs sont optionnels au niveau API). C’est votre formulaire qui doit imposer ce qui est pertinent selon kyc_type.
Soumettre un nouveau dossier repasse votre marchand en kyc_status: PENDING, même s’il était déjà VERIFIED — pratique pour mettre à jour vos informations (changement de représentant légal, nouveau document…). Votre accès API reste actif pendant la ré-instruction : is_active n’est pas affecté par une nouvelle soumission.

​
Soumettre un dossier

Champs en plus, renvoyés en lecture seule : id, status, reviewed_by_admin, review_note, reviewed_at, documents (vide à la création), created_at, updated_at. Il n’y a pas de PATCH/DELETE sur un dossier — il n’évolue que par l’ajout de documents ou une nouvelle soumission.

​
Documents

Rattacher une pièce justificative se fait en deux appels distincts, tous deux dashboard uniquement :
  1. Upload du binaire — POST /merchant-kyc/upload/, multipart/form-data. Renvoie une URL absolue.
  2. Attachement au dossier — POST /merchant-kyc/{kyc_id}/documents/ avec cette URL et un document_type.
Exemple de flux complet, pour attacher un recto de carte d’identité à un dossier existant (jeton de session, pas une clé API) :
Types de documents acceptés (document_type) : ID_CARD, PASSPORT, SELFIE, BUSINESS_REGISTRATION, FISCAL, OTHER. label sert surtout à préciser OTHER.
Sur un dossier n’appartenant pas à votre marchand, GET /merchant-kyc/{kyc_id}/documents/ renvoie 200 avec une liste vide, plutôt qu’un 404 (contrairement au POST sur ce même chemin, qui lui renvoie bien 404). Ne vous fiez donc pas à une liste vide pour conclure qu’un dossier n’existe pas.
Types de fichiers acceptés à l’upload : image/jpeg, image/png, image/webp, application/pdf — 10 Mo maximum.