Gateway Response Codes

Transaction Result Codes

 

Result Status Result Code Result Description Additional Information 
0 (OK) 0 Approved/Successful
-1 (Not OK) 1 Timeout waiting for response Either stop the transaction or wait a while before re-submitting.  Do not re-submit forever, have a limit in place of how many times a transaction can be re-submitted.
-1 (Not OK) 2 Gateway unreachable Either stop the transaction or wait a while before re-submitting.  Do not re-submit forever, have a limit in place of how many times a transaction can be re-submitted.
-1 (Not OK) 3 Hot card
-1 (Not OK) 4 Denied
-1 (Not OK) 5 Please call Merchant can phone their acquiring bank to obtain a telephonic authorisation.  If this is not possible then the transaction should be Denied.
-1 (Not OK) 7 Invalid Authentication Data Card security code and/or 3D secure data is incorrect.
-1 (Not OK) 8 Card Type not accepted The Card cannot be accepted either because the Merchant has not signed up with the association, the card type cannot be accepted on the channel that the merchant is using or the Acquirer does not support this card type.
-1 (Not OK) 9 Unable to process the transaction Either stop the transaction or wait a while before re-submitting.  Do not re-submit forever, have a limit in place of how many times a transaction can be re-submitted.
-1 (Not OK) 10 Card blocked The card is being blocked either by the iVeri Gateway, the Acquirer or the Issuer.  This is NOT  a hot card but one that has been blocked for some reason.
-1 (Not OK) 11 Invalid Amount Amounts of zero or where the cash amount exceeds the total amount are not accepted.
-1 (Not OK) 12 Invalid Budget Period The budget period chosen is not supported.
-1 (Not OK) 13 Void unsuccessful Command Void - Stop processing.  Re-submitting the transaction will not change the result.
-1 (Not OK) 14 Invalid Card Number The card number fails the Luhn Mod10 check, is too short or too long or contains invalid characters.
-1 (Not OK) 15 Invalid Track2 The track2 fails the Luhn Mod10 check, is too short or too long or contains invalid characters.
-1 (Not OK) 16 Invalid Expiry Date/Card Period The expiry date submitted is malformed, contains invalid characters or simply incorrect.
-1 (Not OK) 17 Invalid Account Selectiion Ask the cardholder to choose another account.
-1 (Not OK) 18 Invalid Authorisation code The acquiring institution does not accept the authorisation code submitted due to length or character restrictions.
-1 (Not OK) 19 Incorrect PIN Resubmitting a transaction whose response code is “Incorrect PIN” repeatedly will result in the carholders card being locked and the cardholder will have to contact their issuing bank to unlock their card.
-1 (Not OK) 20 Device PIN Key expired Renew the Device PIN Key before re-submitting the same transaction.
-1 (Not OK) 22 EMV not supported EMV_Cryptogram submitted
-1 (Not OK) 23 Card information not present Tokenized PAN submitted but no record of the actual PAN can be found.
-1 (Not OK) 24 Invalid recurring account CardHolderPresence  value Recurring submitted
-1 (Not OK) 26 Contactless not allowed The use of contactless for this transaction is not supported and the customer must try again by dipping or swiping their card.
-1 (Not OK) 27 Single Tap Process a “Single Tap” transaction by requesting a PIN to be entered on the device and then submitting the PIN and the data from the first transaction in a second transaction.
-1 (Not OK) 100 The requested file is not available for download FileTransfer -  Resubmit without changing the data after a period of time. Stop if this ResultCode is returned continuously
-1 (Not OK) 101 The specified file has already been uploaded FileTransfer -   Stop processing.  Re-submitting the transaction will not change the result.
-1 (Not OK) 255 General Error (Exception)
1 (Warning) 7 Approved in spite of Invalid Authentication Data Allow the cardholder to depart with the goods.
1 (Warning) 21 Approved but Cash Denied Hand over the goods but DO NOT hand over the cash.
1 (Warning) 25 Approved but Identification Required Ask the cardholder for identification before allowing the cardholder to depart with the goods.
1 (Warning) 28 Partial Approval of Amount requested The transaction is approved but for a lesser amount than requested.  Merchants need to be aware that although it is approved it is for a reduced amount and the difference must be made up some other way e.g. cash.  For this reason it is recommened that instead of “Approved” being shown on transaction slips that “Partial Approval” is shown instead and that the amount for which it was approved must shown as well.


 

Merchant Advice Codes

The following merchant advice code description may appear on transactions blocked by the iVeri Gateway in accordance with acquirer responses, and or Visa and MasterCard guidelines

Code Description  
10 Card Blocked: New Account Information Available
10 Card Blocked: Cannot approve at this time, try again
10 Card Blocked: Do not try again
10 Card blocked: Token Requirements not fulfilledd for this token type
10 Card Blocked: Negotiated value not approved
10 Card Blocked: Payment Cancellation
10 Card Blocked: Merchant does not qualify for product code
10 Card Blocked: Retry after one hour
10 Card Blocked: Retry after 24 hours
10 Card Blocked: Retry after 2 days
10 Card Blocked: Retry after 4 days
10 Card Blocked: Retry after 6 days
10 Card Blocked: Retry after 8 days
10 Card Blocked: Retry after 10 days
10 Card Blocked: Consumer non-reloadable prepaid card
10 Card Blocked: Consumer Single Virtual card number


VISA Excessive response codes 


Code Description  
10 Issuer never approves (Cat1)
10 Issuer cannot approve at this time (Cat2)
10 Data quality/revalidate payment information (Cat3)
10 Generic response codes (Cat4)


Configuration Codes

Configuration Item  Error Description 
Status: -1 | Code: 255 Merchant is not allowed to specify CardHolderPresence indicator Recurring


Common Codes

Configuration Item  Error Description 
Status: -1 | Code: 255 The MerchantTrace does not identify a current transaction

Code: 14

The PAN differ from the original