# API02007: Token Refresh Failed

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

The POS tried to automatically renew your authentication session, but the refresh request failed. This typically means you'll need to log in again.

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

* **Refresh token expired** — The refresh token itself has expired
* **Refresh token revoked** — An admin invalidated all sessions
* **Server error** — The server couldn't process the refresh request
* **Network issue** — Connection problem during refresh attempt

## 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")

The most reliable fix:

1. Log out of the POS
2. Log back in with your credentials
3. This creates a fresh session with new tokens

### 2. Check Network Connection[​](#2-check-network-connection "Direct link to 2. Check Network Connection")

If refresh is failing due to network issues:

* Verify your internet connection
* Try accessing your WordPress site in a browser
* Wait a moment and try again

### 3. Check Server Status[​](#3-check-server-status "Direct link to 3. Check Server Status")

If the server is having issues:

* Verify WordPress is running properly
* Check for PHP errors in your server logs
* Ensure the authentication plugin is active

### 4. Clear Session Data[​](#4-clear-session-data "Direct link to 4. Clear Session Data")

If issues persist:

* Clear the POS app cache
* Remove stored credentials
* Start fresh with a new login

## Automatic Token Refresh[​](#automatic-token-refresh "Direct link to Automatic Token Refresh")

WCPOS automatically refreshes tokens before they expire to maintain your session. If this process fails repeatedly, there may be a configuration issue that needs attention.

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

* [API02002](/error-codes/API02002.md) — Token Expired
* [API02008](/error-codes/API02008.md) — Refresh Token Invalid
* [API02009](/error-codes/API02009.md) — Refresh Token Expired