Skip to main content
Visa Card Eligibility Service

VCES status codes and descriptions

Available for use by:
Issuer banks Acquirer banks Merchants Independent developers Issuer banks for small businesses

Visa Card Eligibility Service (VCES) returns a business-logic status code and description with every Validate, Prepay, Redeem, iFrame Token, Validate Result, Prepay iFrame, iFrame Redemption, Validate iFrame, and Redeem iFrame call.

VCES Status Codes

Status Code HTTP Status Description Details Operations
000 200 Success Successful validation Validate, Validate Result, Validate iFrame
001 200 Ineligible card for this program Ineligible validation Validate, Validate Result, Validate iFrame
003 200 Success validations limit reached Validation limit reached Validate, Validate Result, Validate iFrame
004 200 Redemptions limit reached Redemption limit reached Validate, Validate Result, Validate iFrame
005 200 True (Response to Prepayment request) Successful prepay Prepay, Prepay iFrame
006 200 False (response to Prepayment request) Ineligible prepay Prepay, Prepay iFrame
007 200 Prepayment validation Success But card is ineligible Prepay and Validate match but validation was ineligible Prepay, Prepay iFrame
008 200 Redemption transaction successfully matched to 'ineligible' transactions Correlation ID exists but redemption is ineligible Redeem, iFrame Redemption, Redeem iFrame
009 200 Redemption transaction unsuccessfully matched Correlation ID does not exist Redeem, iFrame Redemption, Redeem iFrame
011 200 Redemption transaction success Successful redemption Redeem, iFrame Redemption, Redeem iFrame
016 200 Redemption transaction for given vendor and correlation Id already exists Attempt to redeem using Correlation ID already redeemed Redeem, iFrame Redemption, Redeem iFrame
017 200 Validation and Redemption transaction for given vendor and correlation Id already exists Correlation ID used during validation is already redeemed Validate Result
018 200 ValidationResult transaction successfully matched to ineligible transactions Ineligible validation Validate Result
019 200 ValidationResult transaction unsuccessfully matched Correlation ID does not exist Validate Result
020 200 Token Request for submitted correlation ID and vendor is expired Expired iFrame token iFrame Token
021 200 Token Request for submitted correlation ID and vendor is already used iFrame token already used iFrame Token
022 200 Invalid Transaction. Please verify iFrame / Web Service used for first operation but a different API used for subsequent operations All
023 200 Vendor is not configured for NxtGen iFrame. Please verify Not configured for iFrame iFrame Token
024 200 Reverse Redemption request for submitted correlation ID and vendor already exists Reverse Redemption already performed Redeem, iFrame Redemption, Redeem iFrame
025 200 Reverse Redemption transaction unsuccessfully matched Correlation ID does not exist to perform Reverse Redemption Redeem, iFrame Redemption, Redeem iFrame
026 200 Reverse redemption successful Successful Reverse Redemption Redeem, iFrame Redemption, Redeem iFrame
027 200 Reverse redemption not possible Reverse Redemption attempted outside the allowed period for redemptions Redeem, iFrame Redemption, Redeem iFrame
028 200 Reverse redemption is not set for the selected vendor Reverse Redemption not enabled Redeem, iFrame Redemption, Redeem iFrame
029 200 Vendor is not configured for this transaction. Please verify iFrame implementation trying to invoke Web Service APIs or vice versa Validate, Validate Result, Validate iFrame
034 200 Partial Success Validation operation is partially successful based on redemption configuration Validate, Validate Result, Validate iFrame
101 400 Invalid Vendor Unique Id VUID has more than 20 characters or less than 10 characters All
102 400 Correlation ID length error Correlation ID has less than 10 or more than 100 characters All
103 400 Vendor RequestTimeStamp format error Time stamp is invalid, not within the timeframe, or not in UTC format All
104 400 Card Account format error PAN is not 16 digits Validate, Prepay, Redeem
105 400 Invalid request object. Please check Any required field is empty All
107 400 Invalid input More than one of PAN, Token, or Alias ID was passed, or spaces were passed in a value, or an Alias ID not in the system was sent, or a negative numberOfAdditionalRedemptions was sent All
201 400 Vendor Unique Id is invalid VUID does not exist or is inactive All
300 500 System Exception Service interruption caused by VCES or an upstream system not returning data All