WWooshPayment docs
Operations

Live checkout troubleshooting

How to read the live checkout monitor and distinguish normal abandonment from SDK, iframe, webhook or store-integration issues.

3 min read

The Live checkout monitor helps you understand what is happening while traffic is coming in: users on product pages, users on checkout, payment attempts, completed orders and possible technical issues.

Not every checkout without an order is a bug. Customers abandon because of price, shipping, payment method availability, declined cards, closed wallets or normal hesitation. Use this page to separate normal abandonment from technical signals.

1. Quick reading

SignalMeaningAction
Active user on productThe customer clicked or opened the cart/storeNo action
Active user on checkoutThe customer reached WooshPayment checkoutWatch whether they continue to payment
Completed orderWhop/COD completed correctlyNo action
Low conversion rate without technical errorsLikely commercial abandonmentReview price, shipping, trust and payment methods
Repeated technical eventsPossible SDK/iframe/integration issueFollow the checklist below

2. Technical issue vs normal abandonment

Treat as normal:

  • customer closes wallet or 3DS;
  • card is declined by the bank;
  • customer expects PayPal/Klarna and leaves;
  • user opens checkout and never fills the form;
  • session expires after inactivity.

Treat as technical:

  • Whop iframe never becomes ready;
  • payment not ready, iframe null/ref, or SDK submit unavailable;
  • init-payment or prepare-payment fails before submit;
  • Pay click gets stuck without sheet, iframe, visible decline or Whop payment;
  • Whop shows paid but WooshPayment remains pending because the webhook did not arrive.

3. Checklist when you see technical events

  1. Open Dashboard โ†’ Orders and filter technical orders.
  2. Check whether the session has iframe/SDK events before the Pay click.
  3. If the payment never started, the customer can retry: there is no double-charge risk.
  4. If Whop shows an open, incomplete or pending payment, wait or refresh status before asking the customer to retry.
  5. If Whop shows paid but WooshPayment does not complete, ask support for a backfill with session token and Whop payment id.

4. Shopify

On Shopify, the cart redirect runs through the ScriptTag.

If checkout does not open:

  1. Dashboard โ†’ Settings or Integrations โ†’ verify Shopify installation.
  2. If the status is red, click Reinstall or complete OAuth again.
  3. Open the Shopify theme and click Checkout from both normal cart and cart drawer.
  4. If it still does not intercept, use Script tag debug.

5. WooCommerce

On WooCommerce, the cart redirect runs through the official WooshPayment Checkout plugin.

If checkout does not open:

  1. WordPress โ†’ Plugins โ†’ verify WooshPayment Checkout is active.
  2. WordPress โ†’ Settings โ†’ WooshPayment โ†’ check the health page.
  3. Dashboard โ†’ Integrations โ†’ WooCommerce โ†’ verify store URL and REST keys.
  4. Test both classic cart and block cart.
  5. If the REST API fails, regenerate Consumer Key + Consumer Secret with Read/Write permissions.

6. When not to use hosted fallback

Hosted fallback is a technical parachute, not a second checkout to use all the time.

Do not use it when:

  • card is declined;
  • 3DS or wallet is closed by the customer;
  • customer abandoned by choice;
  • a payment already exists on Whop.

It only makes sense when the payment truly did not start and the preflight confirms there is no double-charge risk.