# API02009: Refresh Token Expired

## What This Means[​](#what-this-means "Direct link to What This Means")

Your refresh token has exceeded its lifetime and can no longer be used to obtain new access tokens. Unlike access tokens (which expire quickly), refresh tokens typically last days or weeks but do eventually expire.

## Common Causes[​](#common-causes "Direct link to Common Causes")

* **Extended inactivity** — You haven't used the POS for a long time
* **Short token lifetime** — Server configured with short refresh token expiration
* **Clock skew** — Device or server time is significantly off

## How to Fix[​](#how-to-fix "Direct link to How to Fix")

### 1. Log In Again[​](#1-log-in-again "Direct link to 1. Log In Again")

When the refresh token expires, you must authenticate again:

1. Log out of the POS
2. Enter your credentials
3. A new refresh token will be issued

### 2. Use POS Regularly[​](#2-use-pos-regularly "Direct link to 2. Use POS Regularly")

To avoid this in the future:

* Use the POS regularly to keep tokens fresh
* Tokens are refreshed automatically when you're active
* Extended periods of inactivity will require re-login

### 3. Check Time Settings[​](#3-check-time-settings "Direct link to 3. Check Time Settings")

Ensure accurate time on all systems:

* Enable automatic time sync on your device
* Verify server time is correct
* Time differences can cause premature expiration

### 4. Adjust Token Lifetime (Advanced)[​](#4-adjust-token-lifetime-advanced "Direct link to 4. Adjust Token Lifetime (Advanced)")

If tokens expire too quickly for your needs, a server administrator can adjust the refresh token lifetime in the authentication settings.

## Related Errors[​](#related-errors "Direct link to Related Errors")

* [API02002](/error-codes/API02002.md) — Token Expired
* [API02007](/error-codes/API02007.md) — Token Refresh Failed