26 July 2026 · Checkout
Shopify checkout issues: how to diagnose and fix
When Shopify checkout issues appear, the first impulse is to blame the theme or Shopify itself. In reality, the cause is usually one of a small set of problems: payment setup, shipping configuration, app conflicts, or checkout customization. A quick diagnosis prevents hours of trial and error.
Short answer: start by reproducing the issue in a clean browser and on mobile. Then check payments, shipping rates, apps, and checkout customizations in that order. For subscription-specific checkout problems, the billing engine is often the real culprit, which is why Checkivo runs renewals on Stripe. Related: Shopify checkout blocks app and Dynamic checkout Shopify.
Common checkout symptoms
Shopify checkout issues show up in a few recognizable ways:
The checkout button is missing or does not respond.
Customers see an error at the payment step.
Shipping rates do not load or are incorrect.
Discount codes do not apply.
The checkout page loads slowly or breaks on mobile.
Subscription customers cannot complete their purchase.
The first step is to reproduce the problem. Use the same device, browser, and location as the customer. Many issues are browser-specific or related to saved payment methods that only appear for real customers.
Payment-related issues
Payment problems are the most common checkout blocker. Common causes include:
Shopify Payments is not active or is in test mode.
A third-party gateway is misconfigured or unsupported in the customer's region.
The customer's card is declined by the bank, not by Shopify.
Express checkout wallets are not enabled for the product or region.
Subscription apps require a gateway that supports recurring payments.
Check your payment settings, test a small order, and look at the order timeline for decline reasons. If a specific payment method fails, contact the provider before changing Shopify settings.
Shipping and tax issues
Shipping rates that do not load usually mean a profile is misconfigured or a product is missing dimensions. Tax errors often happen when a region is not set up or a tax override conflicts with a discount.
Quick checks:
Verify the product has weight and dimensions.
Check that the shipping zone covers the customer's country.
Confirm rates are not limited to a weight range that excludes the cart.
Check tax settings for the destination region.
These problems are often invisible to the merchant until a customer from a specific region tries to buy.
App and theme conflicts
Apps that modify the cart, checkout, or product page can conflict with each other. A recently installed app, an app update, or a theme change can break checkout behavior.
To isolate the issue:
Disable recently installed apps one by one and test checkout.
Switch to an unmodified Shopify theme temporarily.
Check app permissions and scopes.
Review app logs or contact support if the app has a known checkout conflict.
Checkout blocks apps are a common source of issues when they are not updated for the latest Shopify checkout version.
Checkout customization issues
Custom checkout code, legacy checkout.liquid, or poorly built checkout blocks can cause errors. If the issue appeared after a checkout customization, start there.
Things to check:
Are you using deprecated checkout.liquid code?
Did a custom app or block recently change?
Does the issue only appear on mobile or specific browsers?
Are payment buttons hidden by a custom block on small screens?
Subscription-specific checkout issues
Subscriptions add complexity. The checkout must handle recurring billing terms, plan selection, and sometimes a different payment flow. Issues include:
Subscription apps that do not support the customer's payment method.
Express checkout buttons that skip subscription terms.
Plan selection widgets that do not appear or conflict with other blocks.
Renewal failures because the payment method was not tokenized correctly.
Checkivo reduces these problems by handling subscriptions on Stripe. The checkout can be simple, and the recurring billing logic is reliable.
A practical diagnosis process
When a customer reports a checkout issue, follow this order:
Reproduce the exact issue with the same product, location, and device.
Check payment settings and gateway status.
Verify shipping and tax for the destination.
Disable recent apps and test again.
Review checkout customizations and blocks.
Check subscription-specific settings if the issue is recurring.
Contact Shopify or app support only after you have isolated the cause.
Common diagnosis mistakes
The biggest mistake is changing settings before reproducing the issue. Merchants who edit payment or shipping settings based on one customer report often create new problems. Always reproduce first.
Another mistake is ignoring browser and device differences. A checkout issue on Safari iOS may not appear on Chrome desktop. Test on the same setup as the affected customer.
Finally, some merchants blame Shopify before checking their own apps. Third-party apps are a frequent source of checkout issues, especially after updates or new installations.
Checkout health checklist
Run this checklist regularly:
Complete a test order on desktop and mobile each week.
Review abandoned checkouts for patterns.
Check payment gateway status and error logs.
Verify shipping zones and rates for your top markets.
Review recently installed or updated apps.
Monitor checkout completion rate in Shopify analytics.
Key takeaways
Checkout issues are usually systematic. Reproduce, isolate, and fix the root cause rather than applying random changes. For subscription checkout problems, separate the billing engine from the checkout UI using Checkivo.
Examples of checkout issues and fixes
Here are three common scenarios and how to fix them:
Scenario 1: Apple Pay button is missing. Check that Apple Pay is enabled in your payment settings, that the customer is on Safari with an Apple device, and that the product is eligible for express checkout. Subscription products may not support all wallets.
Scenario 2: Shipping rate shows as zero for one country. Verify that the shipping zone includes the country and that the product has weight. A free shipping rate that should be conditional may have been applied to all orders.
Scenario 3: Discount code works for one product but not another. Check product eligibility, collection restrictions, and whether the code combines with other discounts. Subscription products may have their own discount rules.
These examples show that checkout issues are rarely about Shopify itself. They are usually about configuration, apps, or specific customer contexts.
Preventing checkout issues
The best fix is prevention. Set up a weekly checkout test routine. Add a test product to the cart, go through checkout on mobile, and complete a small test order. Rotate through your top payment methods and shipping destinations.
Also monitor support tickets for patterns. If three customers in a week report the same checkout error, you have a systemic issue, not a one-off.
Frequently asked questions
Why is my Shopify checkout not working?
Common causes are payment setup, shipping configuration, app conflicts, or checkout customization errors.
Why do customers see a payment error?
It could be Shopify Payments settings, a misconfigured gateway, a declined card, or a region that is not supported.
Why are shipping rates not showing?
Usually a missing product weight, a shipping zone that does not cover the destination, or a rate limit issue.
Can apps break Shopify checkout?
Yes. Cart, checkout, and product page apps can conflict. Disable them one by one to isolate the problem.
Why does checkout work for some customers but not others?
Device, browser, location, and payment method all affect checkout. Reproduce with the customer's exact setup.
Can checkout.liquid cause issues?
Yes, checkout.liquid is deprecated and can break with Shopify updates. Migrate to checkout extensibility.
Why is my subscription checkout failing?
Subscription apps have specific requirements for payment methods, tokenization, and plan selection. Check those settings.
How does Checkivo reduce checkout issues?
Checkivo runs subscription billing on Stripe, so the Shopify checkout can stay simple while the recurring logic is handled reliably.
Should I contact Shopify support first?
Only after you have reproduced the issue and checked payments, shipping, apps, and customizations. Isolating the cause speeds up resolution.
How do I monitor checkout health?
Track checkout completion rate in Shopify analytics, review abandoned checkouts, and monitor support tickets for patterns.
How do I report a checkout bug to Shopify?
Reproduce the issue, document the steps, and open a support ticket with screenshots and order details.
Can a checkout issue affect only one product?
Yes. Product-specific shipping, tax, or app settings can cause checkout to fail for one product while others work fine.
Why does checkout fail for international customers?
Usually shipping zones, tax settings, or payment method availability for that country.
Can I recover abandoned checkouts caused by checkout issues?
Yes, once the issue is fixed, you can reach out to affected customers with a direct checkout link.