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.

πŸ“˜

mono.events.account_updated

API object

{
  event: 'mono.events.account_updated',
  data: {
    meta: {
      data_status: 'AVAILABLE',
      auth_method: 'mobile_banking'//internet_banking
    },
    account: {
      _id: '5fbcde8f8699984153e65537',
      institution: {
        "name": "GTBank",
        "bankCode": "058",
        "type": "PERSONAL_BANKING" // or BUSINESS_BANKING or PAYMENT_GATEWAY
      },
      accountNumber: '0018709596',
      name: 'OGUNGBEFUN OLADUNNI KHADIJAH',
      type: 'SAVINGS_ACCOUNT',
      currency: 'Naira',
      bvn: '9422',
      balance: 3033984,
      created_at: '2020-11-24T10:21:03.936Z',
      updated_at: '2020-11-24T10:21:13.050Z',
      __v: 0
    }
  }
}

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

What’s Next