Overview flow

A user connects his financial bank account to your business through our Mono connect widget. Immediately this connection is successful, a temporary authorisation token is sent on the frontend which lasts for only 10minutes, which you can then send to the backend to exchange for a permanent Account ID.


Please note that immediately a user logs in successfully, this event "mono.events.account_connected" gets sent with a payload which contains a unique Account ID that stands as an identifier to this account.

Once the Account ID has been retrieved from the Exchange Token endpoint, Mono immediately tries to fetch all recent account information, transactions, identity etc which takes roughly about 0.5 seconds to 5 minutes maximum, which is very dependent on the uptime of the Bank's availability.

As soon as Mono has received all data from a connected account successfully, we return an event which is the "mono.events.account_updated", with the meta.data_status as AVAILABLE which indicates that data is now readily available on all our endpoints.

Once this event is received, it is then advisable to call any of our endpoints at will. Failure to wait and receive this event "mono.events.account_updated", will lead to empty Transactions/ Statements/ Identity/ Income etc data.


At the point of receiving the mono.events.account_updated event, you can proceed to call your desired endpoints immediately.
Alternatively, you can have a flag (e.g mono.data_available) set in your db which is set to false by default, and then change this field to True once this event has been received. So once a user logs back in some minute after, these endpoints can then be called as long as mono.data_available is set to true.

When Data sync gets called manually and the call is successful, "mono.events.account_updated" gets sent. If this call is not successful, and re-authorisation is required, this event "mono.events.reauthorisation_required" gets sent alongside a payload containing the Account ID.

Once the connected has re-authorised his account successfully, "mono.events.account_reauthorized" event gets sent, with a payload containing the Account ID.

Reference: https://docs.mono.co/reference/data-sync-overview

Did this page help you?