Skip to main content

Intégration API

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

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.
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"
}'
  • 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 :

Guide d'intégration des Webhooks