Introduction

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

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	—

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.

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

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.

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.

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

Vue d'ensemble

Paiements

Retraits

Transactions

Liens de paiement

Wallet

Webhooks

Marchand

KYC

Clés API

Référence

Vue d’ensemble

Profil

Configuration

Suppression de compte

​Vue d’ensemble

​Profil

​Configuration

​Suppression de compte

Vue d’ensemble

Profil

Configuration

Suppression de compte