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

# Créer un sous-marchand

> Créer un nouveau sous-marchand pour personnaliser le nom affiché lors des paiements

# Créer un sous-marchand

Créez un sous-marchand pour afficher un nom commercial personnalisé au payeur lors des transactions.

## Endpoint

```bash theme={null}
POST /api/v1/sub-merchant
```

## Headers

| Nom           | Type   | Requis | Description           |
| ------------- | ------ | ------ | --------------------- |
| Authorization | string | Oui    | Bearer YOUR\_API\_KEY |
| Content-Type  | string | Oui    | application/json      |

## Corps de la Requête

```json theme={null}
{
  "name": "Ma Boutique",
  "commercialName": "Ma Boutique SN",
  "countries": ["SN", "CI"],
  "description": "Boutique en ligne",
  "legalName": "Ma Boutique SARL",
  "businessActivity": "E-commerce",
  "managerName": "John Doe",
  "websiteURL": "https://maboutique.com",
  "phoneNumber": "+221771234567",
  "city": "Dakar",
  "address": "123 Rue du Commerce",
  "zipcode": "12000"
}
```

### Paramètres

| Paramètre        | Type      | Requis | Description                                                             |
| ---------------- | --------- | ------ | ----------------------------------------------------------------------- |
| name             | string    | Oui    | Nom interne (visible uniquement dans votre dashboard)                   |
| commercialName   | string    | Oui    | Nom affiché au payeur sur l'écran de paiement                           |
| countries        | string\[] | Oui    | Pays où ce sous-marchand est actif : `SN`, `CI`, `CM`, `BJ`, `BF`, `GN` |
| description      | string    | Non    | Description libre                                                       |
| legalName        | string    | Non    | Raison sociale                                                          |
| businessActivity | string    | Non    | Activité commerciale                                                    |
| managerName      | string    | Non    | Nom du gérant                                                           |
| websiteURL       | string    | Non    | URL du site web                                                         |
| phoneNumber      | string    | Non    | Numéro de téléphone                                                     |
| city             | string    | Non    | Ville                                                                   |
| address          | string    | Non    | Adresse complète                                                        |
| zipcode          | string    | Non    | Code postal                                                             |

## Réponse Succès (201)

```json theme={null}
{
  "success": true,
  "message": "Sub-merchant created successfully",
  "data": {
    "subMerchantId": "sm-7f4a9940c621",
    "name": "Ma Boutique",
    "commercialName": "Ma Boutique SN",
    "countries": ["SN", "CI"],
    "isActive": true,
    "isDefault": false,
    "CREATED_AT": "2026-03-15T03:47:32.000Z"
  }
}
```

<Note>
  Le `subMerchantId` retourné est l'identifiant à utiliser dans vos transactions via le champ `sub_merchant_id`.
</Note>