Troubleshooting Guide

In case you encounter issues while using the WooCommerce POS Square Reader Native SDK Integration, refer to the following common solutions.

1. Socket Connection Issues

Socket Server Not Connected

If you see a "No Reader Found" message, your local socket connection may be interrupted.

  1. Check Node Server: Ensure your Node Server is running as required by the POS system.
  2. Reload POS: Sometimes a quick reload of the POS screen can re-establish the socket connection.
  3. Verify Configuration: Go to WooCommerce > Settings > Payments and ensure the POS Square Payment Gateway is enabled.

2. Invalid Credentials

Payment Fails at Checkout

If the Square Payment SDK returns an error during checkout:

  1. Check Tokens: Ensure your Access Token and Application ID are correct.
  2. Verify Mode: If you are using Sandbox Tokens, ensure that Test Mode is enabled.
  3. Expired Refresh Tokens: Check your Square Developer dashboard to ensure your tokens haven't expired.

3. Location ID Error

Payment Not Allowed at This Location

If you receive an error about your location:

  1. Verify Location ID: Go to your Square Dashboard and ensure the Location ID matches the one entered in WooCommerce settings.
  2. Active Location: Make sure the location is marked as Active in the Square developer portal.

4. Generic Support

If the issue persists, feel free to reach out to our support team:

Conclusion

The WooCommerce POS Square Reader Native SDK Integration is designed to provide a seamless payment experience for your business. We hope this guide helps you make the most of your POS and Square terminal integration.