Riders Delivery for WooCommerce

Riders Delivery for WooCommerce connects your WooCommerce store to the Riders Kuwait delivery platform. It handles the entire flow — from address capture at checkout all the way to order delivery and tracking.

Key Features

• Kuwait address widget at both classic and Blocks (Gutenberg) checkout: Governorate → Area → Block → Street → House cascading dropdowns
• Civil ID / PACI lookup — customers can auto-fill their address from their Kuwaiti civil ID number
• Automatic or manual order sync to Riders via Action Scheduler background jobs
• Delivery status polling — order status updated every 5 minutes; or instantly via webhook push
• Webhook support — receive real-time status updates from Riders (HMAC-verified)
• Admin orders list — filter by sync status, retry failed orders individually or in bulk
• Per-order meta box — view sync status, delivery fee, fleet number, and edit the Kuwait address with cascading dropdowns directly in the WooCommerce order
• Tracking links — fleet tracking link appended to WooCommerce order completion emails
• Proper WC_Shipping_Method — add Riders Delivery to any shipping zone with configurable flat rate and free-shipping threshold
• WooCommerce REST API extension — /wc/v3/orders responses include ridedefo_sync_status, ridedefo_uid, and ridedefo_fleet_number
• English and Arabic (RTL) support
• HPOS compatible — High-Performance Order Storage declared and tested
• Idempotent sync — duplicate delivery prevention with syncing-status guard
• Transient-cached geo data — governorates/areas/blocks/streets cached for 1 hour to reduce API calls

Requirements

• WooCommerce 7.5 or higher
• PHP 8.0 or higher
• A Riders vendor account with an API key

External Services

This plugin connects to the Riders delivery platform (https://tryriders.com) to sync WooCommerce orders and retrieve Kuwait address data.

API endpoint: https://app-order.tryriders.com/api API documentation: https://app-order.tryriders.com/docs/vendor Vendor portal: https://vendor.tryriders.com

Data sent to Riders:

• Order details (items, total, billing/shipping address, customer phone) — when an order is synced
• Kuwait Civil ID number — only when a customer voluntarily uses the PACI lookup to auto-fill their address

All requests are made over HTTPS. A Riders vendor account and API key are required. Please review the Riders website (https://tryriders.com) for terms and privacy information before using this plugin.

Development

Source code: https://github.com/Phoenix-H22/riders-woocommerce-plugin

The Blocks checkout script is built with @wordpress/scripts.

Source: assets/checkout/blocks/src/index.js Compiled output: assets/checkout/blocks/build/index.js

The same source is also included in this plugin package under assets/checkout/blocks/src/.

To rebuild from source:

1. npm install
2. npm run build