Skip to main content
Visa Card Eligibility Service

Getting started

API Developer Guide

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

Visa Card Eligibility Service (VCES) enables clients to verify cardholder eligibility for benefits, campaigns, offers, promotions, and rewards – and to report usage back to VCES in real time.

VCES is an eligibility verification product that lets issuers, acquirers, merchants, fintechs, processors, partners, and governments confirm real-time access to benefits, campaigns, offers, promotions, and rewards. Eligibility may be based on card attribute data, issuer portfolio data, or cardholder spend data. Once eligibility is confirmed, clients may report back usage to VCES for tracking and limiting additional usage.

VCES offers a Web Service API for clients with Payment Card Industry Data Security Standard (PCI DSS)-compliant Primary Account Number (PAN) data access and an iFrame API for clients without it or who wish to avoid handling PAN. See VCES APIs and VCES operations and APIs for details.

Key features and benefits

Visa Card Eligibility Service (VCES) provides eligibility validation, entitlement management, and integration capabilities that help organizations control access to offers, benefits, rewards, and other card-based programs.

Key features

VCES provides these capabilities to support eligibility management and entitlement control:

  • Real-Time Eligibility Checks – Validates a card's eligibility for benefits, campaigns, offers, promotions, and rewards instantly, at the point of service.
  • Rule-Based Access Control – Grants access based on pre-defined eligibility criteria, ensuring only qualifying credentials receive benefits.
  • Redemption Tracking – Records and tracks redemption activity, allowing accurate enforcement of usage limits and visibility into how entitlements are consumed over time.
  • Billing Entity Resolution – Returns the responsible billing entity in the eligibility response, identifying who is billed at the point of decision.
  • Flexible Integration Options – Supports multiple integration touchpoints, enabling clients to tailor the user experience across channels.

Benefits

These capabilities help organizations implement and manage eligibility-driven programs more effectively:

  • Simplified Eligibility Verification – Verifies that a credential meets complex eligibility rules before unlocking value.
  • Portfolio-Specific Offerings – Builds tailored offerings and measures their impact on spend and loyalty.
  • Redemption Control – Governs entitlement usage with redemption limits over defined time periods.
  • Tiered Access Levels – Configures multiple eligibility levels per offer to create differentiated access tiers from a single setup.
  • Real-Time Decisions – Validates eligibility at the point of need, so access decisions keep pace with the customer experience.
  • Flexible Integration – Connects through multiple touchpoints, letting you embed eligibility checks wherever the user experience calls for them.
  • Enriched Response Data – Returns qualifying card attributes alongside the eligibility decision when enabled, to support downstream personalization.
  • Reduced Entitlement Misuse – Restricts access to credentials that meet defined criteria, protecting premium and exclusive offers from unqualified or repeat use.

How VCES works

Visa Card Eligibility Service (VCES) compares card account attributes, issuer portfolio assignments, and spend data against pre-configured program rules to determine eligibility.

Eligibility criteria can range from simple product-type validation to complex criteria using multiple criteria at the same time.

There are three main operations: eligibility check (Validation operations), confirming the same credential is used at checkout that was validated as eligible (Prepay operations), and usage tracking (Redemption operations). Validation and redemption operations are the core components of VCES.

Getting access to VCES

Anyone can access Visa Card Eligibility Service (VCES) in the Sandbox environment by creating an account with Visa Developer Center (VDC), creating a project, and selecting the VCES APIs.

Access to Certification and Production requires approval from Visa. Certification and Production access involves two main steps:

  • Engagement – Contact your Visa representative and develop a customer journey. Once a high-level design is achieved, the VCES Product office may be engaged to understand the implementation, provide guidance, and establish next steps. This step is required to move out of the Sandbox environment.
  • Onboarding – Basic partner details are captured in your Visa Developer Center (VDC) project, including desired APIs. VCES operates in three environments: Sandbox (SBX), Certification (CTE), and Production (PROD). You go through each environment, where you may test your implementation. See Environments for details.

VCES APIs

Visa Card Eligibility Service (VCES) offers API services so clients can check cardholder eligibility for benefits, offers, and promotions whether or not they have Payment Card Industry Data Security Standard (PCI DSS)-compliant access to Primary Account Number (PAN) data.

Visa Card Eligibility Service (Web Service)

A system-to-system integration called directly from the client's backend. Clients must be PCI compliant and provide a Self-Assessment Questionnaire (SAQ-D) or Report on Compliance (RoC). Message Level Encryption (MLE) is required.

The Web Service API provides these operations:

  • Validate – Checks credential eligibility.
  • Prepay – Confirms the same credential that was validated as eligible is submitted at checkout before payment submission.
  • Redeem – Notifies Visa Card Eligibility Service (VCES) of completed business process and to store the data for entitlement control.

Visa Card Eligibility Service (iFrame)

A plug-and-play, white-labeled web widget that runs card validation inside the client's own site, without the client ever handling PAN. Visa hosts the actual card-entry surface on PCI-compliant servers, so PCI DSS compliance is not required. Requires hosting a CSS and callback URL.

The iFrame API provides these operations:

  • iFrame Token – Obtains a token to load an instance of the VCES iFrame.
  • Validate Result – Returns the eligibility response for a specific instance of a user submitting their PAN via the iFrame. Validate Result is used once a client receives a callback notification from VCES.
  • iFrame Redemption – Notifies VCES of completed business process and to store the data for entitlement control.
  • Validate iFrame – Revalidates a PAN previously entered by a user. This requires an Alias ID, which can be provided as a response attribute from Validate Result.
  • Prepay iFrame – Confirms the same PAN that was validated as eligible is submitted at checkout before payment submission. This flow requires multiple touchpoints for a user.
  • Redeem iFrame – Notifies VCES of completed business process and to store the data for entitlement control. This requires an Alias ID, which can be provided as a response attribute from Validate Result.

For more information about VCES operations and APIs, see VCES operations and APIs.

Eligibility criteria

There are numerous configurable criteria which Visa Card Eligibility Service (VCES) can leverage for eligibility qualification. These Rule Attributes can be used in conjunction with each other (AND), excluded from larger data sets (EXCLUDE), or grouped together in Rule Groups to allow different sets to qualify for the same Eligibility Level (OR).

Current criteria are:

  • Issuance Geography Attributes
    • Region of issuance
    • Country of issuance
  • Issuer / Account Identification Attributes
    • Issuer Business ID (BID), sometimes referred to as User BID
    • Bank Identification Number (BIN) – set at issuance
    • Account Range – set at issuance
    • Rewards Program Identification Number (RPIN) – from Account Level Management
  • Product Attributes
    • Product Type – set at issuance or from Account Level Management
    • Product Sub-Type – set at issuance
    • Product Platform Code – set at issuance
  • Funding Source Attributes
    • Funding Source Type – set at issuance
    • Funding Source Sub-Type – set at issuance
  • Card Grouping / Account-Level Management Attributes
    • Card Group ID – from Account Level Management
    • Card Group Type – from Account Level Management
    • Primary Card Indicator – from Account Level Management
    • Benefit Qualification Indicator – from Account Level Management
  • Visa Digital Benefits Platform Attributes
    • Benefit Type Code – from Visa Digital Benefits Platform
    • Benefit ID – from Visa Digital Benefits Platform
    • Spend Tier Configuration ID – from Visa Digital Benefits Platform
  • Controls / Limits – Redemption Limits – from VCES

Eligibility levels

Eligibility Levels essentially create a tiering system. They allow for multiple criteria sets to be used to determine the highest applicable tier the credential qualifies for in the program. Clients use the Eligibility Level in the Validation operations to determine what to present a user in terms of service.

Product-tier discount example

Visa product type tiers (Signature, Signature Preferred, Infinite, and Infinite Privilege) tied to discount percentages (5%, 7%, 10%, and 12%). The Vendor Unique ID (VUID) may be configured so each discount tier is associated with a specific Eligibility Level.

Spend-gating benefit example

Spend gating (no spend, less than or equal to USD 100 spend, greater than USD 100 but less than or equal to USD 500 spend, or greater than USD 500 spend) tied to free movie tickets (0, 1, 2, or 3). The VUID may be configured so each free ticket tier is associated with a specific Eligibility Level.

A credential may move between these Eligibility Levels based on their qualified spend activity. By calling Visa Card Eligibility Service (VCES), the client discovers the tiering at that moment in time.