> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取卡片优惠

`getVirtualCardOffers` 查询可让你检索有效的虚拟卡优惠列表——每个优惠都是你可以发行的卡片计划。

<Info>
  **先决条件：** 具有 `CREATE_VIRTUALCARD` 范围的用户访问令牌。
</Info>

## 参数

* **`input`** (`GetVirtualCardOffersInput`): 可选输入，用于筛选虚拟卡优惠。

## GetVirtualCardOffersInput 字段

| 字段                | 类型                     | 描述                                | 是否必填 |
| :---------------- | :--------------------- | :-------------------------------- | :--- |
| `cardBrandLocked` | `Boolean`              | 指定虚拟卡优惠是否为品牌锁定。                   | 否    |
| `cardType`        | `VirtualCardOfferType` | 指定虚拟卡网络类型（`DEBIT` 或 `PREPAID`）。   | 否    |
| `cardNetwork`     | `VirtualCardNetwork`   | 指定虚拟卡网络类型（`MASTERCARD` 或 `VISA`）。 | 否    |

## 示例查询

```graphql theme={null}
query GetVirtualCardOffers {
    getVirtualCardOffers {
        offerId
        bin
        bankName
        rewardValue
        programLimits {
            dailyLimit
            weeklyLimit
            monthlyLimit
        }
        programName
    }
}
```

## cURL 示例

```curl theme={null}
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 排序。

```json theme={null}
{
  "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`        | 此虚拟卡计划提供的赚取速率或奖励百分比。  |

## 下一步

<CardGroup cols={2}>
  <Card title="创建虚拟卡" icon="credit-card" href="/features/create-card">
    将你选定的 `offerId` 传入 `createVirtualCard`。
  </Card>

  <Card title="卡片关联优惠" icon="badge-percent" href="/features/card-linked-offers">
    特定商户优惠，可在基础计划之上叠加额外奖励。
  </Card>
</CardGroup>