Guides / Shopify checkout payment declined at the pay step: merchant triage

Part of: Payments, checkout and accounting problems

Last reviewed 5 Oct 2026 · By Harry

Shopify checkout payment declined at the pay step: merchant triage

Shopify checkout failing or payment declined at pay? Tell issuer declines from Shopify Payments, gateway, 3-D Secure and real platform outages.

Customers reach the pay step, enter a card, and get Your payment could not be processed or a plain decline. Support chat fills with "Shopify is down". Before you flip the store to cash-on-delivery, separate issuer declines, gateway errors, checkout config, and a real Shopify incident.

Is it Shopify?

Open the Shopify status page (official Statuspage). In admin, check whether other orders are still landing right now. If orders from other customers succeed while one card fails, Shopify checkout is working. If checkout is red for everyone and status names Checkout or Payments, treat it as platform.

Also remember storefronts often sit behind Cloudflare. A PoP problem can make one country unable to load checkout while Shopify's global board stays calm — compare with a phone on mobile data in another network.

Decline versus error versus timeout

• Declined — the issuer (cardholder's bank) received the auth and said no. Shopify and the gateway did their job.
• Error / could not be processed — technical failure: gateway timeout, credentials, 3-D Secure mishandled, or platform fault.
• Spinner forever — browser, app pixel, or network path; capture the checkout URL and try another device before blaming payments.

Merchant checks at the till / admin

1. Read the order / abandoned checkout. Shopify records payment failure reasons when the gateway returns them. "Insufficient funds", "Do not honour", "Expired card" are issuer talk.
2. Try another brand and wallet. Visa fails, Mastercard works → often the issuer or a card brand outage, not your whole stack. Apple Pay / Google Pay uses a different token and often succeeds when a raw PAN is blocked.
3. Test mode leak. A store accidentally left on bogus gateways, or a custom app still pointing at test credentials, breaks live pay while the status page stays green.
4. Currency and billing country. Mismatched presentment currency, blocked countries in Markets, or a gateway that does not support the buyer's region fails at pay.
5. Address and AVS. Strict AVS / CVV settings on Shopify Payments or the gateway reject legitimate overseas cards. Soften only with eyes open.

Shopify Payments, Stripe, PayPal and others

• Shopify Payments. Check the payments dashboard for account restrictions, identity verification holds, and payout pauses. A restricted account refuses charges without a pretty global outage.
• Stripe (or other card gateway). Decline codes such as generic_decline and do_not_honor are issuers. processing_error and API authentication failures are yours or Stripe's — see also card payments declining.
• PayPal express. Buyer approval can fail independently of card rails. See PayPal payment couldn't be completed.
• 3-D Secure / SCA. In the UK and EEA, checkout must complete the challenge. Themes or custom checkout that drop the redirect produce failures that look like declines (authentication_required).

Theme, app and fraud stack

• Checkout UI extensions and script apps can break the pay button after a theme update. Reproduce with a stock theme preview.
• Shopify Flow, fraud apps and manual review rules can hold or void payments after auth — customers see "declined" in casual language when the order is actually pending review.
• Inventory and shipping rate apps that error during calculation sometimes surface as pay-step failures. Watch the checkout console network tab.

When to escalate

Contact Shopify support when many unrelated cards and wallets fail with gateway or platform errors, your credentials and Markets config are unchanged, and the official status page shows an incident or stays quiet while admin metrics flatline. Have checkout tokens, approximate UTC times, gateway used, and sample order IDs ready. Issuer decline text belongs with the customer's bank, not a Shopify bridge.

Related status pages

• Shopify
• Stripe
• PayPal

Related guides

• Card payments declining on Square or Stripe: outage or the bank?
• PayPal “payment couldn’t be completed”: buyer and seller checks
• How to tell if a service is down or it's just you

FAQ

Why is Shopify declining payments at checkout?

Most card declines come from the customer's bank. If many different cards and wallets fail with errors, check Shopify status, your payments account state, and gateway credentials.

How do I tell a bank decline from a Shopify outage?

Bank declines usually name funds, fraud or AVS reasons and other orders still succeed. A platform incident hits many merchants and payment methods at once and often appears on Shopify status.

Can Cloudflare make Shopify checkout fail?

Yes for some shoppers. Storefronts behind Cloudflare can fail in one region while Shopify Payments is healthy. Compare with another network and check Cloudflare status.

What should I check after a theme or app update breaks pay?

Preview a clean theme, disable recent checkout apps, and confirm 3-D Secure still completes. Custom scripts are a common pay-step regression.