Shopify Payments Not Working? Causes, Fixes & Diagnostic Guide

17 minutes to read
8 May, 2026

Quick answer: Shopify Payments fails for one of five reasons: an individual customer's card is being declined by their issuing bank (most common, often misread as a Shopify problem), your Shopify Payments account is under review or has a reserve, a third-party gateway (PayPal, Stripe, etc.) has disconnected, an express checkout (Apple Pay, Google Pay, Shop Pay) is misconfigured, or you're trying to use Shopify Payments in a country where it isn't available. The fastest diagnostic is Finances → Transactions — every payment attempt logs the exact decline reason and processor response.

AI Summary

Shopify Payments failing, cards declining, or payouts not arriving? Diagnose the real cause, fix common payment issues, and learn when to hire a Shopify expert.

A failed payment is the most expensive moment in your store. The customer made it through every step — product, cart, shipping, address — and then the transaction fails. Most never come back. Industry data consistently shows that abandoned payments at the final step convert at less than 30% on retry, even with cart recovery emails.

This guide is specifically about Shopify Payments and payment-processing issues — separate from the broader checkout flow, which can fail for shipping, tax, or app reasons. If your customer reached the payment step and that is failing, this is the right article.

It covers:

  • The five distinct ways Shopify Payments can "not work" (the symptom matters)
  • Why most "Shopify Payments errors" are actually issuing bank declines
  • What Shopify Payments handles vs what's on you
  • How to use the Transactions log as your single diagnostic
  • DIY fixes for the most common payment issues
  • When the problem is beyond DIY and needs a Shopify expert
  • What payment debugging and integration work should cost

Why are my Shopify Payments not working?

Shopify Payments fails for one of these reasons: the customer's issuing bank declined the charge (the most common cause, and not actually a Shopify problem), your Shopify Payments account is on review/hold or has a payout reserve, a third-party gateway has disconnected or expired, an express checkout method is misconfigured, your country isn't supported by Shopify Payments, or 3D Secure (3DS) authentication failed silently for European customers. The fix depends entirely on which is happening — and the Transactions log tells you immediately.

What kind of "not working" is it?

Different symptoms point to completely different problems. Match yours:

SymptomMost likely cause
One specific customer's card declinedIssuing bank decline (insufficient funds, fraud rules, expired card, address mismatch, etc.)
Many customers' cards declined recentlyShopify Payments account flagged, fraud filter too strict, or processor incident
3D Secure / SCA verification fails for European customersCustomer did not complete authentication, or 3DS is not configured correctly
Customer never sees the payment stepEarlier checkout step failing — see Shopify Checkout Not Working
Apple Pay / Google Pay / Shop Pay missing at checkoutWallet not enabled in Settings > Payments, or domain verification failing
PayPal or Stripe button missing or erroringThird-party gateway disconnected, OAuth expired, or account closed
Shopify Payments shows “not available in your country”Shopify Payments is not supported in your region — you need a third-party gateway
Payouts not arriving on schedulePayout on reserve, bank account verification needed, or delayed payout schedule
Funds being held by ShopifyAccount under review, high-risk product, or suspicious activity flag
“Test mode” or Bogus Gateway charged a real customerTest mode left on in production — fix immediately
Manual payment methods (bank deposit, COD) not appearingManual payment not enabled or restricted by region

Identify your symptom, then go to causes.

What Shopify Payments handles for you

Before paying anyone for "payment fixes," know what Shopify Payments does automatically:

  • PCI DSS Level 1 compliance — you don't manage card security
  • Major card networks — Visa, Mastercard, American Express, Discover, Diners
  • Express checkout — Shop Pay, Apple Pay, Google Pay (with toggle setup)
  • 3D Secure / Strong Customer Authentication (SCA) — automatic for European transactions
  • Multi-currency presentment — when Shopify Markets is configured
  • Default fraud analysis with Shopify's built-in fraud signals
  • Dispute routing and management through the admin
  • Automatic chargeback handling for Shopify Payments transactions
  • Tax calculation through Shopify Tax (separate product, sometimes bundled)
  • Daily payouts to your bank account (frequency varies by country and risk)

What Shopify Payments doesn't handle:

  • Why an issuing bank declined a card — that's between the customer and their bank
  • Country availability — Shopify Payments only works in specific countries (US, UK, Canada, Australia, Ireland, NZ, Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Denmark, Czech Republic, Romania, Singapore, Hong Kong, Japan, and a growing list — but not most of Asia, Africa, or LATAM)
  • Reserve decisions — if Shopify holds funds, you appeal but they decide
  • Account verification timelines — KYC review can take days or weeks
  • PayPal / third-party gateways — those are separate accounts and integrations
  • Custom B2B payment terms (NET 30, etc.) — needs a Plus app or custom build
  • Subscription billing logic — needs Recharge, Bold, or similar

If a "Shopify Payments expert" charges you for things Shopify already does (PCI, basic 3DS, default Apple Pay setup) — walk away. Real payment work is in account issues, alternative gateways, multi-currency, B2B, and custom logic.

The most common causes (in order of frequency)

1. Issuing bank declines (the #1 cause merchants misread as a Shopify problem)

When a customer's card is declined, the decline almost always comes from their bank, not from Shopify. Common reasons:

  • Insufficient funds
  • Bank fraud rules flagging the transaction (especially for international, large, or unusual purchases)
  • Expired card
  • Address Verification Service (AVS) mismatch
  • CVV mismatch
  • Daily spending limit exceeded
  • Card not authorized for online or international purchases
  • Issuing bank temporarily blocking the card

The Shopify Payments error message often says "Card was declined" with no detail — but the transaction log shows the underlying reason with the processor response code. That's where the answer lives.

2. 3D Secure / Strong Customer Authentication (SCA) failures

For European customers (and increasingly elsewhere), the issuing bank may require 3DS authentication — a second screen where the customer confirms the purchase via SMS, app, or biometric.

If the customer doesn't complete this step or the bank's 3DS service times out:

  • The transaction shows as failed
  • The customer thinks the card was declined
  • The actual cause was 3DS authentication

This is increasingly common in 2026 as SCA enforcement tightens.

3. Shopify Payments account on review, with a reserve, or restricted

Shopify reviews Shopify Payments accounts for:

  • High-risk product categories (CBD, supplements, firearms, adult, gambling-adjacent)
  • Sudden volume spikes
  • High chargeback rates (over ~1%)
  • Sudden international order patterns
  • Mismatched business documentation
  • Customer complaints

When flagged, your account may have:

  • Payout reserve — a percentage of revenue held back for a period (typically 10–25% for 90+ days)
  • Delayed payout schedule — daily payouts become weekly or monthly
  • Account hold — payments still process but funds aren't released
  • Account closure — most severe outcome, with a 90-day fund hold

You'll see banners in the admin and email notifications.

4. Third-party gateway disconnected

If you use PayPal, Stripe, Klarna, Afterpay, or a regional gateway alongside or instead of Shopify Payments, those connections can break:

  • OAuth token expired
  • Gateway account closed or restricted
  • Account verification lapsed
  • API credentials rotated by the provider

The button at checkout disappears or shows an error.

Where to check: Settings → Payments → click into the provider → look for warnings or "reconnect" prompts.

5. Express checkout (Apple Pay, Google Pay, Shop Pay) misconfigured

Express checkout requires domain verification with each wallet provider:

  • Apple Pay requires domain ownership verification with Apple
  • Google Pay requires merchant verification
  • Shop Pay is automatic for Shopify Payments users, but disabled if Shopify Payments is off

Common issues:

  • Apple Pay domain verification expired (yes, it can expire)
  • Custom checkout extension breaking the wallet button
  • Theme customization removing the express checkout component
  • Multi-currency conflict with the wallet provider

6. Country/region not supported by Shopify Payments

Shopify Payments is only available in specific countries. If you're operating from an unsupported country and signed up for a US/UK Shopify account, your Shopify Payments will eventually be reviewed and likely closed. You need a third-party gateway:

  • Stripe (most countries)
  • PayPal (most countries)
  • Razorpay (India)
  • PayFast / Paystack (Africa)
  • Mercado Pago (LATAM)
  • Other regional providers

7. Test mode left enabled in production

Shopify has a Bogus Gateway and a test mode in Shopify Payments. If left enabled in a live store:

  • Real customers' cards process in test mode (no money moves)
  • Customers get an order confirmation
  • You think you've sold something but no payment came through

Where to check: Settings → Payments → Shopify Payments → "View payouts" — if zero payouts despite orders, test mode may be on. Also check Settings → Payments → Manage → Test mode toggle.

8. Payouts not arriving (separate from payment processing)

Payments can be processing fine, but payouts not arriving is a separate issue:

  • Bank account verification needs updating
  • Bank account closed or changed
  • Reserve in effect (payments process, payouts held)
  • Country-specific payout delay (some markets have 7+ day default)
  • Holiday / weekend banking delay
  • KYC documentation expired

Where to check: Finances → Payouts (you'll see status and any holds).

9. Multi-currency / Markets configuration issue

If you sell in multiple currencies via Shopify Markets:

  • Payment provider may not support a specific currency
  • Currency conversion fee not configured
  • Shopify Payments only supports certain currencies for capture in each region
  • Customer's currency mismatch with payment provider's settlement currency

How to diagnose: the Transactions log check

This is the single most powerful payment diagnostic in Shopify, and most merchants never look at it.

Step 1: Open the failed order

Open Orders, then click into the affected order. If the order does not exist because the customer never completed checkout, check Orders > Abandoned checkouts instead.

Step 2: Look at the timeline and transaction details

In the order, scroll to the Timeline section and the Payment block. You will see authorization attempts, decline reasons, 3DS authentication attempts, and capture status. For full detail, go to Finances > Transactions, find the transaction, and review processor response, AVS result, CVV result, 3DS result, and decline reason.

Step 3: Read the response code

Code / messageWhat it means
Insufficient fundsCustomer does not have enough money — they need another card
Card declined (generic)Bank declined; customer should call their bank or try another card
Do not honorBank catch-all decline; customer should call their bank
Invalid card numberTypo or expired card
Expired cardCard past expiration date
Incorrect CVVCustomer entered wrong CVV
AVS mismatchBilling address does not match bank records
3D Secure authentication failedCustomer did not complete 3DS verification
Risk score too highShopify fraud filter blocked it
Stolen card / Lost cardCard reported stolen — do not retry

Step 4: Identify the pattern

What you seeWhat it means
One declined order, customer reports issueIssuing bank decline — customer-side, retry with another card
Many recent declines, multiple customersAccount-level issue, fraud filter too strict, or processor incident
3DS failures dominating recent declinesSCA enforcement tightening — common in EU/UK
All transactions failingAccount hold, gateway disconnected, or test mode enabled in production
Specific country transactions failingCurrency, gateway availability, or regional issue
Payments succeed but payouts do not arrivePayout-side issue — check Finances > Payouts

Step 5: Check status pages

  • Check status.shopify.com for Shopify-side incidents.
  • Check your gateway status page, such as PayPal or Stripe, for processor-side incidents.

What you can fix yourself

1. Have the customer try again with another card

For single-customer issuing bank declines, this is the answer 90% of the time. Issuing banks decline transactions for hundreds of reasons that have nothing to do with you.

2. Reduce fraud filter aggressiveness

Settings → Payments → Fraud prevention. If you've enabled aggressive fraud blocking, legitimate transactions can be flagged. Check the Fraud Analysis on individual orders and adjust thresholds.

3. Reauthorize third-party gateways

Settings → Payments → click into PayPal/Stripe/etc. Look for "reconnect" or "reauthenticate." Sign back in to refresh the OAuth connection.

4. Re-verify Apple Pay / Google Pay domain

Settings → Payments → Manage Shopify Payments → Wallets. Re-verify domains. For Apple Pay specifically, domain verification requires Apple's domain association file.

5. Confirm test mode is OFF in production

Settings → Payments → Manage → uncheck Test mode. If it was on, contact any recent customers — their orders didn't actually charge.

6. Respond to Shopify Payments review requests

If your account is under review, respond to all information requests immediately and completely. Delays here directly extend holds and reserves. Provide:

  • Business registration documents
  • Bank statements
  • Product/sales data
  • Customer complaint resolution

7. Check payout schedule and bank verification

Finances → Payouts → Settings. Confirm bank account is verified, payout schedule is correct, and no warnings appear.

8. Test on a real card, not Bogus Gateway

If you're testing payments, use a real card with a small amount, then refund — not Bogus Gateway in production. Bogus Gateway should only be used on development stores.

9. Switch off and on the express checkout wallets

If Apple Pay or Google Pay isn't appearing: Settings → Payments → Manage → Wallets — toggle them off, save, toggle back on, save. Forces revalidation.

🎯 If your Shopify Payments account is under review, on hold, or has a reserve…

This is one of the most stressful situations a merchant can face — and it's the single hardest area to navigate alone. You usually need someone who has dealt with Shopify Payments risk reviews before, knows what evidence to provide, and can advise on alternative gateways while resolution is pending.

Not sure what kind of help you need? → What kind of Shopify expert do I need?

Ready to hire? → Browse Shopify payment gateway experts

Common issues DIY audits miss

  • Shopify Payments active in admin but customer-side never reaches it because a third-party gateway is set as primary and intercepting the transaction.
  • Apple Pay verification expired without notification — the file Apple uses to verify ownership has a renewal cycle.
  • Customer using a card from a country your fraud filter is auto-blocking without you knowing.
  • 3DS challenge displayed in a popup blocked by the customer's browser — looks like a decline to the customer but is actually a UI failure.
  • Subscription app reauthorizing the card at billing time and failing silently when the card has changed.
  • Two payment providers active with conflicting capture settings — one auto-captures, one manually captures, and orders end up partially processed.
  • Currency mismatch with provider's settlement currency causing higher decline rates for cross-border purchases.
  • Test mode left on after a developer worked on the store — common after migrations or staging-to-production deployments.
  • Risk-flagged orders auto-canceling because of an aggressive Shopify Flow workflow that the merchant forgot existed.
  • Payouts going to a closed bank account because the bank closed the account and didn't notify the merchant.

These usually require someone who has navigated Shopify Payments risk reviews and gateway integrations before.

Expert insights

Most "Shopify Payments errors" are issuing bank declines. Read transaction codes before assuming Shopify is the problem. The fix is "the customer needs to use a different card or call their bank" far more often than merchants realize.

Reserves and holds are negotiable, slowly. If your account has a reserve, providing strong evidence (low chargeback rates, customer satisfaction, business legitimacy) can shorten the hold period. Most merchants either give up or fight ineffectively. Working with someone who has done this before gets faster results.

Third-party gateways are a hedge, not a replacement. Even if Shopify Payments works fine, having PayPal or Klarna available recovers a meaningful slice of declined transactions — different banks, different fraud rules, different consumer preferences.

Apple Pay and Shop Pay are conversion levers most merchants underuse. Express checkouts have meaningfully higher conversion rates than card entry — especially on mobile. If they're not enabled or visible, you're leaving revenue on the table.

Country availability changes regularly. Shopify Payments expanded to several new countries in 2024–2025. If you were told it wasn't available in your country a year ago, check again — it might be now.

Fraud filters can over-block. Aggressive fraud thresholds save you from chargebacks but cost legitimate sales. Most stores tune fraud filters once when they launch and never revisit. Reviewing fraud-flagged orders monthly catches false positives.

Payouts and payments are separate concerns. Payments processing and payout arrival are completely different systems. Don't conflate them when diagnosing — "payments are working but payouts aren't" is a real and common situation requiring its own fix.

When to hire a Shopify payments expert

Bring in a specialist if:

  • Your Shopify Payments account is on hold, has a reserve, or is under risk review
  • You sell in a high-risk category (CBD, supplements, firearms, adult, gambling-adjacent, high-ticket B2B)
  • You operate from a country where Shopify Payments isn't available and need a regional gateway
  • You're integrating B2B payment terms (NET 30, purchase orders, ACH)
  • You need a custom subscription billing setup (Recharge, Bold, custom)
  • You sell in multiple currencies and have payment routing complexity
  • You're on Shopify Plus and need custom payment logic or multi-gateway routing
  • You have unusual chargeback patterns and need a deliverability/risk review

A good payments expert will:

  • Read transaction logs before guessing
  • Know how to navigate Shopify's risk review process
  • Recommend alternative gateways with informed reasoning, not affiliate bias
  • Set up multi-gateway routing if needed (different gateways for different scenarios)
  • Document your payment architecture clearly
  • Give you a measurable before/after on auth rates and conversion

What you should not pay for: someone "fixing payments" by toggling settings you can toggle yourself. Real payment work involves account negotiation, gateway integration, and risk understanding.

→ Not sure if you need a freelancer or an agency? Read Shopify Freelancer vs Agency.

→ Want to know what to look out for? Read Shopify Expert Red Flags.

What Shopify payment work should cost

Realistic ranges:

  • Quick fix or gateway reconnection (1–4 hours): $150–$700. Single-issue gateway reauth, fraud filter tuning, express checkout fix.
  • Multi-gateway setup and routing (5–20 hours): $700–$3,000. PayPal, Klarna, Afterpay, regional gateway integrations alongside Shopify Payments.
  • Shopify Payments risk review consulting: $500–$3,000. Strategy and documentation support for accounts on review or with reserves.
  • B2B payment terms / NET 30 / ACH build: $3,000–$15,000+. For wholesale and B2B operations.
  • Custom payments architecture (Plus): $5,000–$50,000+. Multi-currency routing, custom subscription logic, complex international setups, headless payment flows.

If someone quotes $100 to "fix Shopify Payments" without reading your transaction logs first, they're guessing.

→ For a full breakdown by service type, see Shopify Expert Cost.

Frequently asked questions

Why are my Shopify Payments not working?

Most often: a customer's issuing bank declined the card (the most common cause and not a Shopify problem), your Shopify Payments account is under review or has a payout reserve, a third-party gateway has disconnected, an express checkout (Apple Pay, Google Pay, Shop Pay) is misconfigured, or you're trying to use Shopify Payments in an unsupported country. Open Finances → Transactions to see the exact decline reason for any failed payment.

Why is my customer's card being declined on Shopify?

Almost always a decline from the customer's issuing bank — insufficient funds, fraud rules, expired card, AVS or CVV mismatch, daily spending limit exceeded, or card not enabled for online/international purchases. The exact reason appears in the transaction details (Orders → click order → Timeline, or Finances → Transactions). The customer should call their bank or try another card.

Why hasn't my Shopify payout arrived?

Common causes: bank account verification needs updating, your account has a payout reserve in effect, the payout schedule is set to weekly/monthly instead of daily, country-specific payout delay (some markets default to 3–7 days), or holiday/weekend banking delay. Check Finances → Payouts for status and any holds.

Why is Shopify Payments holding my funds?

Shopify holds funds when an account is under risk review, has a payout reserve, or is restricted. Common triggers: high-risk product categories, sudden volume spikes, chargeback rate over ~1%, mismatched business documentation, or customer complaints. The fastest path to resolution is responding completely and quickly to any documentation requests in your admin and email.

Can I use Shopify Payments outside the US?

Yes, in many countries — but not all. Shopify Payments is available in the US, UK, Canada, Australia, Ireland, New Zealand, Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Denmark, Czech Republic, Romania, Singapore, Hong Kong, Japan, and a growing list. If your country isn't supported, you'll need a third-party gateway like Stripe, PayPal, or a regional provider.

Why is Apple Pay not showing on my Shopify checkout?

Three common causes: Apple Pay isn't enabled in Settings → Payments → Wallets, your domain verification with Apple has expired or wasn't completed, or a custom theme/checkout extension is blocking the wallet button from rendering. Toggle the wallet off and on, then verify the domain association file is in place.

Why is Shopify Payments showing "test mode" or charging Bogus Gateway?

Test mode was left enabled in production, or the Bogus Gateway is set as the active payment provider. Go to Settings → Payments → Manage and verify Test mode is off. Then check that Shopify Payments (or your real gateway) is the primary, not Bogus Gateway. If real customers were charged in test mode, no money was processed — you'll need to contact them to retry the orders.

What's the difference between Shopify Payments and Shopify Checkout?

Shopify Payments is the payment gateway — the system that authorizes and processes credit cards on your store. Shopify Checkout is the page/flow where customers enter their info, shipping, and payment. A failed payment is a Shopify Payments issue. A broken checkout page or missing shipping rate is a checkout issue. See Shopify Checkout Not Working (/help/shopify-checkout-not-working) for non-payment checkout problems.

How much does it cost to fix Shopify payment issues?

A simple fix or gateway reconnection runs $150–$700. Multi-gateway setups (PayPal, Klarna, regional providers alongside Shopify Payments) run $700–$3,000. Risk review consulting for held accounts runs $500–$3,000. B2B payment terms builds run $3,000–$15,000+. Custom Plus payment architectures start at $5,000 and can run $50,000+. See Shopify Expert Cost () for full ranges.

Next step

If your Shopify Payments aren't working — your account is under review, you need an alternative gateway, or you need a custom payment setup — work with a vetted Shopify expert who has navigated this before.

→ Browse Shopify payment gateway experts

Or, if you're not sure exactly what kind of help you need:

→ Get matched with the right expert for your store

We'll review your store, scope the work, and connect you with someone who has actually handled Shopify Payments risk reviews and gateway integrations — not a general developer guessing on your dime.

Need help fixing Shopify Payments?

Get Matched