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