> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saspay.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Soumettre un dossier

> Ouvre ou renouvelle votre dossier KYC — repasse kyc_status à PENDING

<Warning>
  Dashboard uniquement — cet appel échoue avec `403 dashboard_only` via une clé API. Utilisez le jeton de session obtenu par connexion, voir [Créer un compte et obtenir une clé API](/account-setup).
</Warning>

<Note>
  `merchant` est requis dans le corps de la requête — toujours forcé à votre propre marchand.
</Note>

<Note>
  Soumettre un nouveau dossier repasse votre marchand en `kyc_status: PENDING`, même s'il était déjà `VERIFIED`. Votre accès API reste actif pendant la ré-instruction — `is_active` n'est pas affecté.
</Note>


## OpenAPI

````yaml api-reference/openapi.json POST /merchant-kyc/
openapi: 3.1.0
info:
  title: SasPay API
  description: >-
    API d'encaissement et de paiement mobile money/carte pour l'Afrique de
    l'Ouest et du Centre. Toutes les routes marchand nécessitent une clé API
    secrète (header Authorization: Bearer sk_...).
  version: 1.0.0
servers:
  - url: https://api.saspay.me/api/v1
security:
  - bearerAuth: []
paths:
  /merchant-kyc/:
    post:
      tags:
        - KYC
      summary: Soumettre un dossier KYC
      description: >-
        Repasse le marchand en kyc_status=PENDING, même s'il était déjà
        VERIFIED. `merchant` est requis même pour une clé API. Aucune validation
        croisée serveur ne rend les champs entreprise obligatoires pour un
        dossier BUSINESS.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - merchant
                - kyc_type
              properties:
                merchant:
                  type: string
                  format: uuid
                kyc_type:
                  type: string
                  enum:
                    - INDIVIDUAL
                    - BUSINESS
                first_name:
                  type: string
                last_name:
                  type: string
                date_of_birth:
                  type: string
                  format: date
                id_document_type:
                  type: string
                company_name:
                  type: string
                rccm_number:
                  type: string
                ifu_number:
                  type: string
            example:
              merchant: 8a2f3c10-9b4e-4a1d-8c3f-1e2d3c4b5a6f
              kyc_type: BUSINESS
              first_name: Awa
              last_name: Touré
              date_of_birth: '1990-04-12'
              id_document_type: ID_CARD
              company_name: Kolofa SARL
              rccm_number: BJ-COT-2023-B-1234
              ifu_number: '3202312345678'
      responses:
        '201':
          description: Dossier créé
          content:
            application/json:
              example:
                id: 5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f
                merchant: 8a2f3c10-9b4e-4a1d-8c3f-1e2d3c4b5a6f
                kyc_type: BUSINESS
                first_name: Awa
                last_name: Touré
                date_of_birth: '1990-04-12'
                id_document_type: ID_CARD
                company_name: Kolofa SARL
                rccm_number: BJ-COT-2023-B-1234
                ifu_number: '3202312345678'
                status: PENDING
                reviewed_by_admin: null
                review_note: ''
                reviewed_at: null
                documents: []
                created_at: '2026-08-10T09:00:00Z'
                updated_at: '2026-08-10T09:00:00Z'
        '400':
          description: merchant manquant ou invalide, ou kyc_type absent
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: sk_live_... / sk_test_...
      description: >-
        Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx
        (ou sk_test_xxx en environnement de test).

````