API02007: Token Refresh Failed
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
- 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
1. Log In Again
The most reliable fix:
- Log out of the POS
- Log back in with your credentials
- This creates a fresh session with new tokens
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
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
If issues persist, and only after the check below:
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
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.