Troubleshooting
Resolve common store, domain, routing, and checkout readiness issues.
Updated July 17, 2026On this page
- The exact resource name and current readiness reason
- Access to the relevant Shopify, DNS, or gateway account
Start with the resource's computed readiness reason. Fix dependencies from the bottom up: MID, pool, router, store, domain, shipping, then checkout.
Checkout is blocked
Open the checkout readiness panel
Open Checkouts, select the blocked checkout, and read the named dependency. Do not pause and resume resources to hide the message; fix the underlying configuration.
Follow the dependency chain
For a routing problem, open the router, then its assigned pool, then the configured MID. For a store problem, verify custom app credentials and scopes. For a domain problem, inspect the authoritative CNAME.
Fast diagnosis
| Symptom | Check first |
|---|---|
| Shopify products do not load | Store app connection, token, and product-reading scopes |
| Domain remains Pending | Authoritative CNAME value and DNS TTL |
| Pool is Unavailable | Enabled pool plus at least one healthy, configured MID |
| Router is Degraded | Straight-sale and subscription pool readiness |
| Checkout is Blocked | Store, domain, router, and default shipping readiness |
| Test payment result is unexpected | Checkout's enabled test card and Dry Run routing |
| Reverse Sync fails | Checkout add-on state, linked store connection, and order detail error |
If an action reports an invalid Firebase ID token, sign in again and retry. DNS verification itself should never require a token outside the authenticated merchant API request.