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