Troubleshooting
The LatchPay checkout does not open
Shopify’s checkout is the fallback whenever LatchPay cannot open, so check the switch, the theme line, caching and blockers, in that order.
Updated
Shopify’s checkout is the fallback, by design
Whenever LatchPay cannot open its checkout, for any reason, the buyer gets Shopify's own checkout instead: the line asks for the config first and does nothing unless it answers enabled, and if creating the checkout session fails or takes longer than 4 seconds it sends the buyer to /checkout as usual. So "the LatchPay checkout did not open" always looks like a normal Shopify checkout, never a broken page.
Checks, in order
Is the checkout on?
The Theme snippet page shows the pill. LatchPay checkout is off: switch it on in Settings. Switched on, but paused: see Checkouts are paused or off.
Is the line seen?
Not seen in the last 10 minutes means the store is not loading the line. See The theme line is not seen.
Reload the storefront
The browser caches the config answer for 60 seconds; after switching on, open a fresh page or a private window.
Try with an empty extensions list
A content blocker on your device can block the line or the call that creates the session; buyers without it are fine. Test in a private window.
Check the cart
An empty cart, or a cart with only items the store cannot sell any more, cannot become a checkout; Shopify handles it.
The checkout opens but shows an error
- This store cannot take payments right now. The Whop connection is missing or pending; the line should not have intercepted, so the buyer was sent from a cached page. Fix the connection.
- Some items in your cart are no longer available. Stock ran out between the cart and Pay now.
- Your total changed. Please review your order before paying. Shopify re-quoted a different amount at Pay now (a price edit, an expired code); the buyer confirms the new total.
- We could not complete this payment. Please contact the store. The fraud rules declined the checkout before any charge; the dashboard's Fraud & risk page explains the rules.
- The payment could not be started. Whop refused the payment; the buyer checks their payment details and tries again, or picks another method. No order exists until Whop confirms a payment.