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

# Introduction

> Gérez le profil de votre compte marchand, sa configuration de frais, et sa suppression éventuelle.

## Vue d'ensemble

Votre compte **marchand** (`Merchant`) est l'entité business rattachée à votre clé API — c'est elle qui porte votre statut KYC, votre solde, et vos réglages de frais. Une clé API n'agit jamais que pour son propre marchand ; un compte dashboard peut en revanche posséder plusieurs marchands (plusieurs boutiques), sélectionnées via le header `X-Merchant-Id`.

```
Votre marchand (Merchant)
│
├── Profil ── name, support_email, support_phone, website_url, category
│   └── is_active / kyc_status ── lecture seule, pilotés par le KYC (ou une action admin)
│
├── Configuration (merchant-configs) ── 3 clés self-service
│   ├── DEFAULT_FEE_CHARGE_MODE      ── mode de frais par défaut, encaissement
│   ├── DEFAULT_FEE_CHARGE_MODE_OUT  ── mode de frais par défaut, retrait
│   └── ALLOW_CLIENT_OVERRIDE        ── le client final peut-il changer le mode par transaction
│
└── Suppression de compte ── demande → décision admin (pas de DELETE direct)
    ├── PENDING → APPROVED   (compte réellement supprimé)
    ├── PENDING → REJECTED   (compte reste actif)
    └── PENDING → CANCELLED  (retirée par vous)
```

## Profil

* [Lister vos marchands](/api-reference/merchant/list)
* [Détail de votre profil](/api-reference/merchant/get)
* [Modifier votre profil](/api-reference/merchant/update)

| Champ                       | Type     | Modifiable          | Description                                                                                                                  |
| --------------------------- | -------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `id`                        | uuid     | non                 | Identifiant du marchand                                                                                                      |
| `owner_user`                | uuid     | non                 | Compte dashboard propriétaire                                                                                                |
| `name`                      | string   | oui                 | Nom commercial                                                                                                               |
| `support_email`             | string   | oui                 | Contact affiché à vos clients finaux (facture, confirmation de paiement)                                                     |
| `support_phone`             | string   | oui                 | Idem, téléphone                                                                                                              |
| `website_url`               | string   | oui                 | URL de votre site                                                                                                            |
| `category`                  | string   | oui                 | Catégorie d'activité, texte libre                                                                                            |
| `is_active`                 | boolean  | non                 | Accès API/dashboard actif. `false` par défaut, ne bascule à `true` qu'à l'approbation de votre KYC (ou une suspension admin) |
| `kyc_status`                | string   | non                 | `NONE` \| `PENDING` \| `VERIFIED` \| `REJECTED`                                                                              |
| `configs`                   | array    | non (lecture seule) | Vos réglages `merchant-configs` actuels, imbriqués — voir ci-dessous                                                         |
| `created_at` / `updated_at` | datetime | non                 | —                                                                                                                            |

<Note>
  `GET /merchants/` ne renvoie jamais qu'un seul résultat (le vôtre) pour une clé API — c'est normal, pas un bug : une clé API ne voit jamais que son propre marchand.
</Note>

## Configuration

Trois réglages de frais sont pilotables en self-service via `merchant-configs`. Les autres clés existantes (`PAYOUT_ENABLED`, `CUSTOM_PRICING_ENABLED`, `WALLET_TRANSFER_AUTO_APPROVE`...) sont admin-only et rejetées (`403`) si vous tentez de les manipuler ici.

| Clé                           | Type    | Défaut   | Description                                                         |
| ----------------------------- | ------- | -------- | ------------------------------------------------------------------- |
| `DEFAULT_FEE_CHARGE_MODE`     | enum    | `ADD_ON` | Mode de frais par défaut pour les paiements entrants (encaissement) |
| `DEFAULT_FEE_CHARGE_MODE_OUT` | enum    | `ADD_ON` | Mode de frais par défaut pour les paiements sortants (retraits)     |
| `ALLOW_CLIENT_OVERRIDE`       | boolean | `false`  | Autorise le client final à changer le mode de frais par transaction |

Les deux clés de mode acceptent l'une des deux valeurs suivantes :

| Valeur     | Effet                                                                 |
| ---------- | --------------------------------------------------------------------- |
| `ADD_ON`   | Le bénéficiaire reçoit le montant plein, les frais s'ajoutent en plus |
| `DEDUCTED` | Les frais sont défalqués du montant                                   |

* [Lister vos réglages](/api-reference/merchant/configs-list)
* [Définir un réglage](/api-reference/merchant/configs-create)
* [Détail d'un réglage](/api-reference/merchant/config-get)
* [Modifier un réglage](/api-reference/merchant/config-update)
* [Supprimer un réglage](/api-reference/merchant/config-delete)

<Warning>
  La contrainte d'unicité (une seule ligne par clé et par marchand) n'est pas gérée proprement côté serveur : reposter une clé déjà existante renvoie une erreur serveur générique au lieu d'un message clair. Ne repostez jamais une clé existante — récupérez-la d'abord via `GET`, puis modifiez-la avec `PATCH`.
</Warning>

## Suppression de compte

Il n'existe **pas de `DELETE` direct** sur votre profil marchand. Toute suppression passe par une demande, examinée par un administrateur SasPay qui l'approuve (le compte est alors réellement supprimé) ou la rejette (le compte reste actif, avec un motif). C'est le même principe que la vérification KYC : soumission puis décision humaine, jamais une action instantanée.

* [Soumettre une demande de suppression](/api-reference/merchant/deletion-request-create)
* [Historique de vos demandes](/api-reference/merchant/deletion-requests-list)
* [Détail d'une demande](/api-reference/merchant/deletion-request-get)
* [Retirer une demande](/api-reference/merchant/deletion-request-cancel)

Vous recevez un email de confirmation à la soumission, puis un second dès qu'une décision est prise. Une seule demande `PENDING` est autorisée à la fois par marchand : en soumettre une seconde renvoie `409 Conflict`.

```
PENDING ──approve (admin)──> APPROVED  (compte supprimé)
   │
   ├──reject (admin)───────> REJECTED  (compte reste actif, review_note renseigné)
   │
   └──cancel (vous)────────> CANCELLED
```