Account balance change notification

A notification informing you when the balance of an account changes.

Notification parameters

Parameter Type Description
NotificationType string Three-digit identifier of the notification type. "060" denotes the account balance change notification.
AccountBalance integer Account Balance is the total amount of all the funds for an account at any time.
AccountCurrency string Three-digit ISO currency code for an account.
AccountNumber string Eight-digit account number of the consumer.
AvailableBalance integer Available Balance is the actual amount immediately available for withdraw, transfer and use, after any authorization hold (reserved) for an account. Consumer’s Available balance may be different than Account balance in case of any Debit holds or Credit holds for an account.
HoldBalance integer Authorization hold on a debit transaction.
CreditHoldBalance integer Reserved amount on a credit transaction.
ReservedInEnvelopes integer Reserved balance for envelope transactions.
SortCode string Six-digit number that identifies the branch of the bank where consumer holds account.
Iban string Unique, 34-alphanumeric character code that identifies banks globally. IBAN consists of country code, two-check digits, and a alpha-numeric pattern that includes the domestic bank account number, branch identifier, and potential routing information.
Bic string Bank Identifier Code that identifies the name, country, and branch of the bank. Used for quick, accurate and automated money transfer.
FriendlyName string Friendly name of an account to identify an account easily from multiple accounts.
DisplaySortCode string It is the SortCode with the display format configuration.
CompanyID integer Unique identifier that indicates the company that an account belongs to. It will have value “0” when the account does not belong to any company.
Status string Two-digit unique identifier that indicates the “status of the account”
SecurityHash string Contains the hash of the payload values and your webhook security key, to verify the origin and integrity of the notification.

Example of account balance change notification

Copy
Copied
{
   "NotificationType" : "060",
   "AccountBalance" : "123",
   "AccountCurrency" : "826",
   "AccountNumber" : "123456", 
   "AvailableBalance" : "123",
   "HoldBalance" : "123",
   "CreditHoldBalance" : "123",
   "ReservedInEnvelopes" : "123",
   "SortCode" : "623053",
   "Iban" : "GB35CNFV60837000000570",
   "Bic" : "CNFVGB21XXX",
   "FriendlyName" : "Account Friendly Name",
   "DisplaySortCode" : "623053",
   "CompanyID" : "123",
   "Status" : "01",
   "SecurityHash" : "3c48095895ad2c673727f295be905996f8e0f88c3d4331d8f137a882936475ac"
}

Lookup values for Account status

Account status Description
01 Live (Active)
02 Suspended
03 Inactive
04 Closed
05 Frozen
06 Dormant
07 Limited
08 Restricted

Validating the notification security Hash

Security Hash validation

See the respective guide for more information on calculating and verifying the notification security hash.

To compute the hash of the notification payload, concatenate the payload values in the following sequence, with your webhook security key as the final item:

Copy
Copied
<NotificationType>&<AccountBalance>&<AccountCurrency>&<AccountNumber>&<AvailableBalance>&<HoldBalance>&<CreditHoldBalance>&<ReservedInEnvelopes>&<SortCode>&<Iban>&<Bic>&<FriendlyName>&<DisplaySortCode>&<CompanyID>&<Status>&<webhook-security-key>

The example payload values above and a webhook security key of abcdefghijklmnop will produce the following hash input:

Copy
Copied
060&123&826&123456&123&123&123&123&623053&GB35CNFV60837000000570&CNFVGB21XXX&Account Friendly Name&623053&12301&abcdefghijklmnop
Solaris is the brand name for the regulated entities Contis Financial Services Ltd and UAB „Finansinės paslaugos „Contis“, which are part of the Solaris Group.