Bank collection
Introduction
This feature is dedicated to merchant aggregators and allows collection via bank transfers.
Life cycle
Here’s a schema of the process.
- Merchant must declare the business of the sub-merchant
- Then they must declare each transaction using their reference
- The bank transfer must occur with the same reference
- An Hub2 agent will check the data upon reception of the transfer and validate or reject the transaction
- Once validated, merchant will be notified with a webhook on event
transaction.deposit
Compliance
Declare merchants business
First of all, before anything else, the aggregator must declare information about their merchants.
Multiple endpoints are available to manage the aggregated merchants.
Please check these endpoints in the API reference.
In order to keep track of a full history, please keep in mind that deleted data are kept in HUB2 database for compliance reasons. That’s also the case when editing a merchant information, previous data are kept.
Declare transaction
Whenever a merchant will send a bank transfer to HUB2 with the reference, the aggregator must also call HUB2 API to declare information about this transaction.
Please check these endpoints in the API reference.
- The transaction field
merchantName
is here to know for which merchant this transaction is accountable - The field
reference
is the one typed in the bank transfer - The
IBAN
of the destination account must be provided here
This is not a synchronous process, the aggregator can call the HUB2 API before of after the bank transfer occurs, it does not matter here.
Internal process
Whenever a bank transfer gets on the HUB2 accounts, cash management and control teams will perform checks:
- Using the reference in the bank transfer, they will seek the declared transaction associated with this reference
- Once found, they will perform checks on the information such as amount and currency
- Once validated, they will perform a deposit on the aggregator’s account on HUB2 platform
From there, the aggregator can be notified using the webhook event transaction.deposit
which will contains the reference.