Skip to main content

Troubleshooting Checkout Errors Your Customers May Experience

This guide helps you troubleshoot when your customers report errors during checkout or sign-up, including what to check and what steps to take.

Written by Costa Bontioti
Updated today

πŸ“ Overview

This guide helps you troubleshoot when your customers report errors during checkout or sign-up. It covers what information to collect, how to determine whether a charge was processed, and what steps to take based on the outcome.

Checkout errors can occur for a variety of reasons, and the right action depends on whether the customer was charged and whether a purchase was created in your dashboard.


πŸ” What Your Customers May See

When a checkout error occurs, customers may experience one of several things. Understanding what they saw helps you determine what happened and what to do next.

Click the arrow to view common error experiences

An error message during checkout β€” The customer may see a message such as "something went wrong" or "payment failed" while attempting to complete a purchase.

An error screen with a reference code β€” In some cases, the customer may be redirected to an error screen that displays a reference code and suggests contacting support.

The checkout process does not complete β€” The customer clicks the purchase button but nothing happens, or the page does not confirm the purchase.

The customer is charged but does not receive their purchase β€” The customer sees a charge on their bank statement, but their membership, class registration, or product does not appear in their account.

The error resolves on a later attempt β€” The checkout fails initially, but when the customer tries again later (minutes, hours, or the next day), it succeeds without any changes.


πŸ“‹ Step 1: Collect Information from the Customer

Before investigating, it is helpful to gather the following information from the customer. This will make it easier to identify what happened and resolve the issue quickly.

Click the arrow to view the information to collect

Ask the customer for as much of the following as possible:

  • What they were trying to purchase β€” membership, class, pass, day pass, course, etc.

  • When the error occurred β€” the approximate date and time

  • What they saw β€” the error message, error screen, or reference code (a screenshot is helpful if available)

  • Whether they were charged β€” ask them to check their bank statement or banking app for a pending or completed charge

  • Whether they tried again β€” and if so, whether the second attempt succeeded

πŸ’‘ If the customer provides a reference code from an error screen, include this when contacting our support team β€” it can help the team identify the issue more quickly.


πŸ’³ Step 2: Check Whether a Charge Was Processed

Once you have the customer's details, the next step is to check your payment processor's dashboard to determine whether a charge was created.

Click the arrow to view the steps for checking your payment processor

If the customer paid via Stripe

Log in to your Stripe Dashboard ➜ Click Payments ➜ Search for the customer by name, email, or amount.

Check whether a charge exists and note its status (Succeeded, Failed, or Incomplete).

πŸ’‘ For a detailed walkthrough, see the guide on checking a payment status in Stripe here.


If the customer paid via GoCardless

Log in to your GoCardless dashboard ➜ Search for the customer ➜ Check whether a payment was created and its current status.


βœ… Step 3: Take Action Based on What You Find

Based on whether a charge was processed and whether the purchase is showing in your dashboard, follow the appropriate path below.

Click the arrow to view the recommended actions

A charge exists and the purchase is showing in the customer's profile

Everything is in order. The customer may have seen an error during checkout, but the payment and purchase were completed successfully. Direct the customer to check their account β€” the purchase should be visible in their profile.


A charge exists but the purchase is NOT showing in the customer's profile

This indicates a sync issue between your payment processor and your dashboard. Contact our support team through the chat widget on your dashboard and provide the charge ID (or payment ID for GoCardless) along with the customer's name and what they purchased. The team can reconcile the payment and link it to the correct purchase.

For a step-by-step guide on handling this scenario, see the guide here.


No charge exists in the payment processor

If no charge was created, the payment was not processed. The customer was not charged. They may see a pending hold on their bank statement, which is common when a payment is attempted but not completed β€” these holds are typically released by the customer's bank within a few business days.

The customer can try going through checkout again. If the error was caused by a card decline, expired card, or insufficient funds, they may need to try with a different payment method or contact their bank.


The error resolved when the customer tried again later

Transient checkout errors can occur due to temporary bank-side restrictions, brief network issues, or processing delays. If a payment fails at checkout but succeeds when the customer tries again shortly after, no further action is usually needed.

If this is happening to multiple customers at the same time, please contact our support team so we can investigate.


⏳ Understanding "Checkout Pending" on Your Class List

During checkout, you may notice a customer appearing on a class list or attendance view with a "Checkout Pending" status. This section explains what this means and when you might see it.

Click the arrow to learn more about checkout pending


When a customer begins the checkout process, the system temporarily holds their spot in the class or event. On the business side, you may see the customer appear with a Checkout Pending status.

This is expected behaviour:

  • The booking is not confirmed until the payment completes successfully.

  • If the payment fails or the customer does not complete checkout, the spot is released.

  • No confirmation emails are sent unless the payment succeeds.

"Checkout Pending" is not specific to any particular product type β€” it can appear during checkout for memberships, classes, passes, or other purchases.

⚠️ If you see a customer stuck in "Checkout Pending" for an extended period, this is not expected. Please contact our support team with the customer's details and the class or event involved so the team can investigate.


⚠️ When Multiple Customers Are Affected

If several customers report checkout errors at the same time, or if the errors are happening across different purchase types, this may indicate a broader issue rather than an individual card or bank problem.

Click the arrow to learn what to do when multiple customers are affected

In this situation, please contact our support team through the chat widget on your dashboard and include the following information:

  • The approximate time the errors began

  • What customers were trying to purchase (membership, class, pass, etc.)

  • How many customers have been affected

  • Any error messages or reference codes that were shared with you

  • Whether any customers were charged but did not receive their purchase

Providing this information upfront helps the team investigate more efficiently.

πŸ’‘ If you have customers who were charged but did not receive their purchase, prioritise gathering their Stripe charge IDs or GoCardless Payment IDs so the support team can reconcile those payments as quickly as possible.


❓ Frequently Asked Questions (FAQs)

Find answers to common questions or additional details that may not be covered in the main instructions.

Click the arrow to view frequently asked questions

A customer says they were charged but their purchase is not showing. What should I do?

Click the arrow to see the answer

Check your payment processor's dashboard (Stripe or GoCardless) to confirm whether a charge was created. If a charge exists but no purchase is showing in your dashboard, contact our support team with the charge ID. For a step-by-step guide, see here.

A customer saw an error but was not charged. Do I need to do anything?

Click the arrow to see the answer

If no charge was created in your payment processor's dashboard, the payment was not processed and no action is needed on your side. The customer can try going through checkout again. If the error repeats, the customer may need to try a different payment method or contact their bank.

A customer's payment failed but worked when they tried again. Why?

Click the arrow to see the answer

Transient checkout errors can happen due to temporary bank-side restrictions, brief network issues, or processing delays. If the payment succeeds on a later attempt, no further action is needed. If this pattern repeats for multiple customers, please contact our support team.

What does "Checkout Pending" mean on my class list?

Click the arrow to see the answer

"Checkout Pending" means a customer has started the checkout process and a spot is being temporarily held for them while their payment is being processed. The booking is not confirmed until the payment completes. If the payment fails or checkout is not completed, the spot is released. If a customer remains in "Checkout Pending" for an extended period, contact our support team.

What should I include when contacting support about checkout errors?

Click the arrow to see the answer

Include the following: the customer's name or email, what they were purchasing, the approximate time of the error, any error messages or reference codes they shared, and whether they were charged (with the Stripe charge ID or GoCardless Payment ID if available). The more detail you provide, the faster the team can investigate.

Can I prevent checkout errors from happening?

Click the arrow to see the answer

Most checkout errors are caused by bank-side issues such as insufficient funds, expired cards, or bank restrictions, which are outside your control. You can help reduce friction by encouraging customers to keep their payment details up to date and by ensuring your payment methods are correctly configured in Settings ➜ Collect Payments.

Did this answer your question?