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