Troubleshooting

Connection Issues

"Invalid API key" Error

Verify the API key in CR Bee Connect > Connection
Generate a new key if needed (CR Bee Admin > Settings > Developer)
Check that the API URL is correct and accessible

"Connection failed" Error

Verify the API URL is correct (e.g., https://your-slug.crbeeapp.com)
Ensure no trailing slash in the URL
Check if your server can make outgoing HTTPS requests
Verify SSL certificates are valid

429 Rate Limited

The API has rate limits per key. If you see "Rate limited" errors, you're making too many requests
Wait the time specified in the error message
Consider caching on the WordPress side (the plugin does this automatically)

Booking Flow Issues

Blank Page on Shortcode Pages

Verify the shortcode is spelled correctly (e.g., [cr_bee_search], not [crbc_search])
Check that the plugin is activated
Look for PHP errors in your WordPress debug log (wp-content/debug.log)

"Session expired" on Addons/Checkout

Sessions last 2 hours. If the customer took too long, they need to restart
Verify the crbc_session cookie is being set (check browser DevTools > Application > Cookies)
Ensure your cache plugin isn't stripping cookies on booking pages

No Vehicles Showing in Results

Check that vehicles have prices set in the CR Bee admin
Verify the search dates are valid (not in the past, within operating hours)
Check that vehicles are not blocked for the selected dates
Try flushing the cache (CR Bee Connect > Cache > Flush Cache)

Verify all pages are assigned in CR Bee Connect > Pages tab
Check that each page contains the correct shortcode
Ensure pages are published (not draft)

Vehicle Details Returns 404

Check that the vehicle slug in the URL matches an existing vehicle
The slug may have changed — update the URL

Payment Issues

"Online payments are not available"

Stripe is not configured for this tenant
Check Settings > Payments in the CR Bee admin

Stripe Redirect Fails

Verify success/cancel URLs are correctly configured
Check that the Stripe webhook is set up for checkout.session.completed
Review Stripe Dashboard for payment errors

Caching Issues

Data Not Updating After Admin Changes

Click Flush Cache in CR Bee Connect settings
Verify the webhook is registered (check Cache tab)
If webhook is not registered, click Test Connection to re-register
Clear your page cache plugin's cache

Booking Flow Not Working After Enabling Cache Plugin

Ensure booking flow pages are excluded from caching
The plugin sets DONOTCACHEPAGE automatically, but some cache plugins require manual URL exclusion
For WP Rocket: the plugin handles exclusions automatically; if issues persist, manually exclude booking page URLs in WP Rocket settings

Debugging

Enable WordPress Debug Logging

Add to wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Errors will be logged to wp-content/debug.log.

Check Browser Console

Open browser DevTools (F12) > Console tab. CR Bee plugin errors are prefixed with [CR Bee].

Check Network Tab

Open browser DevTools > Network tab. Filter by admin-ajax.php to see API calls made by the plugin and their responses.