Error Codes - Details & Description

This page translates common payment error codes into easy-to-understand explanations and solutions. Instead of leaving users confused about transaction failures, it helps merchants and customers quickly identify the problem and its solution.

Gateway Normalised Response Codes:

Response CodeResponse TextDescription
00APPROVALApproved
02CALL ISSUERRefer to card issuer - Call issuer
03INVALID - MERCHANTInvalid Merchant ID. Ensure merchant ID matches to the merchant details in IST
05DECLINEDDeclined by Issuer; Do not Honor
06UNABLE TO REVERSEUnable to reverse/void, Reversal batch ID does not match original batch ID
08ISSUER TIMEOUTIssuer timeout; Generate a reversal to remove any hold on the cardholder account
09ISSUER UNAVAILABLEIssuer unavailable at time of transaction
12INVALID TRANSACTIONInvalid transaction
13INVALID AMOUNTInvalid amount
14INVALID CARD NUMBERInvalid card number
30FORMAT ERRORFormat error
31INVALID ISSUERInvalid Issuer
41LOST CARDLost card
43STOLEN CARDStolen card, pick up
51INSUFFICIENT FUNDSDeclined by issuer due to insufficient funds
54EXPIRED CARDExpired card
60PROCESSOR DECLINEGeneral Decline from processor
61RESTRICTED CARDCard has been restricted
62SUSPECTED FRAUDSuspected Fraud
64STOP PAYMENTAccountholder has requested all recurring/installment payments be stopped
78ORIGINAL NOT FOUNDOriginal transaction for Reversal/Void/Completion not found
79DECLINED - CVV2Invalid CVV2
90ISSUER DECLINEIssuer decline default
91SWITCH UNAVAILABLESwitch not available
94DUPLICATE TXNDuplicate transmission
96ERROR-SYSTEM - SESystem malfunction
AETIMEOUTTimeout waiting for response

Issuer Error Codes.

CodeDescriptionActionNormalized Response Code
000ApprovedApprove00
001Honour with identificationApprove00
003Approved (VIP)Approve00
100Do not honorDecline05
101Expired cardDecline54
102Suspected fraud (To be used when ARQC or mada 3DS authentication cryptogram validation fails)Decline62
103Card acceptor contact acquirerDecline60
104Restricted cardDecline61
105Card acceptor call acquirer‘s security departmentDecline60
107Refer to card issuerDecline02
108Refer to card issuer‘s special conditionsDecline02
110The specified amount is invalid or exceeds the maximum unitary amount for the given mada transaction serviceDecline13
111Invalid card numberDecline14
116Not sufficient fundsDecline51
118No card recordDecline14
119Transaction not permitted to cardholderDecline12
121Exceeds Daily limit for the given mada transaction serviceDecline90
122Security violationDecline60
123Exceeds frequency limit i.e. number of transactions, for the given mada transaction serviceDecline90
129Suspected counterfeit cardDecline62
164Transaction not permitted for this Merchant Category Code (MERCHANTCATEGORYCODE).Decline60
165Excessive pre-authorization Capture not allowed. The excessive Capture attempt violates the mada business rules in terms of the total amount being captured or the allowed transaction channels or presentment mode.Decline60
166More than one pre-authorization extension is not allowedDecline60
167Issuer not certified for this transaction or service or Issuer does not support this serviceDecline60
184Incorrect CVV (Visa 82)Decline79
187Original transaction for refund, preauthorization capture, preauthorization void or preauthorization extension not found based on original transaction data elements.Decline78
189Agreement ID is not present in the initial 3DS authenticated agreed payment transaction or the Agreement ID in a subsequent COF agreed payment transaction is not present or does not match the Agreement ID in the initial 3DS transactionDecline90
191The recurring payment amount type is invalidDecline90
192The recurring amount value is invalidDecline90
193The total number of allowed recurring payments has been exceededDecline90
197The bank account used in the original transaction does not match the bank account being used in the Refund, Preauthorization Capture, Preauthorization Void or Preauthorization Extension transactionDecline90
198The refund or preauthorization void transaction amount or cumulative amount exceeds the original transaction amountDecline90
199The refund, pre-authorization Capture or preauthorization void transaction period exceeds the maximum time limit allowed by the mada business rulesDecline90
400AcceptedApprove00
480Original transaction not foundDecline78
481Original transaction was found but declinedDecline60
902Invalid transactionDecline12
903Re-enter transactionDecline90
904Format errorDecline30
906Cutover in processDecline96
907Card issuer or switch inoperativeDecline91
908Transaction destination cannot be found for routingDecline31
909System malfunctionDecline96
910Card issuer signed offDecline91
911Card issuer timed outDecline08
912Card issuer unavailableDecline09
913Duplicate transmissionDecline94
914Not able to trace back to original transactionDecline78
915Reconciliation cutover or checkpoint errorDecline96
916MAC incorrect (permissible in 1644)Decline96
917MAC key syncDecline96
920Security software/hardware error – try againDecline96
922Message number out of sequenceDecline96
923Request in progressDecline96
941Destination UnavailableDecline09

ICS supported Action Codes (Based on ISO 8583:1987):

CodeDescriptionActionNormalized Response Code
00Approved or Completed successfullyApprove00
01Refer to card issuerCall Issuer02
02Refer to card issuer, Special conditionCall Issuer02
03Invalid MerchantDecline03
05Do Not HonorDecline05
10Transaction Request approved for the partial approved amountApprove00
12Invalid transactionDecline12
13Invalid amountDecline13
14Invalid card numberDecline14
15Invalid issuerDecline31
19Re-enter transactionDecline90
20Invalid responseDecline30
21Card not initializedDecline61
22Suspected Malfunction; related transaction errorDecline96
25Unable to locate original transactionDecline78
30Message format errorDecline30
31Bank not supported by switchDecline60
33Expired CardDecline54
34Suspended FraudDecline62
36Restricted CardDecline61
40Function requested not supportedDecline12
41Lost CardDecline41
43Stolen CardDecline43
51Insufficient fundsDecline51
54Expired CardDecline54
56No Card recordDecline14
57Transaction not permitted to issuer or cardholderDecline60
58Transaction not permitted to acquirer or terminalDecline60
59Suspected fraudDecline62
61Exceeds withdrawal limitDecline90
62Restricted cardDecline61
63Security ViolationDecline60
64Original transaction amount errorDecline78
65Exceeds withdrawal count limitsDecline90
68Issuer response time-outDecline08
76Unable to locate previous message (no match on retrieval reference number)Decline78
77Previous message located for a repeat or reversal, but repeat or reversal data inconsistent with original messageDecline78
79Transaction ReversedApprove00
85No reason to decline request for account verificationApprove00
88Cryptographic FailureDecline60
90Cutoff is in processDecline96
91Authorization System or issuer system inoperativeDecline91
92Unable to route transactionDecline31
94Duplicate transmission detectedDecline94
96System errorDecline96
98Issuer response not received by CUPSDecline08
A0Mac failedDecline96
D1Incorrect IINDecline60
D2Date ErrorDecline60
N7Decline for CVV2 failureDecline79
R0Stop payment orderDecline64
R1Revocation of authorization orderDecline64
R3Revocation of all authorizations orderDecline64

ICS supported Action Codes (Based on ISO 8583:1993):

CodeDescriptionActionNormalized Response Code
081Approved by IssuerApprove00
086Card Account Verification SuccessfulApprove00
100Do not honorDecline05
101Expired cardDecline54
102Suspected FraudDecline62
104Restricted cardDecline61
105Card acceptor call acquirer‘s security departmentDecline60
109Invalid MerchantDecline03
110Invalid AmountDecline13
111Invalid card numberDecline14
115Requested Function Not supportedDecline12
118Cycle Range suspendedDecline14
119Transaction not permitted to cardholderDecline12
120Transaction not permitted to originatorDecline60
121Exceeds Daily limit for the given mada transaction serviceDecline90
122Card Validity Period ExceededDecline54
125Card Not EffectiveDecline14
129Suspected counterfeit cardDecline62
163Security ViolationsDecline60
182Decline given By IssuerDecline90
184Decline Given By Xpress, No Communication With IssuerDecline60
188Xpress Unable to forward request to Issuer XDecline09
192Restricted MerchantDecline03
198Card Account Verification FailedDecline90
200Do Not HonorDecline05
201Expired cardDecline54
202Suspected FraudDecline62
203Card Acceptor Contact AcquirerDecline60
204Restricted cardDecline61
205Card Acceptor Call Acquirers Security DepartmentDecline60
207Special conditionsDecline90
208Lost CardDecline41
209Stolen CardDecline43
210Suspected Counterfeit CardDecline62
400Used in reversal response messages to indicate the result of the reversal (Accepted)Approve00
480Function Code Not AllowedDecline78
481Account Number InvalidDecline14
484Invalid AmountDecline13