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

# Descripción general de edición de tarjeta

La mutación `editVirtualCard` te permite actualizar varios detalles de una tarjeta virtual existente, como límites de gasto, fecha de bloqueo y apodo.

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

## Argumentos

* **`input`** (`EditVirtualCardInput!`): El objeto de entrada que contiene el ID de la tarjeta virtual y los campos a actualizar.

## Campos de EditVirtualCardInput

| Field                  | Type                            | Description                                                        | Required |
| :--------------------- | :------------------------------ | :----------------------------------------------------------------- | :------- |
| `virtualCardId`        | `UUID!`                         | La tarjeta virtual a actualizar.                                   | Yes      |
| `spendLimit`           | `Float`                         | El monto máximo que puedes cargar a la tarjeta.                    | No       |
| `spendLimitDuration`   | `VirtualCardSpendLimitDuration` | Tipo de duración del límite de la tarjeta.                         | No       |
| `lockDate`             | `String`                        | La fecha en que la tarjeta será bloqueada. Formato: yyyy-mm-dd     | No       |
| `lockCardNextUse`      | `Boolean`                       | La configuración para bloquear la tarjeta después del próximo uso. | No       |
| `cardNickname`         | `String`                        | El apodo de la tarjeta.                                            | No       |
| `primaryFundingSource` | `VirtualCardFundingSource`      | Fuente de fondos principal para la tarjeta virtual.                | No       |
| `bankAccountId`        | `UUID`                          | El identificador único de la cuenta bancaria.                      | No       |
| `userCashBalanceId`    | `UUID`                          | El identificador único del saldo en efectivo del usuario.          | No       |

## 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 { editVirtualCard( input: { virtualCardId: \"07df5653-43a8-4532-9881-3ab5857bbe11\", spendLimit: 200.00, spendLimitDuration: \"MONTHLY\", cardNickname: \"Edited Card Nickname\", lockCardNextUse: false } ) { virtualCardId cardholderName expiryMonth expiryYear virtualCardLast4 status cardType initialAmount usedAmount createdAt authorizationSetting { virtualCardAsaSettingsId lockDate dailySpendLimit monthlySpendLimit cardNickname lockCardNextUse } } }"
  }'
```

## Respuesta de ejemplo

```json theme={null}
{
  "data": {
    "editVirtualCard": {
      "virtualCardId": "07df5653-43a8-4532-9881-3ab5857bbe11",
      "userId": "00a2ec0a-255f-4fe7-85ad-2958dc8d3c72",
      "cardholderName": "John Doe",
      "expiryMonth": "12",
      "expiryYear": "27",
      "virtualCardLast4": "7890",
      "status": "ACTIVE",
      "cardType": "MULTI_USE",
      "initialAmount": 200,
      "usedAmount": 0,
      "createdAt": "2023-10-26T10:00:00Z",
      "authorizationSetting": {
        "virtualCardAsaSettingsId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "lockDate": "1875743999999",
        "dailySpendLimit": null,
        "monthlySpendLimit": "200.00",
        "cardNickname": "Edited Card Nickname",
        "lockCardNextUse": false
      }
    }
  }
}
```

## Campos de la respuesta

| Field                                           | Type                              | Description                                                                                                        |
| ----------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `virtualCardId`                                 | `UUID`                            | El identificador único de la tarjeta virtual que fue editada.                                                      |
| `cardholderName`                                | `String`                          | El nombre del titular asociado con la tarjeta virtual.                                                             |
| `expiryMonth`                                   | `String`                          | El mes de vencimiento de la tarjeta virtual.                                                                       |
| `expiryYear`                                    | `String`                          | El año de vencimiento de la tarjeta virtual.                                                                       |
| `virtualCardLast4`                              | `String`                          | Los últimos cuatro dígitos del número de la tarjeta virtual.                                                       |
| `status`                                        | `VirtualCardStatus`               | El estado actual de la tarjeta virtual.                                                                            |
| `cardType`                                      | `VirtualCardType`                 | El tipo de la tarjeta virtual (por ejemplo, `MULTI_USE`).                                                          |
| `initialAmount`                                 | `Float`                           | El monto inicial (límite de gasto) establecido en la tarjeta cuando fue creada.                                    |
| `usedAmount`                                    | `Float`                           | El monto total gastado en la tarjeta virtual.                                                                      |
| `createdAt`                                     | `DateTime`                        | La marca de tiempo cuando la tarjeta virtual fue creada originalmente.                                             |
| `authorizationSetting`                          | `VirtualCardAuthorizationSetting` | Un objeto que contiene la configuración de autorización de la tarjeta virtual, reflejando cualquier actualización. |
| `authorizationSetting.virtualCardAsaSettingsId` | `UUID`                            | El identificador único para esta configuración de autorización específica.                                         |
| `authorizationSetting.lockDate`                 | `String`                          | La fecha en que la tarjeta será bloqueada, si está configurada.                                                    |
| `authorizationSetting.dailySpendLimit`          | `String`                          | El límite de gasto diario, si aplica.                                                                              |
| `authorizationSetting.monthlySpendLimit`        | `String`                          | El límite de gasto mensual, si aplica.                                                                             |
| `authorizationSetting.cardNickname`             | `String`                          | El apodo actualizado de la tarjeta.                                                                                |
| `authorizationSetting.lockCardNextUse`          | `Boolean`                         | Indica si la tarjeta será bloqueada después de su próximo uso.                                                     |

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Bloquear una tarjeta virtual" icon="lock" href="/features/lock-virtual-card">
    Bloquea temporalmente todo el gasto en una tarjeta sin cerrarla.
  </Card>

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