> ## 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.

# Attacher un document au dossier

> Étape 2/2 — rattache l'URL obtenue à l'upload au dossier, avec son type

<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>


## OpenAPI

````yaml api-reference/openapi.json POST /merchant-kyc/{kyc_id}/documents/
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/{kyc_id}/documents/:
    post:
      tags:
        - KYC
      summary: Attacher un document au dossier
      description: >-
        Étape 2/2 — rattache l'URL obtenue via l'upload à ce dossier, avec son
        type.
      parameters:
        - name: kyc_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Identifiant du dossier KYC
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - document_type
                - file_url
              properties:
                document_type:
                  type: string
                  enum:
                    - ID_CARD
                    - PASSPORT
                    - SELFIE
                    - BUSINESS_REGISTRATION
                    - FISCAL
                    - OTHER
                label:
                  type: string
                file_url:
                  type: string
                  format: uri
            example:
              document_type: ID_CARD
              label: Recto CNI
              file_url: >-
                https://cdn.saspay.me/kyc/8f2c1e9a-6b4d-4a3f-9c1e-2b3d4e5f6a7b.jpg
      responses:
        '201':
          description: Document attaché
          content:
            application/json:
              example:
                id: 1a2b3c4d-5e6f-4708-9a0b-1c2d3e4f5a6b
                merchant_kyc: 5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f
                document_type: ID_CARD
                label: Recto CNI
                file_url: >-
                  https://cdn.saspay.me/kyc/8f2c1e9a-6b4d-4a3f-9c1e-2b3d4e5f6a7b.jpg
                created_at: '2026-08-10T09:05:00Z'
        '404':
          description: Dossier KYC introuvable, ou n'appartenant pas à votre marchand
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).

````