Appearance
Checkout drop-off & payment-decline triage
Shoppers are reaching checkout but fewer are completing — or specific customers report that their card "won't go through." It's tempting to blame the theme, Shopify Payments, Shop Pay, Apple Pay, or a risk filter. This guide helps you separate the part Uisce controls — the storefront friction before checkout — from the part it cannot see or change: the payment provider and checkout internals.
Where the theme's reach ends. Once a shopper clicks the checkout button, they leave the theme and enter Shopify's checkout. The theme cannot approve or decline a payment, authorize a wallet, or see a bank's decision. So this guide is split firmly in two, and it deliberately does not blame Shopify, banks, wallets, or providers without evidence.
The split
| Stage | Who controls it | What this guide does |
|---|---|---|
| Storefront → cart → checkout button | The theme (Uisce) + you | Check for friction you can fix (below, step 1) |
| Checkout, payment, authorization | Shopify + payment provider + the shopper's bank | Point you at the right place to look (step 2) |
Step 1 · Storefront friction the theme can help you check
These are pre-checkout surfaces. If they're awkward, shoppers abandon before payment ever runs — which can look like a "checkout problem" but isn't. Run the Purchase-path QA checklist for the mechanical pass; the friction points that most often cost a checkout:
- [ ] Product clarity and variant selection. The shopper can tell what they're buying and pick the right option without guesswork.
- [ ] Add-to-cart and cart. Add-to-cart gives feedback; the cart drawer/page shows line items and totals clearly.
- [ ] Checkout entry is obvious and reachable. The checkout button is visible on the cart drawer and cart page, on desktop and mobile.
- [ ] Expectation copy is present and honest. Shipping, returns, and payment-method expectations are stated where shoppers look for them, so there are no surprises at checkout. Keep the wording truthful — see the storefront wording guardrails.
- [ ] Mobile friction. On a real phone width, nothing important is off-screen, overlapped, or hard to tap on the way to checkout.
If the path before checkout is clean and shoppers still drop at payment, the cause is in step 2 — not the theme.
Step 2 · Checkout & payment — what the theme cannot diagnose
None of the following is visible to, or controllable by, the theme. Investigate them in Shopify admin and with your provider:
- Shopify Payments approvals and declines — the accept/decline decision and its reason live in Shopify admin, not the theme.
- Issuer / card-bank declines — the shopper's bank can decline for funds, limits, location, or its own risk reasons. Neither Shopify nor the theme overrides that.
- Shop Pay and Apple Pay authorization — a wallet that has the shopper's card stored still has to be authorized per transaction. Stored details are not a pre-approved payment.
- Payment-provider risk checks — fraud/risk screening can hold or decline an order independently of the card itself.
- Checkout internals — everything after the shopper leaves the theme-controlled storefront is Shopify's checkout, not a theme surface.
Where to actually look
- Shopify admin → Orders / payment events. Review decline codes and order timelines for the affected orders. The decline reason is the fastest signal of where the problem sits.
- Compare a bad window to your baseline. A handful of declines in an hour may be normal variance. Compare against a normal period before concluding something is systemically broken — one bad afternoon is not a trend.
- Escalate with evidence. If decline codes or order events point at the provider, contact Shopify support or your payment provider with the specific orders and codes. That's the right channel — the theme can't change a payment decision.
How this fits the other guides
- Storefront mechanics, in detail: Purchase-path QA checklist.
- Traffic-but-no-orders, the wider picture: No-orders storefront triage.
- Cart-level diagnostics and an in-editor Conversion Health Check panel are planned (#77, #75); until they ship, the manual checks here and in the purchase-path checklist are the way to run this.
Non-goals
- This guide is not financial or payment-processing advice.
- The theme does not reduce payment declines and cannot diagnose or override issuer, wallet, or payment-provider risk decisions.
- It makes no claims about how Shopify Payments, Shop Pay, Apple Pay, Stripe, banks, or card networks decide to approve or decline a transaction.
What this page is — and is not
This is a triage split — storefront friction you can fix, versus payment outcomes you must investigate in Shopify admin and with your provider. It is not a way to make the theme influence payment decisions, and it is not provider support. Fix the friction you control, read the decline codes for the rest, and escalate to the right channel with evidence.