Description
FlashQ 1-Hour Delivery integrates your WooCommerce store with FlashQ’s rapid delivery network, enabling you to offer 1-hour delivery to customers in supported regions across Egypt.
Features:
- 1-Hour Delivery – Offer ultra-fast delivery in select districts
- Region-Based Availability – Automatic region detection and product filtering
- Real-Time Inventory Sync – Automatic stock updates from FlashQ
- Customizable UI – 4 header banner styles to match your brand
- Flexible Pricing – Support for free shipping thresholds
- Smart ETA Calculation – Automatic delivery time based on order time
- Order Status Sync – Real-time updates from FlashQ to your store
- API Logging – Built-in logging for debugging and compliance
How It Works:
- Customer selects their delivery region
- System shows only products available for 1-hour delivery in that region
- At checkout, customer gets 1-hour delivery option if eligible
- Order automatically sent to FlashQ for fulfillment
- Real-time status updates sync back to WooCommerce
Requirements:
- WooCommerce 6.0 or higher
- FlashQ API credentials (contact FlashQ for access)
- Products with matching SKUs in FlashQ inventory
Developer Documentation
Hooks & Filters:
Action: flashq_shipping_upgrade
Fires when the plugin version is upgraded.
Parameters: $old_version (string), $new_version (string)
Filter: flashq_shipping_regions
Modify the list of available regions before they are displayed.
Parameter: $regions (array)
Filter: flashq_shipping_payment_map
Customize the payment method mapping sent to FlashQ.
Parameter: $payment_map (array)
REST API Endpoints:
POST /wp-json/flashq/v1/webhook
Receive inventory and order-status updates from FlashQ.
Authentication: X-FlashQ-API-Key header (auto-generated; see WooCommerce > FlashQ 1-Hour > API Configuration)
GET /wp-json/flashq/v1/regions
Return all active regions flagged for display in the customer modal.
Authentication: none required.
POST /wp-json/flashq/v1/regions/select
Store the customer’s selected region in their WooCommerce session.
Authentication: WP REST nonce (X-WP-Nonce header).
More Information:
- Documentation: https://github.com/wordpressfan/flashq-shipping/blob/trunk/docs/PLUGIN_DOCUMENTATION.md
- Support: https://github.com/wordpressfan/flashq-shipping/issues
Installation
Automatic Installation:
- Go to Plugins > Add New
- Search for “FlashQ 1-Hour Delivery”
- Click “Install Now”
- Activate the plugin
Manual Installation:
- Download the plugin ZIP file
- Go to Plugins > Add New > Upload Plugin
- Choose the ZIP file and click “Install Now”
- Activate the plugin
Configuration:
- Go to WooCommerce > FlashQ 1-Hour
- Enter your FlashQ API credentials:
- API URL
- API Key
- HMAC Secret
- Configure general settings (operating hours, delivery time, etc.)
- Set up the FlashQ shipping method in WooCommerce > Settings > Shipping
- Share your webhook URL with the FlashQ team
FAQ
-
Do I need a FlashQ account?
-
Yes, you need to sign up with FlashQ and obtain API credentials. Contact FlashQ at https://flashq.io
-
Which regions support 1-hour delivery?
-
Currently available in select districts across Cairo and Giza. The list of supported regions is updated automatically with plugin updates.
-
How is inventory synced?
-
FlashQ sends automatic inventory updates to your store via webhooks whenever stock changes. Your main WooCommerce inventory remains separate.
-
What happens if a product is out of stock?
-
If a product is available in FlashQ inventory, it will be shown as available for 1-hour delivery regardless of your main WooCommerce stock.
-
Yes. You can choose from 4 pre-designed styles in WooCommerce > FlashQ 1-Hour > General settings.
-
How are orders sent to FlashQ?
-
When a customer selects FlashQ 1-hour delivery and completes checkout, the order is automatically sent to FlashQ’s API for fulfillment with an HMAC-signed request.
-
What if the FlashQ API is down?
-
The order will still be created in WooCommerce with a note indicating the API failure. The plugin will automatically retry up to 3 times (at +1, +3, and +5 minutes).
-
Is my data secure?
-
Yes. All outbound requests to FlashQ are signed with HMAC-SHA256. Inbound webhook requests are authenticated with an auto-generated API key. No sensitive data is exposed in the frontend.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“FlashQ 1-Hour Delivery” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “FlashQ 1-Hour Delivery” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- 1-hour delivery shipping method
- Region-based product filtering
- Real-time inventory sync via webhooks
- Order status synchronization
- Customizable header banner (4 styles)
- Region selection modal
- Dedicated product page
- API logging and monitoring
- Automatic order retry on API failure (3 retries)
- HMAC-SHA256 signed outbound requests
- WooCommerce HPOS compatibility