Skip to main content
Version: 1.x

SY02002: Service Unavailable

What This Means​

A required service or component is not available. The POS depends on various services to function, and one of them is currently inaccessible.

Common Causes​

  • Background service stopped — A required service isn't running
  • System resource issue — Not enough resources to start the service
  • Dependency failure — A service this depends on failed
  • Startup issue — Service failed to start properly
  • Server error — The WooCommerce server returned a 5xx error

Server Error Mapping​

This error code is triggered when the server returns:

Server CodeSource
HTTP 5xxAny server error response (500, 502, 503, 504, etc.)

How to Fix​

1. Restart the Application​

Close and reopen the POS:

  1. Fully close the application
  2. Wait a few seconds
  3. Start it again

2. Restart Your Device​

A full restart often resolves service issues:

  1. Save any important work
  2. Restart your computer
  3. Try the POS again

3. Check System Resources​

Ensure system resources are available:

  • Close unnecessary applications
  • Check memory usage
  • Check disk space

4. Update the Application​

Ensure you're on the latest version:

  • Check for available updates
  • Install any pending updates
  • Restart after updating

5. Reinstall if Necessary​

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.

Only if your store's site opens normally in a browser, the steps above didn't help, and only after the check above:

  1. Uninstall the application
  2. Restart your device
  3. Download the latest version
  4. Install fresh

Browser-Specific (Web Version)​

For the web version:

  • Ensure JavaScript is enabled
  • Check that required browser features aren't blocked
  • Try a different browser
  • Disable browser extensions that might interfere

When to Contact Support​

If this error persists:

  • Note when it occurs
  • Check if specific actions trigger it
  • Report with details for investigation