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
BusinessApplicationIdentifier string Business Application Identifier received from visa in OCT transaction. Blank
IsFastFund string Fast Fund Indicate is immediate payment or not. True/False
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
BusinessApplicationIdentifier AA
IsFastFund True
Security Hash 84f584e68c78670fc18f3762a3a2361b5042fd43f2c5332b06ffb29b66cf3935

Lookup values for Business Application Identifier

Table showing the lookup values for Business Application Identifier.

CODE DESCRIPTION
AA Account to account
AL AFT or OCT eligibility
BB Business to business
BI Money transfer-bank-initiated
BP Non-card bill payment
CB Consumer bill payment
CI Cash in
CO Cash out
CP Card bill payment
FD Funds disbursement (general)
FT Funds transfer
GD Government disbursement
GP Gambling payout (other than online gambling)
LO Loyalty and offers
MD Merchant disbursement
MI Money transfer-merchant-initiated
MP Merchant payment
OG Online gambling payout
PD Payroll/pension disbursement
PG Payment to government
PP Person to person
PS Payment for goods and services (general)
TU Top-up for enhanced prepaid loads
WT Wallet transfer

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&BusinessApplicationIdentifier&IsFastFund&

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&AA&True&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : 84f584e68c78670fc18f3762a3a2361b5042fd43f2c5332b06ffb29b66cf3935

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",
   "BusinessApplicationIdentifier" : "AA",
   "IsFastFund" : "True",
   "SecurityHash" : "84f584e68c78670fc18f3762a3a2361b5042fd43f2c5332b06ffb29b66cf3935"
}