​
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 :

API 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

Configuration des permissions

​
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 Contrairement au paiement classique, pas besoin de créer une intention de paiement dans un premier temps, avant une tentative de paiement. Ici, vous effectuez directement la tentative de paiement. Ci-après un exemple.
curl --location 'https://api.hub2.io/delegated/payments' \
--header 'environment: sandbox' \
--header 'merchantId: [REDACTED]' \
--header 'Content-Type: application/json' \
--header 'ApiKey: [REDACTED]' \
--data '{
    "customerReference": "<YOUR_INTERNAL_CUSTOMER_REFERENCE>",
    "purchaseReference": "<YOUR_INTERNAL_REFERENCE>",
    "amount": 120,
    "currency": "XOF",
    "paymentMethod": "mobile_money",
    "country": "CI",
    "provider": "orange",
    "mobileMoney": {
        "msisdn": "00000001",
        "onCancelRedirectionUrl": "https://failed.com",
        "onFinishRedirectionUrl": "https://success.com",
        "workflow": "redirection"
    }
}'
  • 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)

Guide d'intégration des paiements

​
Transferts

  • POST /delegated/transfers - Créer un transfert en utilisant votre compte fournisseur. Plus bas un exemple. Seul le endpoint change ici dans la requête.
curl --location --request POST 'https://api.hub2.io/delegated/transfers' \
--header 'ApiKey: [REDACTED]' \
--header 'MerchantId: [REDACTED]' \
--header 'Environment: sandbox' \
--header 'Content-Type: application/json' \
--data-raw '{
  "reference": "<YOUR_INTERNAL_REFERENCE>",
  "amount": 2000,
  "currency": "XOF",
  "description": "<YOUR_DESCRIPTION>",
  "destination": {
    "type": "mobile_money",
    "country": "CI",
    "recipientName": "John Doe",
    "msisdn": "+225000000000",
    "provider": "orange"
  }
}'
  • 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)

Guide d'intégration des transferts

​
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 :

Guide d'intégration des Webhooks