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

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

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"
}