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

# Actualizar un token de acceso vencido

Cuando el token de acceso de usuario actual venza, intercambia el token de actualización que recibiste junto con él por uno nuevo; no hay necesidad de volver a ejecutar todo el flujo de credenciales.

<Info>
  **Necesitarás:** tu `API Key` (usa tu Test API Key en el sandbox) y el `Refresh Token` devuelto cuando se emitió el token de acceso.
</Info>

<Steps>
  <Step title="Llama a refreshUserAccessToken">
    Reemplaza `<YOUR_SANDBOX_API_KEY>` y `<YOUR_REFRESH_TOKEN>` con tus credenciales:

    ```bash theme={null}
    curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
      -H "Authorization: Basic <YOUR_SANDBOX_API_KEY>" \
      -H "Content-Type: application/json" \
      -d '{
        "query": "mutation refreshUserAccessToken($refreshToken: String!) { refreshUserAccessToken(refreshToken: $refreshToken) { token refreshToken scopes } }",
        "variables": {
          "refreshToken": "<YOUR_REFRESH_TOKEN>"
        }
      }'
    ```
  </Step>

  <Step title="Almacena el nuevo token">
    La respuesta contiene un token de acceso nuevo con los mismos scopes que el token emitido anteriormente:

    ```json theme={null}
    {
      "data": {
        "refreshUserAccessToken": {
          "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
          "refreshToken": "0cb671d0b1aaa727c96874270cd15c2f",
          "scopes": ["LIST_PURCHASES", ...]
        }
      }
    }
    ```

    Copia el valor de `token` y úsalo en el encabezado `Authorization: Bearer <YOUR_USER_ACCESS_TOKEN>` para solicitudes autenticadas, exactamente como antes. Guarda también el nuevo `refreshToken`: lo necesitarás para la próxima actualización.
  </Step>
</Steps>

<Tip>
  Actualiza de forma proactiva, antes de que venza el token actual, en lugar de esperar un `401` y actualizar de forma reactiva. Esto evita que las solicitudes fallen bajo carga.
</Tip>

## Próximos pasos

<Card title="Inicio rápido: tu primera compra de tarjeta de regalo" icon="gift" horizontal href="/quickstart">
  Con un token válido en mano, ejecuta el flujo feliz de extremo a extremo: deposita fondos, compra una tarjeta de regalo y revélala en el sandbox.
</Card>