Intégration API

Le mode ProcessingOnly utilise des endpoints API HUB2 dédiés qui sont différents de notre modèle d’agrégation traditionnel. La principale différence est que les transactions sont traitées directement via votre compte fournisseur au lieu de nos comptes agrégés. Les endpoints disponibles sont listés dans la documentation suivante : https://api.hub2.io/docs#/Delegation

Authentification

Votre intégration utilise les mêmes clés API HUB2 pour l’authentification mais la clé doit avoir de nouvelles permissions :
  • Api.delegated_payment_create
  • Api.delegated_transfer_create

Flux de Transaction

1. Requête de Transaction

Lorsque vous initiez une transaction, HUB2 va :
  1. Valider la requête : Vérifier la clé API et le format de la demande
  2. Router vers le Fournisseur : Diriger la demande vers votre compte fournisseur configuré
  3. Traiter la Transaction : Exécuter la transaction en utilisant vos identifiants fournisseur
  4. Retourner la Réponse : Fournir un format de réponse unifié indépendamment du fournisseur

2. Traitement Fournisseur

Le traitement réel de la transaction se fait directement avec votre fournisseur :

Endpoints API

Le mode Processing Only utilise des endpoints de création dédiés, tandis que les endpoints de lecture restent les mêmes que pour le circuit classique :

Paiements

  • POST /delegated/payments - Créer un paiement en utilisant votre compte fournisseur
  • POST /delegated/payments/sync - Créer un paiement en utilisant votre compte fournisseur en mode synchrone (la liste des fournisseurs supportant le mode synchrone est disponible à https://docs.hub2.io/integration/fr/getting_started/api_operation#synchronous-circuit)
  • GET /payments - Lister les paiements (le même que pour les paiements classiques)
  • GET /payments/{id}/status - Obtenir le status d’un paiement (le même que pour les paiements classiques)

Transferts

  • POST /delegated/transfers - Créer un transfert en utilisant votre compte fournisseur
  • POST /delegated/transfers/irt - Créer un transfert IRT en utilisant votre compte fournisseur
  • GET /transfers - Lister les transferts (le même que pour les transferts classiques)
  • GET /transfers/{id}/status - Obtenir le status d’un transfert (le même que pour les transferts classiques)

Webhooks

Ceci utilise les mêmes webhooks que le circuit classique. Si vous avez déjà configuré des webhooks pour les paiements/transferts, aucune étape supplémentaire n’est requise. Sinon, consultez : https://docs.hub2.io/integration/fr/webhooks/webhooks_overview