Skip to main content

​
Intégration API

La fonctionnalité sous-marchands utilise 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. La clé doit disposer des permissions suivantes :
  • Api.submerchant_create
  • Api.submerchant_list
  • Api.submerchant_update
Pour traiter des paiements ou des transferts pour un sous-marchand, la même clé doit aussi disposer des permissions de paiement et de transfert que vous utilisez déjà (par exemple Api.payment_intent_create, Api.transfer_create).

Configuration des permissions

​
Endpoints API

​
Sous-marchands

  • POST /submerchants : créer un sous-marchand. name et description sont obligatoires ; address, zipcode, city, phoneNumber et legalInfo sont facultatifs. Exemple :
  • PATCH /submerchants/{submerchantId} : mettre à jour un sous-marchand
  • GET /submerchants : lister vos sous-marchands
La réponse contient l’id du sous-marchand. Conservez-le pour traiter des transactions pour le compte du sous-marchand.

​
Transactions pour un sous-marchand

Pour créer un paiement ou un transfert pour un sous-marchand, appelez les endpoints de paiement ou de transfert habituels avec votre propre clé API et renseignez l’id du sous-marchand dans l’en-tête MerchantId. La transaction est enregistrée pour le sous-marchand et son champ subMerchantId est renseigné.

​
Webhooks

Les paiements et transferts effectués pour un sous-marchand utilisent les webhooks standard de paiement et de transfert. Si vous les avez déjà configurés, aucune étape supplémentaire n’est requise. Sinon, consultez :

Guide d'intégration des webhooks