Resolve common issues with customer checkout.
Use this guide to troubleshoot problems you or your customers might see on your checkout page.
Check for browser issues first
If a customer is using a valid form of payment and can't check out, it’s likely because of an issue related to their browser. Unless they see one of the error messages listed below, ask your customer to try these troubleshooting steps:
- Ensure they’re using the most up-to-date version of their browser.
- Clear their cache, or test the purchase from an incognito browser window.
- Disable any browser extensions.
- Contact their bank to verify their credit card is working properly.
- Contact Stripe directly. Stripe checks with the customer's bank to ensure that the billing address and postal code are valid for the credit card number when attempting to process a purchase.
Unable to process payment
This means: There’s an issue with your Stripe or PayPal connection.
To resolve the issue: Ensure your Stripe account is verified, or Contact Stripe directly to ensure your account is fully set up. Refresh your connection by disconnecting and reconnecting Stripe (keep in mind, this may interrupt your active subscriptions). If you use PayPal, disconnect and reconnect your account or contact PayPal directly.
We couldn't find the page you were looking for
This means: Your domain might not be connected properly. If this happens, the order was still processed, and you didn't lose the customer's payment.
To double-check that the order went through, look up their order in the Orders panel.
To resolve the issue: Ensure that your domain is correctly connected. If you recently connected your domain, it can take up to 72 hours to fully process.
Your order can’t be completed because of an issue with the merchant payment setup. Please contact us about this issue.
This means: Your payment processor account may have been disconnected from Squarespace. You may also see this error in Test Mode. For your security, a payment processor will disconnect if:
To resolve the issue, reconnect your payment processor account:
Payment for your order was declined (email)
This means: There was an unexpected error processing a payment after the customer saw the confirmation screen.
Next steps: The customer wasn’t charged. They should double-check their payment details and try again.
One or more items from your order aren’t available (email)
This means: There was an unexpected error processing a payment, and the product sold out before our system could make a second attempt.
Next steps: The customer wasn’t charged. They should go back to your store to purchase any available items.
A "checkout is closed" message displays
If your site displays a Checkout is closed message, it likely means you haven't connected a payment processor. This message also displays if your customer's currency isn't supported by your payment processor. To find a list of accepted currencies, visit Supported countries and currencies for Squarespace Commerce.
If the customer sees an Authentication failed message, this means their bank is located in the European Economic Area (EEA) and they need to authorize the purchase for Strong Customer Authentication (SCA). Ask your customer to retry the purchase and watch for a pop-up from the bank to authorize the payment. If they continue to have trouble, the customer will need to reach out to their bank for help.
Country unavailable in drop-down menu
If the customer can't select their country in the shipping or billing information, you don’t have a shipping option for that country yet. For help adding a shipping rule, visit Setting country shipping rules.
Expired download products
After a customer orders a download product, they receive a link to download the product. The link will expire 24 hours after it's sent. Clicking an expired link will automatically send a new link to the customer's email address. You can also re-send the link for them:
- Open the order in the Orders panel.
- Click Email notifications.
- Click Send under Resend and Refresh digital goods.
Shopping cart icon is missing
In most templates, the icon appears when a customer adds a product to their cart. In some templates, it always displays.
If your shopping cart icon isn't showing, look for the following potential causes:
- Check that your site has at least one product on a store page.
- Ensure Express Checkout is disabled in Checkout Settings. Enabling Express Checkout disables the shopping cart.
- Check your site styles to see if your shopping cart is hidden.
The shopping cart can be hidden in these templates. Use the listed site styles tweak to show it again.
Tip: In version 7.1, enable the icon in the header to ensure it always displays.
Your store can’t accept real payments while it’s in test mode. To resolve this issue, disable test mode.
Customers can't add products to their carts
If a customer reaches out with trouble adding products to their cart, try these troubleshooting steps:
- Ensure the products are set to visible, and that the store page is live.
- Check for custom code in the product's Additional Information tab and your site's Header Code Injection field. Remove the code to see if that resolves the issue.
- Ask your customer to ensure cookies are enabled on their browser. Here are instructions for Chrome, Firefox, and Safari.
- If you use domain forwarding, ensure you don't use masked forwarding. If your domain provider doesn't offer unmasked forwarding, try connecting your domain to Squarespace instead.