Error and Response
Gateway Error Codes
This page provides a list of error codes returned by the gateway, along with descriptions and suggested actions. Error codes are organized by Entity Level and Product Level to help identify where the error applies.
Understanding Entity Level and Product Level
Entity Level
Entity-level rules apply to the merchant’s operational region or country. These settings enforce restrictions and policies specific to geographical areas.
Example: Blocking transactions originating from certain card countries or IP addresses based on merchant location.
Example: Blocking transactions originating from certain card countries or IP addresses based on merchant location.
Product Level
Product-level rules are specific to individual products or services within the gateway, like “Pay by Link” or “Subscription.” These manage behaviors and restrictions tied to each product.
Example: Setting refund velocity limits or transaction thresholds for a specific product.
Example: Setting refund velocity limits or transaction thresholds for a specific product.
| Error Code | Response Code | Applied Level | Risk Rule | Error Message |
|---|---|---|---|---|
| ERR3001 | -8000 | Entity Level | Blacklist | “Card Country is found on Entity’s blacklist” |
| ERR3002 | -8001 | Entity Level | IP Address | “Customer IP is found on Entity’s blacklist” |
| ERR3003 | -8002 | Entity Level | BIN Blocking | “Card BIN is found on Entity’s blacklist” |
| ERR3004 | -8003 | Entity Level | PAN Blocking | “PAN is found on Entity’s blacklist” |
| ERR3005 | -8004 | Entity Level | Blacklist | “Card Country is found on Issuing Country blacklist” |
| ERR3006 | -8005 | Product Level | Threshold Amount | “Transaction amount ‘undefined 0’ has exceeded the max threshold limit” |
| ERR3007 | -8007 | Product Level | IP Address | “Customer IP Address is found on MID blacklist” |
| ERR3008 | -8008 | Product Level | PAN Limit | “Velocity check - Same card number has been used more than 0 times in the last 0 minutes.” |
| ERR3009 | -8009 / -8013 | Product Level | PAN Limit | “Velocity check - Same card number has been used more than 0 times in the last 0 hours.” |
| ERR3010 | -8010 | Product Level | PAN Limit | “Velocity check - Same card number has been used more than 0 times in the last 0 days.” |
| ERR3011 | -8011 | Product Level | PAN Limit | “Velocity check - Same card number has been used more than 0 times in the last 0 months.” |
| ERR3012 | -8012 | Product Level | IP Limit | “Velocity check - Attempts from same IP Address exceeds 0 times over the last 0 minutes.” |
| ERR3013 | -8013 | Product Level | IP Limit | “Velocity check - Attempts from same IP Address exceeds 0 times over the last 0 hours.” |
| ERR3014 | -8014 | Product Level | IP Limit | “Velocity check - Attempts from same IP Address exceeds 0 times over the last 0 days.” |
| ERR3015 | -8015 | Product Level | IP Limit | “Velocity check - Attempts from same IP Address exceeds 0 times over the last 0 months.” |
| ERR3016 | -8006 | Product Level | Threshold Amount | “Transaction amount ‘undefined 0’ is less than the min threshold limit” |
| ERR3017 | -8017 | Product Level | IP Address | “Customer IP Address not whitelisted” |
| ERR3018 | -8018 | Product Level | BIN | “BIN not whitelisted” |
| ERR3019 | -8019 | Product Level | Refund Limit | “Velocity check - Refund limit exceeded” |
| ERR3020 | -8020 | Product Level | Refund Volume | “Velocity check - Refund Volume limit exceeded” |
| VAL0035 | -1 | Product Level | “Invalid card holder name.” | |
| ERR0204 | -1 | Product Level | Refund Volume | “You don’t have balance amount for refund.” |