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

# Utilisation dans les transactions

> Comment utiliser un sous-marchand lors d une transaction

# Utilisation dans les transactions

Ajoutez le champ `sub_merchant_id` dans vos requêtes de transaction pour afficher le nom de votre sous-marchand au payeur.

## Exemple

```json theme={null}
{
  "externalTransactionId": "ext-123",
  "serviceCode": "WAVE_SN_CASHOUT",
  "amount": 1000,
  "number": "771234567",
  "callBackURL": "https://example.com/callback",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/failure",
  "sub_merchant_id": "sm-7f4a9940c621"
}
```

## Sous-marchand par défaut

Vous pouvez définir un sous-marchand par défaut depuis votre dashboard. Si `sub_merchant_id` n'est pas passé dans la transaction, le sous-marchand par défaut sera utilisé automatiquement.

## Données dans la transaction

Quand un sous-marchand est utilisé, les champs suivants sont ajoutés à la transaction et inclus dans le callback webhook :

```json theme={null}
{
  "subMerchantId": "sm-7f4a9940c621",
  "subMerchantName": "Ma Boutique SN"
}
```

<Info>
  Le champ `sub_merchant_id` est entièrement **optionnel**. Les transactions sans sous-marchand continuent de fonctionner comme avant.
</Info>