About this plugin
Codvia COD Rules manages WooCommerce’s Cash on Delivery gateway with rules you can read: charge a fee, hide COD, or always allow COD when conditions match. What it does:
- The fee is taxed properly. Choose taxable or not, and which tax class, per rule or as a default. The tax shows separately in the cart, checkout, emails and invoices, exactly like any other WooCommerce fee.
- Thresholds never count the fee itself. “COD only under 400” means the items total, not items plus the COD fee. Choose whether shipping and tax are part of the amount rules look at.
- Works on the block checkout and the classic checkout. The fee appears the moment the customer picks Cash on delivery, and disappears when they change their mind or their address.
- Tells the customer why. When a rule hides COD, the customer sees your message where the payment options are, instead of a silently missing option. Each rule can carry its own message.
- Unlimited cities and postcodes, free. Paste a list, one per line. Wildcards ( Al *, 1234* ) and numeric ranges ( 10000-19999 ) work. Spelling variants are folded before matching, so “Al-Rayyan”, “al rayyan” and “AL RAYYAN” are one entry, and so are “الريان” and “الريّان” whatever the hamza, taa-marbuta or alef-maqsura. List a city in both scripts to catch both — the ready-made lists for Qatar, Saudi Arabia, UAE, Kuwait, Bahrain, Oman and Egypt already include both, and insert with one click.
- The fee shows in emails, invoices and the order. It is a real WooCommerce fee line, tagged with the rule that created it, and every order gets a note explaining the decision.
- Explainable. The scenario tester shows, rule by rule and condition by condition, why a given customer gets a fee or loses COD. Test unsaved rules before you publish them.
- One-click import from Smart COD. If you used Smart COD for WooCommerce, your restrictions, fees and messages are rebuilt as rules in a few seconds. Your existing settings are not touched.
Conditions (free)
Order amount, item quantity, city, postcode, state/region, country, shipping method, customer role.
Pro
- Date & time schedules – restrict COD or change the fee on certain days, hours or date ranges (Ramadan and Eid delivery windows, with the Hijri date shown next to the Gregorian one).
- Product, category, shipping class, cart weight and coupon conditions.
- Customer history – e.g. hide COD for first-time buyers, or waive the fee for repeat customers.
- Manual and phone orders – the fee line is added, updated or removed when an admin order set to COD is recalculated.
- Priority support.
How rules run
Rules run top to bottom. The first matching hide rule hides COD and stops. The first matching fee rule sets the fee.
An allow rule that matches protects COD from any hide rule below it. Every rule can require all of its conditions, or any of them.
For developers
Filters: crfw_condition_types, crfw_match_condition, crfw_decision, crfw_cart_fee, crfw_gateway_id, crfw_presets, crfw_rules, crfw_context_from_cart, crfw_context_from_order, crfw_pro_active. REST namespace crfw/v1. The block checkout receives the decision under extensions["cod-rules"] on the Store API cart response.