Country selection and storefront QA

How to test regional checkout fallbacks

TL;DR

Write down which country your store should choose when a visitor’s route, landing URL and saved market disagree. Run four staging cases against that rule. Compare the selected market, cart currency and available delivery countries at each step.

In this guide

Write the store’s rule before running the test

A visitor in London might follow a US campaign link or shop for delivery in the United States. The store needs an explicit rule for that situation. “I saw dollars on a UK connection” is useful evidence only after you know which choice the store promised to honor.

Here is an illustrative merchant policy for a staging store that sells in the UK and US. A market-specific URL wins on arrival. At a neutral URL, a saved country choice wins, followed by the visitor’s country when served. Everyone else sees a country chooser. A shopper can change markets before checkout. Write down your actual store policy in the same terms. On Shopify, for example, unmatched visits can see the configured backup region. Use your configured backup as the expected result when that rule applies.

Four checkout paths to test

Use one test item offered in both markets and a browser profile with known settings. Keep its language constant. Open staging directly. For each case, record the landing URL after redirects, selected market, cart currency and delivery-country options before entering payment details.

Four staging cases for the example market policy
Staging caseInputsExpected under the example policy
First visitUK route, neutral URL, new profileUK market. The item and cart show GBP, and UK delivery is available.
US campaign linkSame UK route and fresh state, US-market URLUS market. The item and cart stay in USD through the move to checkout.
Returning shopperUK route, neutral URL, US selected on a prior visitThe saved US choice survives. Switch to UK and confirm that the next neutral visit remembers UK.
Unserved countryFresh profile and neutral URL, test country outside both marketsThe store offers the country chooser. Choosing a served country leads to a cart with that market’s currency.

Use an available route or a documented test-country control in your own staging environment. Mark which you used. A simulated country can validate the fallback logic. An end-to-end country-routing check also needs an observed request through that route. Check stock by country and network before scheduling that part.

Find the first step that changes market

Suppose the US campaign URL shows USD on the UK route, but the cart switches to GBP. First confirm that the same browser kept the intended route. Save the final product URL and the selected market immediately before and after adding the item. In a Shopify theme, localization.country and localization.market can identify the market context on the storefront. Record the checkout currency separately.

  • Market changes when the cart opens. Inspect the cart link or redirect on staging. Check whether it lost the market path or started a different session.
  • Market stays US but the item price badge changes. Compare the badge’s currency code with the cart subtotal and the configured price list for that item. A bare dollar sign cannot distinguish USD from CAD.
  • Only the second visitor gets the wrong public landing page. Repeat with two clean profiles in reversed market order. Compare the market recorded by your application with the response each profile received. Ask the storefront or CDN owner to inspect how that public page is cached if the second response repeats the first market.

Give the right team a reproducible case

A useful report is short. For example, “Case 2, UK route, US URL, clean profile. Product market US, currency USD. Cart market UK, currency GBP immediately after Add to cart. Reproduced twice on staging.” Attach the non-sensitive path, UTC time, build identifier and expected merchant rule. Remove customer details, cart tokens and cookies from screenshots or logs.

If your own staging logs disagree about the country of the same exit, start with the exit-location worksheet. If the storefront follows its market rules but an ad sends visitors to the wrong URL, return to regional ad verification. This matrix tests the handoff from storefront to checkout. Delivery eligibility still comes from the store’s shipping configuration.

Common questions

Should a US market link always override the visitor’s country?
That priority belongs to the merchant. A redirect to the UK can be correct if the documented policy intentionally prefers the visitor’s country. Set the expected decision for each case before evaluating it.
How do I test a missing country route?
Use an approved staging control to exercise the application rule and mark that result as simulated. Leave the live route check pending until you can observe a request from the required country.

Sources