Skip to main content

​
Introduction

Cette fonctionnalité est dédiée aux agrégateurs de marchands et permet d’encaisser par virement bancaire.

​
Cycle de vie

Le diagramme ci-dessous présente le processus.
  1. L’agrégateur déclare l’activité de chaque marchand agrégé (KYB).
  2. L’agrégateur déclare chaque transaction avec sa référence.
  3. Le marchand effectue le virement bancaire avec la même référence.
  4. À réception du virement, HUB2 vérifie les données et valide ou rejette la transaction.
  5. Une fois la transaction validée, l’agrégateur est notifié par l’événement webhook transaction.deposit.

​
Conformité

​
Déclarer l’activité des marchands

Avant toute chose, l’agrégateur doit déclarer les informations sur ses marchands agrégés. Plusieurs endpoints sont disponibles pour gérer ces informations.
Consultez ces endpoints dans la référence de l’API.
Afin de conserver un historique complet, les données supprimées sont conservées par HUB2 pour des raisons de conformité. Il en va de même lors de la modification des informations d’un marchand : les informations précédentes sont conservées.

​
Déclarer une transaction

À chaque fois qu’un marchand effectue un virement bancaire vers HUB2 avec une référence, l’agrégateur doit également appeler l’API HUB2 pour déclarer cette transaction.
Consultez cet endpoint dans la référence de l’API.
Tous les champs suivants sont obligatoires :
  • name : le nom du marchand agrégé auquel la transaction est imputable
  • reference : la référence saisie dans le virement bancaire
  • amount et currency : le montant et la devise du virement bancaire
  • iban : l’IBAN du compte de destination
Ce processus n’est pas synchrone : l’agrégateur peut appeler l’API HUB2 avant ou après le virement bancaire.

​
Validation par HUB2

À chaque fois qu’un virement bancaire est reçu sur les comptes de HUB2, HUB2 effectue les vérifications suivantes :
  • À l’aide de la référence du virement bancaire, HUB2 recherche la transaction déclarée correspondant à cette référence
  • HUB2 vérifie les informations de la transaction, comme le montant et la devise
  • Une fois les vérifications validées, HUB2 crédite le compte de l’agrégateur sur la plateforme HUB2 par un dépôt
L’agrégateur est alors notifié par l’événement webhook transaction.deposit, qui contient la référence du virement bancaire.