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

# Intégration

> Apprenez comment créer des sous marchands depuis notre API

## Intégration API

La fonctionnalité  **Sous-marchand** utilise des endpoints de l'API HUB2.
Les endpoints disponibles sont listés dans la documentation suivante :

<Card title="API Sous-marchand" icon="link" href="https://api.hub2.io/docs#/Submerchants" arrow="true" cta="Accéder à la documentation de l'API Sous-marchand" />

## Authentification

Votre intégration utilise les mêmes clés API HUB2 pour l'authentification mais la clé doit avoir des permissions de création de paiement :

* `Api.payment_create`
* `Api.payment_intent_create`
* `Api.payment_intent_read`
* `Api.payment_intent_auth_create`
* `Api.payment_fees_read`

## Endpoints API

L'API Sous-marchands utilise des endpoints de création et de lecture similaires aux endpoints classiques

### Sous-marchands

* `POST /submerchants/` - Créer un sous-marchand.
  Voici un exemple.

<CodeGroup>
  ```bash Curl {1} theme={null}
  curl --location 'https://api.hub2.io/submerchants' \
  --header 'ApiKey: [REDACTED]' \
  --header 'MerchantId: [REDACTED]' \
  --header 'Environment: live' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "EM_TEST_01",
    "description": "Submerchant created for testing purposes",
    "address": "RIVIERA BEVERLY HILLS",
    "zipcode": "00225",
    "city": "ABIDJAN",
    "phoneNumber": "+2250707070707"
  }'
  ```
</CodeGroup>

* `PATCH /submerchants/{submerchantId}/` - Mettre à jour un sous-marchand
* `GET /submerchants` - Lister les sous-marchands créés
* `GET /submerchants/{id}` - Récupérer un sous-marchand spécifique

## Webhooks

Votre intégration utilise les mêmes webhooks que les endpoints de paiement et de transferts.
Si vous avez déjà configuré des webhooks pour les paiements, aucune étape supplémentaire n'est requise. Sinon, consultez :

<Card title="Guide d'intégration des Webhooks" icon="link" href="https://docs.hub2.io/integration/fr/webhooks/webhooks_overview" arrow="true" cta="Vers le guide d'intégration des Webhooks" />