> ## 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.

# 锁定虚拟卡

`lockVirtualCard` 变更用于锁定一张现有的虚拟卡，阻止其进行后续交易。

<Info>
  **先决条件：** 具有 `EDIT_VIRTUALCARD` 范围的用户访问令牌，以及要锁定的卡片的 `virtualCardId`。
</Info>

## 参数

* **`input`** (`LockVirtualCardInput!`): 包含要锁定的虚拟卡 ID 的输入对象。

## LockVirtualCardInput 字段

| 字段              | 类型      | 描述       | 必填 |
| :-------------- | :------ | :------- | :- |
| `virtualCardId` | `UUID!` | 要锁定的虚拟卡。 | 是  |

## 示例变更

```graphql theme={null}
mutation {
  lockVirtualCard(input: { virtualCardId: "07df5653-43a8-4532-9881-3ab5857bbe11" }) {
    virtualCardId
    locked
  }
}
```

## 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": "mutation { lockVirtualCard(input: { virtualCardId: \"07df5653-43a8-4532-9881-3ab5857bbe11\" }) { virtualCardId locked } }"
  }'
```

## 示例响应

```json theme={null}
{
  "data": {
    "lockVirtualCard": {
      "virtualCardId": "07df5653-43a8-4532-9881-3ab5857bbe11",
      "locked": true
    }
  }
}
```

## 响应字段

| 字段              | 类型        | 描述                            |
| --------------- | --------- | ----------------------------- |
| `virtualCardId` | `UUID`    | 被锁定目标虚拟卡的唯一标识符。               |
| `locked`        | `Boolean` | 如果卡片成功锁定为 `true`，否则为 `false`。 |

<Tip>
  若要在首次授权成功后自动锁定卡片，可在创建时设置 `lockCardNextUse: true` —— 参见 [创建虚拟卡](/features/create-card)。
</Tip>

## 后续步骤

<Card title="解锁虚拟卡" icon="lock-open" horizontal href="/features/unlock-virtual-card">
  重新启用已锁定的卡片，使授权再次成功。
</Card>