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 |