Authorisation notification

Contis API service notifies the client about approved and declined authorizations. Two parameters – Action code and
Action Detail – indicate whether a authorization was a success or failure and the reason for failure.

Note: In payment authorization, the parameter Authorized 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
authorization, a balance inquiry; sale or cash, or any other transaction. Refer Processing look up
values in the table 21.
 
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

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

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 Withdraw by 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 payments 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 trans with partial support terminal
19 COF Credential On File
97 In App Provisioning In App Provisioning (Apple 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