In this guide
A failed payment is a symptom, not one diagnosis. The card issuer may decline, the billing address may not match, 3-D Secure may be incomplete, a gateway may be unavailable, fraud controls may intervene, or the cart may have lost inventory or promotion eligibility.
This guide starts from Shopify's payment-event evidence, separates customer-correctable issues from merchant configuration and provider failures, and gives support a safe recovery path. It connects to the wider Shopify checkout optimization guide.
Fast summary
- Start with the payment event and incident scope, not a generic request to try again.
- Classify issuer, detail, authentication, technical, inventory, promotion, and risk failures separately.
- Check provider authorization and capture before asking for another attempt.
- Support should never collect full card data, passwords, PINs, CVCs, or authentication codes.
- Measure approval, false declines, fraud, disputes, recovery, and support cost together.
Recommended platform
Some links are affiliate links. We may earn a commission at no extra cost to you. Disclosure
Find the exact payment event before troubleshooting
For an incomplete checkout, open Orders, then Abandoned checkouts, select the checkout, and inspect Timeline payment events. For an order that exists, inspect its order timeline and transactions. Shopify's abandoned-checkout documentation tells merchants to expand the payment event and review its Message field.
Record time, gateway, method, amount, currency, status, provider reference, error category, checkout or order ID, device context, and whether later attempts succeeded. Do not ask the customer to reproduce sensitive card information. The store needs the event and safe metadata, not the full card number.
Check whether the incident affects one customer, one method, one market, or every payment. A single issuer decline calls for different action than a site-wide inactive provider or missing shipping rate.
| Pattern | Likely scope | First check |
|---|---|---|
| One card, alternatives work | Issuer, card data, billing, or funds | Payment event and customer-safe retry guidance |
| One wallet or local method | Method eligibility or provider path | Device, market, currency, product, and provider status |
| One destination | Shipping, market, address, tax, or currency | Reproduce exact cart and destination |
| All cards | Primary provider, store status, DNS, app, or platform issue | Provider activation, status page, and recent changes |
| Orders remain pending | Asynchronous or missing provider confirmation | Provider transaction before requesting retry |
Swipe horizontally to compare every column.
Scope the incident before changing gateway or checkout configuration.
Classify the failure without overexplaining issuer decisions
Shopify lists high-risk blocking, technical processing, issuer decline, incorrect card details, expiry, CVC, postal mismatch, billing mismatch, PIN, 3-D Secure, inventory, and expired discount or gift-card conditions among possible abandoned-checkout failures. The event message may be more specific, but issuers often provide only a generic decline.
Tell the customer only what is safe and supported. Ask them to verify card details and billing address, complete authentication, use another available method, or contact the issuer. Do not claim insufficient funds, fraud, or a blocked account unless the evidence permits that wording.
Repeated retries can create multiple authorization holds and a worse experience. After one careful retry, offer an alternative method or issuer contact rather than telling the customer to submit continuously.
| Failure family | Safe customer guidance | Merchant investigation |
|---|---|---|
| Details or billing mismatch | Re-enter exactly as held by issuer | Form validation and address-market behavior |
| Generic issuer decline | Try another method or contact issuer | Method, currency, amount, and provider event |
| 3-D Secure failure | Retry and complete issuer authentication | Browser, redirect, app, and provider path |
| Technical processing | Wait briefly, then retry once or use another method | Provider status, logs, and recent configuration |
| Inventory or discount | Review the updated checkout total and availability | Stock reservation, promotion rules, and cart refresh |
| Risk block | Contact store support without sending card data | Fraud settings and false-positive review |
Swipe horizontally to compare every column.
Give the customer a useful next step without revealing risk controls or making unsupported claims.
Rule out merchant configuration and provider outages
Confirm an active primary provider, completed account verification, supported currency, eligible product, valid market, and available shipping rate. Shopify's payment troubleshooting guide notes that a store unable to accept payments may lack an active primary provider and that missing shipping prevents reaching payment.
Review recent changes to providers, Markets, checkout apps, subscriptions, discounts, shipping, fraud rules, domain, and theme. Test a known-good product and destination. If every method fails, stop paid traffic or add a truthful notice while the issue is investigated.
Check the Shopify and provider status pages and capture timestamps. Do not deactivate and reactivate gateways impulsively when pending payments or live traffic exist. Preserve evidence and understand the effect on current checkouts.
- 1
Confirm scope
Count affected methods, markets, devices, products, and times.
- 2
Check provider state
Verify activation, account requirements, supported currencies, and public incidents.
- 3
Reproduce safely
Use a known-good cart, destination, and supported test or low-risk path.
- 4
Review recent releases
Inspect payment, app, market, shipping, discount, subscription, and fraud changes.
- 5
Protect traffic
Pause affected campaigns or communicate accurately if checkout is broadly unavailable.
Check pending and captured transactions before asking for a retry
External or asynchronous methods can capture or authorize payment before Shopify receives final confirmation. A customer may see a bank hold while the order appears incomplete. Verify provider and Shopify transaction references before recreating an order or telling the customer to pay again.
An authorization hold is not necessarily a settled charge. Shopify's authorization documentation explains that issuers may display pending holds and that release timing depends on the bank. Support should distinguish authorization, capture, void, refund, and duplicate capture.
Create an escalation path for payment evidence. Support records the event and customer-visible amount; finance verifies provider settlement; operations holds fulfillment until the order state is resolved. Never ask the customer to email a full card number or security code.
Watch out
Before asking a customer to retry, verify that the provider did not already authorize or capture the first attempt. A second attempt can create another hold or charge.
Balance fraud controls against legitimate-customer loss
Fraud protection can prevent expensive orders and can block legitimate customers. Review risk decisions by market, traffic source, order value, billing and shipping relationship, proxy signal, velocity, and later chargeback outcome. Do not publish fraud thresholds or coach customers around controls.
Shopify's fraud-prevention guidance documents fraud analysis, dynamic 3-D Secure, manual capture, Flow, and plan-dependent authorization optimization. Manual capture can support review, but it adds an authorization-expiry workflow and does not prevent all disputes.
Measure approved orders, blocked attempts, later disputes, manual-review time, cancellations, and customer contacts. A stricter rule is not successful if false declines cost more healthy contribution than fraud it prevents.
Give support a safe failed-payment playbook
Confirm identity through normal order or checkout details, explain the visible error conservatively, and offer safe next steps. Send a fresh checkout link only after verifying stock, price, discount, shipping, and prior payment state. Use the existing abandoned-checkout sequence only when consent and event logic permit it.
Escalate repeated failures, mismatched captures, widespread incidents, inaccessible authentication, and suspected false positives. Record the resolution category so product, finance, and growth teams can identify systemic causes.
Do not collect card numbers in tickets, screenshots with sensitive data, issuer passwords, one-time authentication codes, or security codes. Direct payment entry back to Shopify's secure checkout or an approved provider path.
- Checkout or order identifier, time, amount, currency, method, and safe error summary.
- Confirmation that prior authorization or capture was checked.
- One clear next step: correct details, authenticate, alternate method, issuer, or support escalation.
- A refreshed link only when total, stock, shipping, discount, and payment state are valid.
- No collection of full card number, CVC, password, PIN, or one-time code.
Build a failure dashboard that leads to action
Track payment attempts, authorization success, error family, method, gateway, market, currency, device, browser, order value, new versus returning customer, and eventual recovery. Keep chargebacks and refunds downstream so approval improvements do not hide added risk.
Review event counts and rates. One method may grow in usage and failures simultaneously while its rate remains stable. Investigate sudden shifts against releases, provider incidents, promotions, traffic sources, and fraud-rule changes.
Turn repeat causes into owned work: checkout configuration, market and currency, shipping, discounts, provider support, customer education, fraud tuning, or app compatibility. The dashboard is useful only when each failure family has an owner and response threshold.
| Signal | Owner | Action |
|---|---|---|
| Details and billing errors | Checkout and CX | Improve validation and safe guidance |
| 3-D Secure failures | Payments and engineering | Test authentication path by browser and market |
| Provider technical errors | Payments | Escalate with references and control traffic |
| Inventory or discount failures | Merchandising | Repair stock and promotion synchronization |
| Risk blocks and false positives | Fraud and finance | Review rules against later outcomes |
| Pending or duplicate states | Finance and support | Reconcile provider before retry or fulfillment |
Swipe horizontally to compare every column.
Assign ownership by failure family so the same issue is not handled as an isolated ticket forever.
Frequently asked questions
The issuer may decline, details or billing may not match, funds or card status may prevent authorization, 3-D Secure may fail, fraud controls may block, or the provider may return a generic response. Inspect the payment event for the safest available detail.