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.

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.
This distinction helps merchants and developers troubleshoot errors effectively and ensures that compliance and restrictions are properly managed across regions and products.
Error CodeResponse CodeApplied LevelRisk RuleError Message
ERR3001-8000Entity LevelBlacklistTransaction is restricted
ERR3002-8001Entity LevelIP AddressTransaction is restricted
ERR3003-8002Entity LevelBIN BlockingTransaction is restricted
ERR3004-8003Entity LevelPAN BlockingTransaction is restricted
ERR3005-8004Entity LevelBlacklistTransaction is restricted
ERR3006-8005Product LevelThreshold AmountAmount is outside the allowed range
ERR3007-8007Product LevelIP AddressTransaction is restricted
ERR3008-8008Product LevelPAN LimitTransaction is restricted
ERR3009-8009 / -8013Product LevelPAN LimitRisk rule decline
ERR3010-8010Product LevelPAN LimitRisk rule decline
ERR3011-8011Product LevelPAN LimitRisk rule decline
ERR3012-8012Product LevelIP LimitRisk rule decline
ERR3013-8013Product LevelIP LimitRisk rule decline
ERR3014-8014Product LevelIP LimitRisk rule decline
ERR3015-8015Product LevelIP LimitRisk rule decline
ERR3016-8006Product LevelThreshold AmountAmount is outside the allowed range
ERR3017-8017Product LevelIP AddressTransaction is restricted
ERR3018-8018Product LevelBINTransaction is restricted
ERR3019-8019Product LevelRefund LimitInsufficient refund balance
ERR3020-8020Product LevelRefund VolumeInsufficient refund balance
VAL0035-1Product LevelInvalid card holder name.
ERR0204-1Product LevelRefund VolumeInsufficient refund balance

Additional Resources