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",
  "country": "CI",
  "currency": "XAF",
  "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

Ceci utilise les mêmes webhooks que les endpoints de paiement. 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