Contis API service notifies the client about debit and credit transactions of consumer’s account. The latest notification contains all the details of all the transactions that happened after posting of the preceding notification.
Transaction notification with available balance parameters
Parameters | Type | Description | Default value |
NotificationType | String | Three-digit unique identifier of notification. Numeric value “56” denotes the transaction notification with available balance. | Blank |
TransactionID | integer | Unique identifier of the transaction. | |
LocalTransactionDate | string | The local time and date of the card transaction. Date Format = yyyyMMddHHmmss. Maximum length = 14 characters. | Blank |
Description | String | The description that describes the nature, type or purpose of transaction. | |
TransactionType | String | Lookup value that identifies the type of transaction. | |
ClientReferenceNumber | String | Unique reference number provided by user for tracking/auditing. | |
TransactionAmount | integer | The transaction amount | |
AccountBalance | integer | Available amount | |
AccountNumber | String | Eight-digit account number of the consumer. | 00000000 |
SortCode | String | Six-digit number that identifies the branch of the bank where consumer holds account. | Blank |
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. | Blank |
BIC | String | Bank Identifier Code that identifies the name, country and branch of the bank. Used for quick, accurate and automated money transfer. | Blank |
IsCredit | Bit | Return that this transaction is as credit for this account or debit | 0 |
SecurityHash | string | String value generated through hash logic with all of the above parameters (To verify the values posted on URL) | Blank |
Example of account transaction with available balance notification
Parameter name | Value |
NotificationType | 056 |
TransactionID | 123 |
LocalTransactionDate | 20170602105733 |
Description | abc |
TransactionType | 29 |
ClientReferenceNumber | Load Money: 6347595 |
TransactionAmount | 123 |
AccountBalance | 123 |
AccountNumber | 00123456 |
SortCode | 123541 |
IBAN | GB35CNFV60837000000570 |
BIC | CNFVGB21XXX |
IsCredit | 0 |
Security Hash | 2ac413a9a8e23dca860a30fc4fe94d07ab1783f22fc14c73b6e936ee5b8f786e |
To Generate the Security Hash
Hash sequence : NotificationType&TransactionID&LocalTransactionDate&Description&TransactionType&ClientReferenceNumber&TransactionAmount&AccountBalance&AccountNumber&SortCode&IBAN&BIC&IsCredit&
HashDataString : 056&123&20170602105733&abc&29&Load Money: 6347595&123&123&00123456&123541&GB35CNFV60837000000570&CNFVGB21XXX&0& SecurityKey : abcdefghijklmnop HashGenerationData : HashDataString + SecurityKey Hash : 2ac413a9a8e23dca860a30fc4fe94d07ab1783f22fc14c73b6e936ee5b8f786e
JSON Example
{ "NotificationType" : "056", "TransactionID" : "123", "LocalTransactionDate" : "20170602105733", "Description" : "abc", "TransactionType" : "29", "ClientReferenceNumber" : "Load Money: 6347595", "TransactionAmount" : "123", "AccountBalance" : "123", "AccountNumber" : "00123456", "SortCode" : "123541", "IBAN" : "GB35CNFV60837000000570", "BIC" : "CNFVGB21XXX", "IsCredit" : "0", "SecurityHash" : "2ac413a9a8e23dca860a30fc4fe94d07ab1783f22fc14c73b6e936ee5b8f786e" }