# 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, and only after the check below:

Check for unsaved work first

Clearing local data or reinstalling the app deletes anything on this device that hasn't reached your store — including sales taken while offline, open carts, and edits that didn't save. Before you clear anything, open **Store health → Database** and check nothing is listed as held or as never having reached your server, then **Store health → Logs** for **0 stuck records** and **0 changes waiting to send**; then finish or note every open cart. If your WCPOS has no Store health page, update WCPOS first, then check. If anything is listed or waiting, or you can't check, don't clear — ask your store owner or contact support.

* 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
