Response Codes
Purchase, Refund and Auth/Captured responses from Fat Zebra include a response_code value which maps to a standard list of responses from the financial network. These codes, their descriptions and the status of the transaction are detailed below:
| Code | Message/Description (Returned from Gateway) | Bank Meaning | Successful? | Next Steps |
|---|---|---|---|---|
| 00 | Approved | Approved | Yes | |
| 01 | Refer to Card Issuer | Transaction Declined | No | The customer needs to contact their card issuer for more information. |
| 02 | Refer to Card Issuer | Transaction Declined | No | The customer needs to contact their card issuer for more information. |
| 03 | No Merchant | Merchant configuration error | No | Check the merchant details provided. |
| 04 | Refer to Card Issuer | Card marked as Lost or Stolen | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 05 | Refer to Card Issuer | Do Not Honor | No | The customer needs to contact their card issuer for more information. |
| 06 | Merchant/Acquirer Error | Error - Original Not Found or similar | No | |
| 07 | Refer to Card Issuer | Card marked as lost or stolen (Pick Up Card - Special) | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 08 | Approved | Honour with Identification | Yes | |
| 09 | Acquirer Busy | Request in Progress (Local Terminal Error) | No | |
| 10 | Approved | Approved for Partial Amount | Yes | |
| 11 | Approved | Approved - VIP | Yes | |
| 12 | Invalid Transaction | Invalid Transaction Type | No | The customer needs to contact their card issuer to make sure their card can be used to make this type of purchase. |
| 13 | Invalid Amount | Invalid Amount | No | If the amount appears to be correct, the customer needs to check with their card issuer that they can make purchases of that amount. |
| 14 | Invalid Card Number | Invalid Card Number | No | The customer needs to contact their card issuer to check that the card is working correctly. |
| 15 | No Issuer | The card does not have a valid issuer in the scheme registration file | No | |
| 16 | Approved | Approved - Update Track 3 | Yes | |
| 17 | Declined | Not Used | No | |
| 18 | Declined | Not Used | No | |
| 19 | Declined | Re-enter last transaction | No | The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer. |
| 20 | Declined | Not Used | No | |
| 21 | Declined | Not Used | No | |
| 22 | Declined | Suspected Malfunction | No | The payment should be attempted again. If it still cannot be processed, try again later. |
| 23 | Declined | Unacceptable Transaction Fee | No | |
| 24 | Declined | Not Used | No | |
| 25 | Declined | Unable to Locate Record on File | No | |
| 26 | Declined | Not Used | No | |
| 27 | Declined | Not Used | No | |
| 28 | Declined | Not Used | No | |
| 29 | Declined | Not Used | No | |
| 30 | Declined | Format Error | No | |
| 31 | Bank Not Supported | Bank Not Supported by Switch/Route | No | |
| 32 | Declined | Not Used | No | |
| 33 | Expired Card | Expired Card (Capture) | No | The customer should use another card. |
| 34 | Declined | Suspected Fraud - Retain Card | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 35 | Declined | Card Acceptor, Contact Acquirer, Retain Card | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 36 | Declined | Restricted Card - Retain Card | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 37 | Declined | Contact Acquirer Security Department, Retain Card | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 38 | Declined | PIN Retries Exceeded (Capture Card) | No | The customer must use another card or method of payment. |
| 39 | Declined | No Credit Account | No | The customer needs to contact their card issuer to check that the card is working correctly. |
| 40 | Declined | Function Not Supported | No | |
| 41 | Declined | Lost Card | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 42 | Declined | No Universal (Credit-capable) account | No | The customer needs to contact their card issuer to check that the card is working correctly. |
| 43 | Declined | Stolen Card | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 44 | Declined | No Investment Account (Not Used) | No | The customer needs to contact their card issuer to check that the card is working correctly. |
| 45 | Declined | Not Used | No | |
| 46 | Declined | Not Used | No | |
| 47 | Declined | Not Used | No | |
| 48 | Declined | Not Used | No | |
| 49 | Declined | Not Used | No | |
| 50 | Declined | Not Used | No | |
| 51 | Insufficient Funds | Insufficient Funds | No | The customer should use an alternative payment method. |
| 52 | Declined | No Cheque Account | No | The customer needs to contact their card issuer to check that the card is working correctly. |
| 53 | Declined | No Savings Account | No | The customer needs to contact their card issuer to check that the card is working correctly. |
| 54 | Expired Card | Expired Card | No | The customer should use another card. |
| 55 | Declined | Incorrect PIN | No | The customer should try again using the correct PIN. |
| 56 | Declined | No Card Record - Check with Issuer | No | The customer needs to contact their card issuer to check that the card is working correctly. |
| 57 | Declined | Function Not Permitted to Card Holder | No | The customer needs to contact their card issuer to make sure their card can be used to make this type of purchase. |
| 58 | Declined | Function Not Permitted to Terminal | No | |
| 59 | Declined | Suspected Fraud | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 60 | Declined | Merchant to Contact Acquirer | No | |
| 61 | Declined | Exceeds Withdrawal Limit | No | |
| 62 | Declined | Restricted Card | No | |
| 63 | Declined | Not Used | No | |
| 64 | Declined | Not Used | No | |
| 65 | Declined | Exceeds Withdrawal | No | The customer’s card issuer has declined the transaction as the customer has exceeded the withdrawal frequency limit. |
| 66 | Declined | Not Used | No | |
| 67 | Declined | Not Used | No | |
| 68 | Declined | Not Used | No | |
| 69 | Declined | Not Used | No | |
| 70 | Declined | Not Used | No | |
| 71 | Declined | Not Used | No | |
| 72 | Declined | Not Used | No | |
| 73 | Declined | Not Used | No | |
| 74 | Declined | Not Used | No | |
| 75 | Declined | PIN Tries Exceeded | No | The customer must use another card or method of payment. |
| 76 | Declined | Not Used | No | |
| 77 | Declined | Not Used | No | |
| 78 | Declined | Not Used | No | |
| 79 | Declined | Not Used | No | |
| 80 | Declined | Not Used | No | |
| 81 | Declined | Not Used | No | |
| 82 | Declined | CVV Validation Error | No | The customer should try again using the correct CVV. |
| 83 | Declined | Not Used | No | |
| 84 | Declined | Not Used | No | |
| 85 | Declined | Not Used | No | |
| 86 | Declined | Not Used | No | |
| 87 | Declined | Not Used | No | |
| 88 | Declined | Not Used | No | |
| 89 | Declined | Not Used | No | |
| 90 | Declined - Please Retry | Cutoff In Progress - retry allowed | No | The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer. |
| 91 | Declined | Host or Switch Unavailable/Card Issuer Signed Off/Card Issuer Timed Out/Card Issuer Unavailable | No | The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer. |
| 92 | Declined | Unable to Route Transaction | No | The payment should be attempted again. If it still cannot be processed, try again later. |
| 93 | Declined | Cannot Complete, Violation Of The Law | No | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
| 94 | Declined | Duplicate Transaction | No | Check to see if a recent payment already exists. |
| 95 | Declined | Not Used | No | |
| 96 | Declined | System Error | No | The payment should be attempted again. If it still cannot be processed, try again later. |
| 99 | System Error - Contact Gateway if error persists | System Error | No | The payment should be attempted again. If it still cannot be processed, try again later. |