Order Status Sync
Keep order statuses synchronized between WooCommerce and Square.
Automatically sync order status changes between WooCommerce and Square in both directions.
Overview
With status sync enabled:
- Completing orders in WooCommerce updates Square
- Status changes in Square update WooCommerce
- Fulfillment states stay synchronized
- No manual status updates needed
WooCommerce → Square
When enabled, completing a WooCommerce order automatically updates Square.
Enable Woo to Square Status Sync
- Go to SWS Pro > Settings > Orders
- Find the Status Sync section
- Toggle on Woo → Square Status Sync
- Click Save Changes
What Happens
When a WooCommerce order is marked as completed:
- All Square fulfillments are marked as COMPLETED
- Square order state updates to COMPLETED
- Fulfillment timestamps are recorded
Square → WooCommerce
When enabled, Square order changes trigger WooCommerce updates via webhooks.
Enable Square to Woo Status Sync
- Go to SWS Pro > Settings > Orders
- Find the Status Sync section
- Toggle on Square → Woo Status Sync
- Configure which status changes to sync
- Click Save Changes
Available Options
| Option | Description |
|---|---|
| Auto-complete orders | Complete WooCommerce orders when Square order completes |
| Auto-cancel orders | Cancel WooCommerce orders when Square order is cancelled |
| Auto-process orders | Move orders to processing when Square fulfillment starts |
Webhook Triggers
Status sync from Square is triggered by:
order.updatedwebhookorder.fulfillment.updatedwebhook
Ensure webhooks are properly configured in your Square Developer Dashboard for real-time status sync.
Status Mapping
| Square Status | WooCommerce Status |
|---|---|
| COMPLETED | Completed |
| CANCELED | Cancelled |
| IN_PROGRESS | Processing |
Best Practices
Choose One Primary System
Decide whether WooCommerce or Square is your primary order management system and configure status sync accordingly to avoid conflicts.
Monitor Initial Setup
After enabling, monitor the first few orders to ensure status changes sync correctly in both directions.
Troubleshooting
Status not syncing to Square
- Verify Woo → Square sync is enabled
- Check that the WooCommerce order is linked to a Square order
- Review sync logs for API errors
Status not syncing from Square
- Verify Square → Woo sync is enabled
- Check webhook configuration in Square Dashboard
- Confirm the specific status option is enabled
- Review webhook logs for delivery issues
Status sync conflicts
- Avoid updating status in both systems simultaneously
- Check if both directions are enabled when issues occur
- Review order history for conflicting updates