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