Contis API service notifies the client about approved and declined authorisations. Two parameters – Action code and Action Detail – indicate whether a authorisation was a success or failure and the reason for failure.
Note: In payment authorisation, the parameter Authorised Amount denotes the transaction amount as “Primary Hold Amount” which is held by Contis during transaction.
The parameter Fee Amount denotes the fee charged on the transaction as “Secondary Hold Amount”.
Authorisation notification parameters
| Parameters | Type | Description | Default value |
| NotificationType | string | Three-digit unique identifier of notification. Numeric value “052” denotes the Authorisation notification. | Blank |
| CardID | integer | Unique Identifier of the card | Blank |
| AccountNumber | string | Eight-digit account number of the consumer. | 00000000 |
| SortCode | string | Six-digit number that identifies the branch of the bank where consumer holds account. | Blank |
| TransactionID | integer | Unique identifier of the transaction. | Blank |
| ProcessingCode | integer | Unique identifier of the type of transaction. The code identifies whether a transaction is a authorisation, a balance inquiry; sale or cash, or any other transaction. Refer Processing look up values in the table. | |
| AuthorizationDate | string | The date and time of authorisation. The format is yyyyMMddHHmmss. | Blank |
| LocalDate | string | The date and time of authorisation in local time zone. The format is yyyyMMddHHmmss. | Blank |
| AuthorisedAmount | integer | The amount authorised for card transaction. | Blank |
| CardHolderCurrency | integer | The currency of the card transaction. Identified by the ISO currency code. | Blank |
| TransactionAmount | integer | The transaction amount. | Blank |
| TransactionCurrency | integer | The currency of the transaction amount. | Blank |
| CashBackAmount | integer | Shows cashback on card transactions, if any. | Blank |
| MCC | integer | Four-digit numeric code that identifies the merchant’s type of business, product or service | Blank |
| IsCreditAuthorisation | bool | Indicates whether card transaction is credit type or not. If “true” then transaction is a credit transaction. |
Blank |
| CardAcceptorID | string | Unique identifier of facility, merchant or POS that accepts the consumer’s card for payment. It is a number that can be 1 to 15 digits long and in some cases contains a dash, “-“. Provided by VISA. | Blank |
| TerminalCode | string | Unique identifier of the terminal where card is swiped. Provided by Visa. | Blank |
| TerminalLocation | string | The location of the terminal where card is swiped. Provided by Visa. | Blank |
| TerminalStreet | string | The street where card is swiped at a POS or an ATM terminal. Provided by Visa. | Blank |
| TerminalCity | string | The city where card is swiped at a POS or an ATM terminal. | Blank |
| TerminalCountry | string | The country where card is swiped at a POS or ATM terminal. Provided by Visa. | Blank |
| ApprovalCode | string | Approval Code provided by Visa. Provided by Visa. | Blank |
| IsCardPresent | bool | Indicates whether card was present or not present during the transaction. If “true” then card was present. | Blank |
| IsCardHolderPresent | bool | Indicates whether consumer “swiped” or “did not swipe” the card at terminal during card transaction. If “true” then card was swiped by the consumer. | Blank |
| CardAcceptorCountryCode | integer | Indicates country from which card transaction has been done. Denoted by three -digit ISO country code. | Blank |
| IsPinPresent | bool | Indicates whether PIN “was present” or “not present” during the the card transaction. If “true” then PIN “was present”. | Blank |
| STAN | integer | SYSTEM TRACE AUDIT NUMBER provided by Visa. | Blank |
| RRN | string | RETRIEVAL REFERENCE NUMBER and is provided by Visa. | Blank |
| TransactionIndicator | integer | Represents Transaction Indicator. | Blank |
| AcquiringInstituteID | string | Unique identifier of the Acquirer’s Institution. Provided by Visa | Blank |
| ForwardingInstitutionID | string | Unique identifier of the forwarding or processing institution. Provided by Visa. | Blank |
| ClientReferenceNumber | string | Client provided reference number returned by Contis for tracking or auditing. | Blank |
| Description | string | The description of transaction authorisation. | Blank |
| FeeAmount | integer | Fee charged for the transaction. | Blank |
| ActionCode | string | Three digit code that identifies a successful authorisation or failed authorisation. | 000-Success 999-Failed |
| ActionDetail | string | Represents the state of Authorisation. For successful authorisation, ActionDetail would be ‘Normal, approve’ or ‘PartialAuth’. And for failed auth, it will show the failure reason. | Blank |
| FeatureCode | string | Two-digit card feature code that identifies the feature relating to the authorisation. Look-up values are given as below. | 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 authorisation notification
| Parameter name | Value |
| NotificationType | 052 |
| CardID | 123 |
| AccountNumber | 00123456 |
| SortCode | 623053 |
| TransactionID | 318015050782975 |
| ProcessingCode | 1 |
| AuthorizationDate | 13/03/2018 10:40:35 |
| LocalDate | 13/03/2018 10:40:32 |
| AuthorisedAmount | 123 |
| CardHolderCurrency | 826 |
| TransactionAmount | 123 |
| TransactionCurrency | 826 |
| CashBackAmount | |
| MCC | 6011 |
| IsCreditAuthorisation | False |
| CardAcceptorID | Acceptor123 |
| TerminalCode | ATM01 |
| TerminalLocation | ACQUIRER NAME |
| TerminalStreet | |
| TerminalCity | Skipton |
| TerminalCountry | GB |
| ApprovalCode | 002974 |
| IsCardPresent | True |
| IsCardHolderPresent | True |
| CardAcceptorCountryCode | 826 |
| IsPinPresent | True |
| STAN | 2974 |
| RRN | 801511002974 |
| TransactionIndicator | 1 |
| AcquiringInstituteID | 012345678901 |
| ForwardingInstitutionID | |
| ClientReferenceNumber | Ref123 |
| Description | Test transaction |
| FeeAmount | 20 |
| ActionCode | 000 |
| ActionDetail | Normal, Approve |
| FeatureCode | 01 |
| Security Hash | 654a72f95a10e6e246cc107b0b8c6e253fd8126596b24aee059739842fa1db60 |
Lookup values for Processing Codes
Table showing the lookup values for Processing Code transactions.
| ProcessingCode | Description |
| 0 | Goods and services. Debit the customer account. |
| 1 | Cash Withdrawal/Cash Advance. Debit the customer account |
| 9 | Purchase with cashback |
| 11 | Quasi Cash |
| 20 | Purchase refund |
| 26 | Cardholder funds transfer |
| 30 | Balance Inquiry |
| 40 | Cardholder Account Transfer |
| 70 | PIN Change |
Lookup values for FeatureCode
Table showing the lookup values for FeatureCode.
| Feature Code | Feature Name | Feature Description |
| 01 | Purchase | Payment by card terminal (without cashback) |
| 02 | E-commerce | Purchase Online |
| 03 | ATM Withdrawal | Withdrawal at ATM |
| 04 | Purchase Cashback | Payment by card terminal with cashback |
| 05 | Refund or Correction | Refund money |
| 06 | Balance Inquiry | Balance Inquiry |
| 07 | PIN change | Card PIN change |
| 08 | Auto fuel dispense | Payment at fuel pump |
| 09 | Bill Payment | Bill Payment |
| 10 | E-comm without CVV2 | Online payment without CVV2 |
| 11 | Mail phone order | Mail order transactions |
| 12 | Recurring | Recurring Payments |
| 13 | Quasi Cash Tran | Withdraw from terminals other than ATM |
| 14 | VPP | Visa Personal Payment |
| 15 | FIP | Financial Institution Payment |
| 16 | Verification | Account Verification |
| 17 | Estimated | Estimated Transaction |
| 18 | EstimatedPartial | Estimated Transaction with partial support terminal |
| 19 | COF | Credential On File |
| 97 | In App Provisioning | In App Provisioning (X Pay) |
| 98 | NFC | Payment by contactless card |
| 99 | International Trans | International Transaction |
To generate the Security Hash
Hash sequence:
NotificationType&CardID&AccountNumber&SortCode&TransactionID&ProcessingCode&AuthorizationDate&LocalDate&AuthorisedAmount&CardHolderCurrency&TransactionAmount&TransactionCurrency&CashBackAmount&MCC&IsCreditAuthorisation&CardAcceptorID&TerminalCode&TerminalLocation&TerminalStreet&TerminalCity&TerminalCountry&ApprovalCode&IsCardPresent&IsCardHolderPresent&CardAcceptorCountryCode&IsPinPresent&STAN&RRN&TransactionIndicator&AcquiringInstituteID&ForwardingInstitutionID&ClientReferenceNumber&Description&FeeAmount&ActionCode&ActionDetail&FeatureCode&
HashDataString :052&123&00123456&623053&318015050782975&1&20180313104035&20180313104032&123&826&123&826&&6011&False&Acceptor123&ATM01&ACQUIRER NAME&&Skipton&GB&002974&True&True&826&True&2974&801511002974&1&012345678901&&Ref123&Test transaction&20&000&Normal, Approve&01& SecurityKey : abcdefghijklmnop HashGenerationData : HashDataString + SecurityKey Hash : 654a72f95a10e6e246cc107b0b8c6e253fd8126596b24aee059739842fa1db60
JSON Example
{
"NotificationType" : "052",
"CardID" : "123",
"AccountNumber" : "00123456",
"SortCode" : "623053",
"TransactionID" : "318015050782975",
"ProcessingCode" : "1",
"AuthorizationDate" : "20180313104035",
"LocalDate" : "20180313104032",
"AuthorisedAmount" : "123",
"CardHolderCurrency" : "826",
"TransactionAmount" : "123",
"TransactionCurrency" : "826",
"CashBackAmount" : "",
"MCC" : "6011",
"IsCreditAuthorisation" : "False",
"CardAcceptorID" : "Acceptor123",
"TerminalCode" : "ATM01",
"TerminalLocation" : "ACQUIRER NAME",
"TerminalStreet" : "",
"TerminalCity" : "Skipton",
"TerminalCountry" : "GB",
"ApprovalCode" : "002974",
"IsCardPresent" : "True",
"IsCardHolderPresent" : "True",
"CardAcceptorCountryCode" : "826",
"IsPinPresent" : "True",
"STAN" : "2974",
"RRN" : "801511002974",
"TransactionIndicator" : "1",
"AcquiringInstituteID" : "012345678901",
"ForwardingInstitutionID" : "",
"ClientReferenceNumber" : "Ref123",
"Description" : "Test transaction",
"FeeAmount" : "20",
"ActionCode" : "000",
"ActionDetail" : "Normal, Approve",
"FeatureCode" : "01",
"SecurityHash" : "654a72f95a10e6e246cc107b0b8c6e253fd8126596b24aee059739842fa1db60"
}