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

# Bloquear tarjeta virtual

La mutación `lockVirtualCard` te permite bloquear una tarjeta virtual existente, evitando transacciones futuras.

<Info>
  **Requisitos previos:** un token de acceso de usuario con el alcance `EDIT_VIRTUALCARD`, y el `virtualCardId` de la tarjeta a bloquear.
</Info>

## Argumentos

* **`input`** (`LockVirtualCardInput!`): El objeto de entrada que contiene el ID de la tarjeta virtual a bloquear.

## Campos de LockVirtualCardInput

| Field           | Type    | Description                    | Required |
| :-------------- | :------ | :----------------------------- | :------- |
| `virtualCardId` | `UUID!` | La tarjeta virtual a bloquear. | Yes      |

## Mutación de ejemplo

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

## Ejemplo 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 } }"
  }'
```

## Respuesta de ejemplo

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

## Campos de la respuesta

| Field           | Type      | Description                                                               |
| --------------- | --------- | ------------------------------------------------------------------------- |
| `virtualCardId` | `UUID`    | El identificador único de la tarjeta virtual que fue objetivo de bloqueo. |
| `locked`        | `Boolean` | `true` si la tarjeta se bloqueó correctamente, `false` en caso contrario. |

<Tip>
  Para bloquear una tarjeta automáticamente después de su primera autorización exitosa, en su lugar configura `lockCardNextUse: true` al momento de la creación — consulta [Crear tarjeta virtual](/features/create-card).
</Tip>

## Próximos pasos

<Card title="Desbloquear una tarjeta virtual" icon="lock-open" horizontal href="/features/unlock-virtual-card">
  Vuelve a habilitar una tarjeta bloqueada para que las autorizaciones vuelvan a aprobarse.
</Card>