Connection Troubleshooting

Resolve common connection issues between your Shopify store and OrderTrackify. Covers OAuth permission errors, fulfillment sync delays, webhook delivery failures, and how to reconnect a store if the access token has been revoked. Includes step-by-step diagnostic procedures.

Availability: Shopify support is implemented behind a feature flag, but direct Shopify onboarding in the OrderTrackify dashboard is currently labelled Coming soon. Use an authorised app installation link supplied by OrderTrackify; production availability depends on the deployment.

OAuth Problems

  • Use the canonical *.myshopify.com domain and an administrator allowed to install apps.
  • Restart the install if the OAuth state has expired or the callback domain does not match the configured app URL.
  • Confirm the deployment's API key, API secret, scopes, callback URL, and FEATURE_SHOPIFY setting.

Missing Fulfilments

Confirm the Shopify fulfilment contains a tracking number and inspect delivery for orders/create, orders/updated, fulfillments/create, or fulfillments/update. The receiver verifies Shopify HMAC signatures. There is no recurring 15-minute fallback order poll.

Reconnect

If Shopify revokes the token, reinstall through the authorised app flow or use reconnect after the deployment has valid OAuth credentials. A normal Shopify connection does not publish WooCommerce heartbeat health.