getVirtualCardOffers 查询可让你检索有效的虚拟卡优惠列表——每个优惠都是你可以发行的卡片计划。
先决条件： 具有
CREATE_VIRTUALCARD 范围的用户访问令牌。参数
input(GetVirtualCardOffersInput): 可选输入，用于筛选虚拟卡优惠。
GetVirtualCardOffersInput 字段
| 字段 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
cardBrandLocked | Boolean | 指定虚拟卡优惠是否为品牌锁定。 | 否 |
cardType | VirtualCardOfferType | 指定虚拟卡网络类型（DEBIT 或 PREPAID）。 | 否 |
cardNetwork | VirtualCardNetwork | 指定虚拟卡网络类型（MASTERCARD 或 VISA）。 | 否 |
示例查询
query GetVirtualCardOffers {
getVirtualCardOffers {
offerId
bin
bankName
rewardValue
programLimits {
dailyLimit
weeklyLimit
monthlyLimit
}
programName
}
}
cURL 示例
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 } }"
}'
示例响应
优惠按照 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%"
}
]
}
}
响应字段
| 字段 | 类型 | 描述 |
|---|---|---|
offerId | String | 虚拟卡优惠的唯一标识符。 |
programName | String | 虚拟卡计划或商户的名称。 |
bin | String | 与该虚拟卡优惠关联的银行识别号（BIN）。 |
bankName | String | 该虚拟卡优惠的发卡银行名称。 |
programLimits | ProgramLimits | 详细说明此计划消费限额的对象。 |
programLimits.dailyLimit | String | 此计划中卡片每天可消费的最高金额。 |
programLimits.weeklyLimit | String | 此计划中卡片每周可消费的最高金额。 |
programLimits.monthlyLimit | String | 此计划中卡片每月可消费的最高金额。 |
rewardValue | String | 此虚拟卡计划提供的赚取速率或奖励百分比。 |
下一步
创建虚拟卡
将你选定的
offerId 传入 createVirtualCard。卡片关联优惠
特定商户优惠，可在基础计划之上叠加额外奖励。