Gihantha Cash on Delivery Order Protection

Description

Every refused Cash on Delivery parcel costs you twice: the delivery fee and the return fee, plus stock stuck in transit for days.

Gihantha Cash on Delivery Order Protection checks every COD order at checkout and keeps a delivered / refused history for each phone number, so you can stop bad orders before you ship them.

Works for stores in any country. It was first built in Sri Lanka, where Cash on Delivery is the most popular way to pay online, so Sri Lankan numbers get extra-strict checks. Everything runs on your own site: no sign-up, no API key, no data sent anywhere.

Checkout protection

  • Phone number validation for every country – reads each number using the customer’s billing country, in any format (+44 7700 900123, 0044…, 07700 900123), and rejects numbers that cannot be real.
  • Extra-strict Sri Lanka checks – Sri Lankan numbers must be real mobile numbers (+94 77…, 0094…, 077…). You can allow landlines too.
  • Fake number detection – blocks numbers like 0777777777, 0711234567 or +44 7777 777777.
  • Repeat order blocking – stops a second COD order from the same number while the first one is still open.
  • Maximum COD order value – stop COD orders above an amount you choose.
  • COD handling fee – optionally add a fee when the customer chooses COD.
  • Clear messages – customers see a friendly explanation, which you can edit.

Phone blacklist and trusted list

  • Block any number from using COD, or mark good customers as trusted so they skip all checks.
  • Auto-block numbers after a set number of refused parcels (default: 2).

Delivery tracking

  • Mark orders as delivered or refused / returned from the order screen or with bulk actions on the orders list.
  • Completed COD orders are counted as delivered automatically.
  • A COD Protection column on the orders list shows each customer’s history: Good, Risky, Blocked, Trusted or New, with delivered and refused counts.

Dashboard

See your COD return rate, delivered and refused parcels, how many risky checkouts were stopped, and an estimate of the money saved.

Compatibility

  • Works with both the block checkout and the classic checkout.
  • Compatible with WooCommerce High-Performance Order Storage (HPOS).
  • Translation ready.

Screenshots

Installation

  1. Make sure WooCommerce is installed and active.
  2. Install Gihantha Cash on Delivery Order Protection from Plugins > Add New, or upload the gihantha-cash-on-delivery-order-protection folder to /wp-content/plugins/.
  3. Activate the plugin.
  4. Go to WooCommerce > COD Protection > Settings and choose your rules.

FAQ

Does it send customer data anywhere?

No. All data stays in your own WordPress database. The plugin makes no external requests.

Does it work outside Sri Lanka?

Yes. Phone numbers are read using the customer’s billing country, so +44 7700 900123 and 07700 900123 count as the same customer for the blacklist and the repeat-order check. Numbers from any country must be complete (8 to 15 digits including the country code), and Sri Lankan numbers must also be valid mobile numbers (you can allow landlines in the settings).

If you do not want phone validation at all, untick “Validate phone numbers”. The blacklist, repeat-order blocking, COD limit, COD fee and delivery tracking keep working.

I added a customer from another country to the blacklist. How should I type the number?

Include the country code, for example +44 7700 900123. Numbers without a country code are read as numbers from your store’s country.

How does a number get blocked automatically?

When you mark an order as refused / returned, the refusal is added to that phone number’s history. When a number reaches the refusal limit in settings (default 2), it is blocked from using COD.

Should the phone field be required?

Yes, we recommend it. In the block checkout, edit the Checkout page, select the Phone field and set it to required. If a customer leaves it empty, COD Protection asks them for a valid mobile number before a COD order can be placed.

A good customer was blocked. What do I do?

Go to WooCommerce > COD Protection > Phone numbers and click Trust or Reset next to their number.

Does it work with the block checkout?

Yes. All checks and the COD fee work on both the block and the classic checkout.

What happens to my data if I delete the plugin?

Deleting the plugin removes its table and settings. Deactivating keeps them.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Gihantha Cash on Delivery Order Protection” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.1.0

  • First release.