Créer un sous-marchand
Créez un sous-marchand pour afficher un nom commercial personnalisé au payeur lors des transactions.
Endpoint
POST /api/v1/sub-merchant
| Nom | Type | Requis | Description |
|---|
| Authorization | string | Oui | Bearer YOUR_API_KEY |
| Content-Type | string | Oui | application/json |
Corps de la Requête
{
"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)
{
"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"
}
}
Le subMerchantId retourné est l’identifiant à utiliser dans vos transactions via le champ sub_merchant_id.
