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

# Configurar el PIN de la tarjeta virtual

La mutación `setVirtualCardPIN` te permite configurar un PIN en tarjetas virtuales elegibles que aún no tienen un PIN configurado. Al crear tarjetas virtuales a través de la API de Fluz, tus tarjetas se crean sin establecer el PIN. La mayoría de las veces, no lo necesitarás. Sin embargo, si deseas configurar uno, puedes usar esta mutación para identificar y actualizar automáticamente todas las tarjetas que admiten un PIN, pero que aún no lo tienen configurado.

<Info>
  **Requisitos previos:** un token de acceso de usuario con el alcance `CREATE_VIRTUALCARD`. El PIN que configures debe coincidir con tu PIN de usuario.
</Info>

<Note>
  Esta mutación agrega las tarjetas elegibles a una cola para su procesamiento. La actualización real de los PIN puede tardar varios minutos; la respuesta indica si el encolado fue exitoso, no si cada tarjeta ya ha sido actualizada.
</Note>

## Argumentos

* **`input`** (`SetVirtualCardPINInput!`): El objeto de entrada que contiene el PIN que se establecerá en las tarjetas. Debe coincidir con tu PIN de usuario.

## Mutación de ejemplo

```graphql theme={null}
mutation {
  setVirtualCardPIN(input: { pin: "1234" }) {
    success
    pinError
  }
}
```

## 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 { setVirtualCardPIN(input: { pin: \"1234\" }) { success pinError } }"
  }'
```

## Respuesta de ejemplo

```json theme={null}
{
  "data": {
    "setVirtualCardPIN": {
      "success": true,
      "pinError": null
    }
  }
}
```

## Campos de la respuesta

| Field      | Type      | Description                                                                               |
| ---------- | --------- | ----------------------------------------------------------------------------------------- |
| `success`  | `Boolean` | Indica si la solicitud para configurar PIN se encoló correctamente para su procesamiento. |
| `pinError` | `String`  | Texto que te alertará si hubo un error al verificar tu PIN.                               |

## Ejemplo de código

<Recipe slug="set-virtual-card-pin" title="Configurar el PIN de la tarjeta virtual" />

## Próximos pasos

<Card title="Aprovisionamiento por push a billetera digital" icon="smartphone" horizontal href="/digital-wallet-push-provisioning">
  Envía una tarjeta virtual a Apple Pay o Google Wallet para pagar con toque.
</Card>

<StickyContactSalesBanner />