Troubleshooting

Troubleshooting

"OCart requires Orravo Core" notice

OCart has a hard dependency on Orravo Core (declared via Requires Plugins: orravo-core). Install and activate the Orravo Core plugin, then refresh wp-admin. The notice is registered on plugins_loaded at priority 0 and disappears once ORRAVO_CORE_LOADED is defined.

Recovery emails not sending

Check three places, in order:

1. Action Scheduler queue. Tools, Scheduled Actions and filter for ocart/recovery/dispatch. The hook should be running every minute. If it is missing, deactivate and reactivate OCart - OCart_Activator reschedules it.
2. Suppression. Look in wp_ocart_suppression for the recipient email or phone. Bounces, complaints, and unsubscribes block future sends to the same recipient.
3. Deliverability events. Reports, Deliverability shows the most recent sends and bounces by channel. A 100% bounce rate usually means a missing or misconfigured email transport.

Upsell charge returns gateway_no_off_session

The gateway adapter for the parent order does not support off-session charges. This happens when the original order was paid by a method without a saved tokenized payment instrument (for example a bank transfer or COD). Either restrict the upsell offer with targeting rules to orders paid by Stripe / Paystack / PayPal, or skip the one-click flow and use a checkout-style upsell instead.

Upsell returns token_expired

The HMAC-signed upsell token has a default TTL of 30 minutes (upsells.one_click_token_ttl_min). If the buyer waits longer than that on the thank-you page, the token expires. Increase the TTL in OCart, Settings, Upsells if your funnel has longer dwell times.

A/B test stuck at "running"

The Bayesian engine auto-stops on significance once the configured significance threshold (default 0.95) is crossed and power_target (default 0.80) is met. If a test has been running for weeks without concluding, the variants are likely too close together for the configured mde_relative (default 0.10, i.e. 10% minimum detectable effect). Tighten the MDE or add a manual stop from the Tests admin.