Transaction notification

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.

Account transaction notification parameters

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of notification. Numeric value “051” denotes the transaction notification. Blank
CardID integer Unique identifier of the card. Blank
AccountNumber string Eight-digit account number of the consumer. 00000000
TransactionID integer Unique identifier of the transaction.
Description string The description that describes the nature, type or purpose of transaction.
TransactionType string Lookup value that identifies the type of transaction.
AuthorizationDate string The date and time of authorisation of the card transaction. The format of date is yyyyMMddHHmmss Max
length = 14 characters.
Blank
LocalDate string The local time and date of the card transaction. Date Format = yyyyMMddHHmmss. Maximum length = 14
characters.
Blank
SettlementDate string The time and date of settlement of the card transaction. Provided by Visa. The Date Format is
yyyyMMddHHmmss. Maximum length = 14 characters.

AuthoriseAmount integer The amount authorised for transaction through card. The authorised amount is in the currency of the
consumer.
Blank
LocalAmount integer The amount in local currency authorised for card transaction. Blank
SettlementAmount integer The transaction amount
LocalCurrency string The local currency in which tranaction is done. Blank
IssuingCurrency string The currency in which card is authorised to transact.
MCC string Merchant Category Code. A unique three-digit identifier of the category of the merchant. Blank
AuthoriseCode string Authorisation code generated at time of the card transaction for its validation. Blank
ClientReferenceNumber string Unique reference number provided by user for tracking/audting.
CardAcceptorID string Unique identifier of facility, merchant or POS that accepts the consumer’s card for payment. Provided by VISA. Blank
TerminalCode string Unique identifier of the terminal where card is swiped for payment. Provided by Visa. Blank
TerminalLocation string The location of the terminal where card is swiped for transaction. Provided by Visa. Blank
TerminalStreet string The street where terminal is located. Provided by Visa. Blank
TerminalCity string The city where terminal is located and where card was swiped. Provided by Visa. Blank
TerminalCountry string The country where terminal is located and where card was swiped. Provided by Visa. Blank
IsCardPresent bool Boolean that identifies whether card “was present” or “not present” during transaction. Value “1”=
“True” = “card present during transaction”. Value “0” = “False” = “Card Not Present” during transaction.
Blank
STAN integer SYSTEM TRACE AUDIT NUMBER provided by Visa. Blank
RRN string RETRIEVAL REFERENCE NUMBER provided by VISA Blank
TransactionIndicator string Transaction Indicator Lookup Value. Blank
AcquiringInstituteID string Unique identifier of an Acquirer or Acquiring institution. Provided by Visa. Blank
ForwardingInstitutionID string Unique identifier of the Forwarding or Processing institution. Provided by Visa. Blank
TranFromAccountNumber string Account number of the consumer who is the debtor in the transaction. Blank
TranToAccountNumber string Account number of the consumer who is the creditor in the transaction. Blank
TranFromAccountBalance string Account balance of the debtor account. Blank
TranToAccountBalance string Account balance of the creditor account. Blank
SortCode string Six-digit number that identifies the branch of the bank where consumer holds account. Blank
TranFromSortCode string Six-digit number that identifies the branch of the bank where consumer holds account. This is associated with the debtor account number. Blank
TranToSortCode string Six-digit number that identifies the branch of the bank where consumer holds account. This is associated with the creditor account number. Blank
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 notification

Parameter name Value
NotificationType 051
CardID 123
AccountNumber 00123456
TransactionID 123v
Description abc
TransactionType 29
AuthorizationDate 20170602105733
LocalDate 20170602105733
SettlementDate 20170602105733
AuthoriseAmount 123
LocalAmount 123
SettlementAmount 123
LocalCurrency 840
IssuingCurrency 840
MCC
AuthoriseCode 000
ClientReferenceNumber Load Money: 6347595
CardAcceptorID 123
TerminalCode 123
TerminalLocation abc
TerminalStreet abc
TerminalCity abc
TerminalCountry abc
IsCardPresent N
STAN 123
RRN abc
TransactionIndicator abc
AcquiringInstituteID abc
ForwardingInstitutionID abc
TranFromAccountNumber 00123456
TranToAccountNumber 00312654
TranFromAccountBalance 123
TranToAccountBalance 123
SortCode 123456
TranFromSortCode 123456
TranToSortCode 123456
Security Hash f7099105443aed2d5e0c376fe776c06a86a3e0b7001e61c3067686f487c7dd99

To generate the Security Hash

Hash sequence: NotificationType&CardID&AccountNumber&TransactionID&Description&TransactionType&AuthorizationDate&LocalDate&SettlementDate&AuthoriseAmount&LocalAmount&SettlementAmount&LocalCurrency&IssuingCurrency&MCC&AuthoriseCode&ClientReferenceNumber&CardAcceptorID&TerminalCode&TerminalLocation&TerminalStreet&TerminalCity&TerminalCountry&IsCardPresent&STAN&RRN&TransactionIndicator&AcquiringInstituteID&ForwardingInstitutionID&TranFromAccountNumber&TranToAccountNumber&TranFromAccountBalance&TranToAccountBalance&SortCode&TranFromSortCode&TranToSortCode&

HashDataString : 051&123&00123456&123v&abc&29&20170602105733&20170602105733&20170602105733&123&123&123&840&840&&000&Load Money: 6347595&123&123&abc&abc&abc&abc&N&123&abc&abc&abc&abc&00123456&00312654&123&123&123456&123456&123456&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : f7099105443aed2d5e0c376fe776c06a86a3e0b7001e61c3067686f487c7dd99

JSON Example

{
   "NotificationType" : "051",
   "CardID" : "123",
   "AccountNumber" : "00123456",
   "TransactionID" : "123v",
   "Description" : "abc",
   "TransactionType" : "29",
   "AuthorizationDate" : "20170602105733",
   "LocalDate" : "20170602105733",
   "SettlementDate" : "20170602105733",
   "AuthoriseAmount" : "123",
   "LocalAmount" : "123",   
   "SettlementAmount" : "123",
   "LocalCurrency" : "840",
   "IssuingCurrency" : "840",
   "MCC" : "",
   "AuthoriseCode" : "000",
   "ClientReferenceNumber" : "Load Money: 6347595",
   "CardAcceptorID" : "123",   
   "TerminalCode" : "123",
   "TerminalLocation" : "abc",
   "TerminalStreet" : "abc",
   "TerminalCity" : "abc",
   "TerminalCountry" : "abc",
   "IsCardPresent" : "N",
   "STAN" : "123",
   "RRN" : "abc",
   "TransactionIndicator" : "abc",
   "AcquiringInstituteID" : "abc",
   "ForwardingInstitutionID" : "abc",
   "TranFromAccountNumber" : "00123456",
   "TranToAccountNumber" : "00312654",
   "TranFromAccountBalance" : "123",
   "TranToAccountBalance" : "123",
   "SortCode" : "123456",
   "TranFromSortCode" : "123456",
   "TranToSortCode" : "123456",
   "SecurityHash" : "f7099105443aed2d5e0c376fe776c06a86a3e0b7001e61c3067686f487c7dd99"
}