Description
Every refused cash-on-delivery parcel costs you shipping both ways. Takeed Refusal Guard remembers who refused, and uses that memory when the same person orders again.
How it works
- Mark an order as Refused at delivery (a new order status, also available as a bulk action in the orders list). You can also choose other existing statuses that should count as a refusal.
- The plugin stores the customer’s phone number (normalised) and e-mail address in its own table on your site.
- At the next checkout, if the phone number or the e-mail has at least the number of refusals you set (default: 1), the plugin applies the action you chose:
- Tag only (default): an order note and the order meta
_takrg_risk. Nothing is blocked, nothing is hidden. Safe to try on a live shop. - Hide Cash on Delivery for that customer. Other payment methods stay available.
- Show a neutral notice asking the customer to choose another payment method.
- Tag only (default): an order note and the order meta
What makes it different
- Arab and North-African phone formats built in: Tunisia (+216), Morocco (+212), Algeria (+213), Egypt (+20), Saudi Arabia (+966), UAE (+971), Kuwait (+965), Qatar (+974), Oman (+968), Bahrain (+973).
20 123 456,+216 20123456,00216-20-123-456and٢٠ ١٢٣ ٤٥٦are the same customer. A “default country” setting reads numbers typed without a country code. - Safe by default: the default action only tags the order. The plugin never silently blocks a customer.
- Works with the classic checkout and the block checkout (Store API), and with both order storages: HPOS (custom order tables) and the legacy posts storage.
- Free, no SMS or OTP cost, no account, no external service, no upsell, no ads.
- Arabic-friendly: the admin screens use standard WordPress components and mirror correctly in right-to-left languages. Phone and e-mail fields are always left-to-right.
Also included
- A COD risk column in the orders list (legacy and HPOS screens) showing the refusal count of the customer.
- Settings under WooCommerce > Refusal Guard: threshold, action, counted statuses, default country, add or remove numbers by hand, CSV import and export.
- WordPress personal data exporter and eraser for the stored records.
- Hooks for developers (see the FAQ), so other plugins, such as Takeed order confirmation, can count their own signals.
Privacy
This plugin stores, in a table of your own WordPress database, for every order that was refused at delivery: the phone number (digits only), the e-mail address (lowercase), the order number and the date. Records can also be added by hand or imported by CSV.
- Nothing is sent to the plugin author or to any third party. The plugin makes no external HTTP requests.
- The records are included in the WordPress personal data export (Tools > Export Personal Data) and removed by the erasure tool (Tools > Erase Personal Data), matched by e-mail address and by the phone numbers tied to it.
- A suggested paragraph is added to your privacy policy page (Settings > Privacy).
- Deleting the plugin removes its table and its options.
Screenshots



Installation
- Install and activate WooCommerce, then this plugin.
- Go to WooCommerce > Refusal Guard and check the default country and the action.
- When a parcel is refused, change the order status to Refused at delivery.
FAQ
-
Does it block customers?
-
Only if you choose so. The default action only adds an order note and the meta
_takrg_risk. -
Which customers are recognised?
-
Same phone number (in any format, see above) or same e-mail address. A person who gives a new e-mail but the same phone number is still recognised.
-
How does Hide Cash on Delivery work with the block checkout?
-
Cash on Delivery is removed through the
woocommerce_available_payment_gatewaysfilter, which the Store API also uses, and it is refused again when the order is submitted. In the block checkout the customer sees the message when they try to place the order; in the classic checkout the payment method disappears (or the notice appears) as soon as the phone number or the e-mail is entered, through a one-line inline script that loads no file and contacts no server. -
A customer cancelled by mistake. How do I fix it?
-
Change the order out of the counted status and its record is removed. You can also delete a record, or every record of a phone number or e-mail, in the settings page.
-
Can I import my existing list?
-
Yes. WooCommerce > Refusal Guard > Import CSV. One row per refusal:
phone,email(the header row is optional). Numbers without a country code use the default country. Export gives the same columns plus order, source and date. -
Which hooks are available?
-
do_action( 'takrg_signal', $phone, $email, $order_id, 'takeed' )records a refusal signal from another plugin. The functiontakrg_record_refusal( $phone, $email, $order_id, $source )does the same.apply_filters( 'takrg_refusal_count', $count, $phone, $email )adds signals to the count (for example, Takeed confirmation results).apply_filters( 'takrg_is_risky', $risky, $count, $phone, $email )overrides the decision.apply_filters( 'takrg_counted_statuses', $statuses )changes the statuses that count as a refusal.do_action( 'takrg_refusal_recorded', $id, $row )anddo_action( 'takrg_order_tagged', $order, $count ).
There is no hard dependency between this plugin and any other Takeed plugin.
-
Does it send data anywhere?
-
No. There are no external HTTP calls, no tracking and no analytics.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Takeed Refusal Guard for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Takeed Refusal Guard for WooCommerce” 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
- First release.
