Get Virtual Card Offers

The getVirtualCardOffers query allows you to retrieve a list of active virtual card offers. This query requires the CREATE_VIRTUALCARD scope.

Arguments

input (GetVirtualCardOffersInput): Optional input to filter the virtual card offers.

GetVirtualCardOffersInput Fields

Field	Type	Description	Required
`cardBrandLocked`	`Boolean`	Specify if virtual card offers are brand locked.	No
`cardType`	`VirtualCardOfferType`	Specify virtual card network type (`DEBIT` or `PREPAID`).	No
`cardNetwork`	`VirtualCardNetwork`	Specify virtual card network type (`MASTERCARD` or `VISA`).	No

Sample Query

query GetVirtualCardOffers {
    getVirtualCardOffers {
        offerId
        bin
        bankName
        rewardValue
        programLimits {
            dailyLimit
            weeklyLimit
            monthlyLimit
        }
        programName
    }
}

cURL Example

curl -X POST \
  https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_USER_ACCESS_TOKEN' \
  -d '{
    "query": "query { getVirtualCardOffers(input: { cardType: DEBIT, cardNetwork: MASTERCARD }) { offerId programName bin bankName programLimits { dailyLimit weeklyLimit monthlyLimit } rewardValue } }"
  }'

Sample Response

Offers are sorted by rewardValue.

{
  "data": {
    "getVirtualCardOffers": [
      {
        "offerId": "offer-id-1",
        "programName": "Example Card Program A",
        "bin": "543210",
        "bankName": "Bank of Examples",
        "programLimits": {
          "dailyLimit": "500.00",
          "weeklyLimit": "2000.00",
          "monthlyLimit": "5000.00"
        },
        "rewardValue": "1.5%"
      },
      {
        "offerId": "offer-id-2",
        "programName": "Example Card Program B",
        "bin": "456789",
        "bankName": "Another Bank",
        "programLimits": {
          "dailyLimit": "1000.00",
          "weeklyLimit": "4000.00",
          "monthlyLimit": "10000.00"
        },
        "rewardValue": "1%"
      }
    ]
  }
}

Response Field Explanations

offer_id (String): The unique identifier for the virtual card offer.
program_name (String): The name of the virtual card program or merchant.
bin (String): The Bank Identification Number (BIN) associated with the virtual card offer.
bank_name (String): The name of the issuing bank for this virtual card offer.
program_limits (ProgramLimits): An object detailing the spending limits for this program.
- daily_limit (String): The maximum amount that can be spent daily on cards from this program.
- weekly_limit (String): The maximum amount that can be spent weekly on cards from this program.
- monthly_limit (String): The maximum amount that can be spent monthly on cards from this program.
rewardValue (String): The earn rate or reward percentage offered by this virtual card program.

Code Example:

Want to learn more? Contact us at [email protected]

Speak with our experts for more info or to request a demo.