CheckoutGuard

Description

CheckoutGuard is a WooCommerce plugin that helps store owners recover lost sales by tracking incomplete checkouts and providing tools for follow-up. It also includes fraud prevention, courier analytics, and an automatic success-ratio blocker to protect your store from high-risk orders.

All data is stored locally in your WordPress database. No customer data leaves your server unless you explicitly use the Courier Analytics feature.

Incomplete Checkout Tracking

CheckoutGuard captures customer information and cart contents in real-time as shoppers fill in the checkout form, even if they never click “Place Order”. Data is collected via debounced AJAX calls (800ms delay) to avoid excessive requests. Tracked fields include:

• Billing name, email, phone, and full address
• Order comments
• Cart items (product name, quantity, line total) and cart total
• Customer IP address and WooCommerce session ID

Once captured, each incomplete checkout appears in the Incomplete Checkouts list where you can:

• View full details in a modal popup (customer info, cart items, timestamps)
• Recover the checkout by creating a real WooCommerce order with one click
• Mark as Hold for future follow-up, with an optional follow-up date (YYYY-MM-DD)
• Mark as Cancelled if the checkout is no longer relevant
• Re-open a cancelled checkout back to incomplete status
• Edit follow-up dates on held checkouts

Completed orders are automatically cleaned up: when a customer finishes checkout, their incomplete record is deleted.

Dashboard Overview

The main dashboard gives you a bird’s-eye view of your checkout performance with:

• Pie chart showing the distribution of incomplete, recovered, hold, and cancelled checkouts
• Count cards for each status with clickable links to the detail pages
• Value cards showing the total monetary value for incomplete, recovered, hold, and cancelled checkouts
• Date range filters: Today, Last 7 Days, Last 30 Days, or a custom date range picker
• WordPress Dashboard Widget – a compact summary widget on the main WP dashboard showing the same stats and chart

Fraud Blocker

Prevent unwanted orders by maintaining blocklists for:

• IP Addresses – block by customer IP
• Email Addresses – block by billing email
• Phone Numbers – block by billing phone

When a blocked customer attempts to checkout, WooCommerce displays an error message and the order is not processed. Each blocklist supports:

• Adding items with an optional reason
• Searching/filtering the list
• Deleting items
• Custom block message (configurable in Settings)

You can also block or unblock directly from a WooCommerce order page using the “Fraud Blocker Actions” meta box in the order sidebar, which shows the customer’s IP, email, and phone with one-click Block/Unblock buttons.

Success Ratio Blocker (Automatic)

This feature automatically blocks checkout attempts from customers with a poor delivery success history. It works by:

1. Checking the customer’s phone number against courier delivery data during checkout
2. If their success ratio falls at or below the configured threshold, the order is blocked
3. The blocked attempt is logged with full details (cart, ratio, threshold, IP)

Configurable settings:

• Block Threshold (%) – orders are blocked if the success ratio is at or below this value (default: 20%)
• Grace Period – new customers are not blocked until they have more than this many total orders (default: 5)
• Custom Blocked Order Notice – the message shown to the customer, supports {ratio} placeholder

All blocked attempts are logged in the Blocked Orders Log page where you can view details and delete log entries.

Courier Analytics

Check the delivery success and return ratio for any customer phone number across different courier services (Pathao, RedX, Steadfast). This feature provides:

• Standalone Courier Analytics page – enter a phone number and get a full breakdown
• WooCommerce Order List column – “Success Ratio” column added to the orders table showing a compact ratio badge per order
• Order Detail meta box – “Customer Success Ratio” sidebar box on individual order pages with a “Check Full Ratio” button
• Live ratio check on checkout – real-time feedback shown below the phone field as the customer types (triggers after 10+ digits)
• Doughnut chart visualization for the overall success rate
• Per-courier breakdown by courier service

Ratio data is cached on each order via post meta to avoid redundant API calls.

Order Status Manager

Create and manage custom WooCommerce order statuses from a dedicated admin page. This feature allows you to:

• View status overview cards showing live order counts for every status (default and custom)
• Create custom statuses with a label, color, description, and icon from a visual picker with 30+ order-management icons
• Edit any status including default WooCommerce statuses (Pending, Processing, On Hold, etc.) — change labels, colors, and icons
• Delete any status with automatic order migration — if orders exist on a status being deleted, you are prompted to choose a target status
• Reset to defaults from Settings to restore the original 7 WooCommerce statuses if any were accidentally deleted
• Custom statuses automatically appear in the WooCommerce order status dropdown
• Toggle the feature on/off from Settings > Module Toggles

Checkout Status Management

Each incomplete checkout flows through a clear lifecycle:

• Incomplete – captured but not completed
• Recovered – converted into a WooCommerce order
• Hold – flagged for follow-up with an optional date
• Cancelled – dismissed by admin

Each status has its own dedicated list page with date range filters (Today, 7 Days, 30 Days, All Time, or Custom Range).

WooCommerce Integration

CheckoutGuard integrates deeply with WooCommerce:

• Order list column – adds “Success Ratio” column to both classic and HPOS order lists
• Order sidebar meta boxes – “Customer Success Ratio” and “Fraud Blocker Actions” boxes on every order
• HPOS compatible – works with both classic post-based orders and High-Performance Order Storage
• Checkout hooks – integrates at woocommerce_checkout_process for fraud blocking and woocommerce_thankyou for cleanup

Admin Pages

CheckoutGuard adds the following pages under its own top-level menu:

1. Dashboard – overview with chart and stats
2. Follow Up – checkouts marked as hold, ordered by follow-up date
3. Incomplete – all incomplete checkouts
4. Recovered – checkouts that were converted to orders
5. Blocked Orders – log of automatically blocked checkout attempts
6. Cancelled – dismissed checkouts
7. Fraud Blocker – manage IP, email, and phone blocklists
8. Courier Analytics – check delivery success ratios
9. Order Statuses – manage all WooCommerce order statuses with overview cards
10. Settings – configuration and account management

Third-Party Services

This plugin connects to the following external services:

CheckoutGuard Headquarters (coderzonebd.com)
Used for license validation, usage tracking, and settings synchronization. The plugin sends your site domain and admin email during registration, and periodically syncs license status and usage counts.

• Service URL: https://coderzonebd.com
• Privacy Policy: https://coderzonebd.com/privacy-policy
• Terms of Service: https://coderzonebd.com/terms

Courier APIs (Pathao, RedX, Steadfast)
When the Courier Analytics feature is enabled, customer phone numbers are sent to third-party courier service APIs to retrieve delivery success statistics. This only occurs when explicitly triggered by an admin or during checkout (if the live ratio check is enabled).

Privacy Policy

CheckoutGuard stores personal data locally in your WordPress database. The following data is collected:

• Customer Details: First name, last name, email, phone, billing address (address 1, address 2, city, state, postcode, country)
• Technical Information: Customer IP address, WooCommerce session ID
• Cart Information: Product ID, name, quantity, line total for each item, and total cart value
• Tracking Status: Checkout status (incomplete/recovered/hold/cancelled), follow-up dates, admin notes, recovered order ID
• Blocked Items: IP addresses, email addresses, and phone numbers on the blocklists, with reason and the admin who added them
• Blocked Order Logs: Phone number, email, cart details, cart value, success ratio, threshold at time of block, IP address, customer name, and timestamp

This data is used exclusively within your WordPress admin area for checkout recovery and fraud prevention purposes.

Data is not transmitted to external servers except in the following cases:
* License validation and usage sync with the CheckoutGuard Headquarters API (coderzonebd.com)
* Courier delivery ratio checks when the Courier Analytics feature is enabled (phone numbers are sent to courier APIs)

GDPR Compliance:
CheckoutGuard supports the WordPress personal data export and erasure tools (Tools > Export Personal Data / Erase Personal Data). When a valid request is made, all incomplete checkout records and blocklist entries associated with the requested email address will be included in exports or deleted upon erasure.

Data retention is configurable in Settings (30 days, 90 days, 1 year, or indefinite). If the “Delete all data on uninstall” option is enabled, all plugin tables and options are permanently removed when the plugin is deleted.

A suggested privacy policy text is automatically added to your site’s Privacy Policy page (Settings > Privacy) when the plugin is active.