Authorization 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.

    Parameters of the Authorization notification are shown in the Table

    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


    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 teminal. 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 -dgit 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 succesful authorisation or  failed authorisation. 000-Success


    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.



    Example of and authorisation Notification

    The table is an 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


    MCC 6011    

    IsCreditAuthorisation False
    CardAcceptorID Acceptor123
    TerminalCode ATM01
    TerminalLocation ACQUIRER NAME


    TerminalCity Skipton
    TerminalCountry GB
    ApprovalCode 002974
    IsCardPresent True
    IsCardHolderPresent True
    CardAcceptorCountryCode 826
    IsPinPresent True
    STAN 2974
    RRN 801511002974
    TransactionIndicator 1
    AcquiringInstituteID 012345678901


    ClientReferenceNumber Ref123
    Description Test transaction
    FeeAmount 20
    ActionCode 000
    ActionDetail Normal, Approve


    Lookup for Processing Code

    Table 21 shows the look values that different types of the 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


    Was this page helpful to you?