> ## 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 une demande de suppression

> Seul chemin vers la suppression d'un compte marchand — décidée ensuite par un admin

<Note>
  `merchant` est optionnel dans le corps de la requête — comme sur les autres endpoints self-service, sa valeur est forcée à votre propre marchand pour une clé API. Pour un compte dashboard possédant plusieurs marchands, précisez `merchant` (ou le header `X-Merchant-Id`) pour indiquer lequel est concerné.
</Note>

<Warning>
  Une seule demande `PENDING` à la fois par marchand — en soumettre une seconde renvoie `409 Conflict` : `{"message": "Une demande de suppression est déjà en attente pour ce marchand.", "code": "already_pending"}`.
</Warning>


## OpenAPI

````yaml api-reference/openapi.json POST /merchant-deletion-requests/
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-deletion-requests/:
    post:
      tags:
        - Marchand
      summary: Soumettre une demande de suppression
      description: >-
        Seul chemin vers la suppression d'un compte marchand — la suppression
        réelle n'intervient qu'à l'approbation d'un administrateur. `merchant`
        est requis même pour une clé API (sa valeur est alors forcée à votre
        propre marchand quel que soit l'id envoyé).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - merchant
              properties:
                merchant:
                  type: string
                  format: uuid
                reason:
                  type: string
            example:
              merchant: 8a2f3c10-9b4e-4a1d-8c3f-1e2d3c4b5a6f
              reason: Fermeture de notre activité e-commerce
      responses:
        '201':
          description: Demande créée
          content:
            application/json:
              example:
                id: d4e5f6a7-2b3c-4d5e-8f9a-0b1c2d3e4f5a
                merchant: 8a2f3c10-9b4e-4a1d-8c3f-1e2d3c4b5a6f
                requested_by_member: aa11bb22-3c4d-4e5f-8a9b-0c1d2e3f4a5b
                reason: Fermeture de notre activité e-commerce
                status: PENDING
                reviewed_by_admin: null
                review_note: ''
                reviewed_at: null
                created_at: '2026-08-12T11:00:00Z'
                updated_at: '2026-08-12T11:00:00Z'
        '409':
          description: Une demande PENDING existe déjà pour ce marchand
          content:
            application/json:
              example:
                message: >-
                  Une demande de suppression est déjà en attente pour ce
                  marchand.
                code: already_pending
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).

````