Account Update (Balance)

The account updated webhook event gets fired based on the following cases provided below, which include:

A. Our account connected and account updated webhook event is sent shortly after a user have successfully linked their account. An API call is made to the Exchange Token API to receive an Account ID. The significance of this event is that financial account/transaction data status will be known (as indicated via the meta.data_status if AVAILABLE). It gives the go-ahead to call our Connect APIs such as Transaction, Statement, Income, etc for data retrieval.

B. Another case where the account updated webhook event gets fired is when Data Sync Refresh is run successfully, which implies that all recent financial transaction data has been refreshed. As soon as this event is received, you can also go ahead to call our Connect APIs such as Transaction, Statement, Income, etc for updated data.

Note: Please note that the payload below in the sandbox environment return an empty institution object.

📘
mono.events.account_updated

API object


{
  "event": "mono.events.account_updated",
  "data": {
    "meta": {
      "data_status": "AVAILABLE",
      "auth_method": "mobile_banking" //or internet_banking
    },
    "account": {
      "_id": "64ee162d084d993204d5420e",
      "name": "Samuel Olamide",
      "currency": "NGN",
      "type": "savings_account", // or BUSINESS_BANKING 
      "accountNumber": "0131883461",
      "balance": 100000,
      "institution": {},
      "liveMode": false,
      "created_at": "2023-08-29T16:00:45.516Z",
      "updated_at": "2023-08-29T16:00:45.516Z",
      "__v": 0,
      "bvn": '9422'
    }
  }
}

Fields for balance webhooks

Field	description	type
event	The webhook event action that triggered the webhook, e.g. mono.events.account_updated	string
data	All information related to this specific webhook	object
data.meta	An event object containing the account data and the current status	object
data.meta.data_status	The status of the current connected data, if it is AVAILABLE, PROCESSING, FAILED	string
data.meta.auth_method	This refers to the authentication method used by user. It returns either, mobile_banking or internet_banking	string
data.account	An object with all account data	object
data.account._id	The unique identifier for the member which has new or updated transaction data	string
data.account.institution	All data related to the financial institution of the connected user	object
data.account.institution.name	The institution name of the connected account	string
data.account.institution.bankCode	The bank code of the institution name connected to this account	string
data.account.institution.type	The type of banking method for this connected user. E.g PERSONAL_BANKING, BUSINESS_BANKING & PAYMENT_GATEWAY	string
data.account.accountNumber	The account number of the connected user	string
data.account.name	The account name of the connected user	string
data.account.type	The account type of the connected user E.g SAVINGS ACCOUNT, CURRENT ACCOUNT	string
data.account.currency	The curency of the connected user	string
data.account.bvn	The BVN of the connected user	string
data.account.balance	The current account balance of the connected user	string
data.account.created_at	The date the webhook object was created	string
data.account.updated_at	The date the webhook object was updated	string