Mizan COD Rules guide
InstallPayment method nameRulesCash on delivery feeFees that were not addedPause or removePlansLanguagesTroubleshootingYour data
Install
- Install Mizan COD Rules from the Shopify App Store and approve the permissions it asks for.
- The app opens inside your Shopify admin, under Apps.
- Make sure cash on delivery is switched on in your store: in Shopify admin go to Settings, then Payments, then Manual payment methods, and add Cash on Delivery (COD) if it is not there.
The app adds nothing to your theme. It works inside Shopify's checkout.
Permissions and why the app needs them
| Permission | Why |
|---|---|
| Payment customizations | To hide or rename cash on delivery at checkout. |
| Read orders | To see that a new order was paid by cash on delivery and what its total is. |
| Edit orders | To add the cash on delivery fee line to that order. |
Payment method name
The app needs to know what cash on delivery is called in your checkout. The field Name of your cash on delivery payment method starts with Cash on Delivery, COD, which matches Shopify's default.
- If you renamed the method or use another language, type the name exactly as it appears at checkout.
- Separate several names with commas, for example
Cash on Delivery, الدفع عند الاستلام, Contra reembolso. - Part of the name is enough. Capital letters do not matter.
Rules
A rule describes a case where cash on delivery should not be offered. If any one of your rules matches an order, cash on delivery is hidden at checkout. Other payment methods are never affected.
- Press Add rule.
- Choose a condition and enter its value.
- Press Save. The rule applies to the next checkout.
| Condition | What it does | Example value |
|---|---|---|
| Order total is above | Hide cash on delivery for expensive orders. | 5000 |
| Order total is below | Hide it for orders too small to be worth the collection cost. | 100 |
| Delivery country is one of | Hide it in the countries you list. | SA, AE |
| Delivery country is not one of | Offer it only in the countries you list. | EG |
| Delivery province or state is one of | Hide it in specific regions. | C, ALX |
| Postal code starts with | Hide it for postal codes or areas you list. | 115, 12345 |
| Customer has a tag | Hide it for customers you have tagged, such as people who refused a delivery. | no-cod |
| Cart contains a product with a tag | Hide it when a tagged product is in the cart. | prepaid-only |
| Customer has fewer past orders than | Hide it for new customers. A value of 1 means first-time buyers and guests. | 1 |
Good to know
- Totals are compared in your store's own currency, even when the buyer pays in another one.
- Country codes are the two-letter codes: EG, SA, AE, IN, PK, PE, CO, MX and so on.
- Province codes are the codes Shopify uses for the region, which you can see in an order's address.
- Address rules apply once the buyer has entered a complete delivery address and Shopify has loaded the shipping rates.
- Guests have no tags and no past orders. A customer-tag rule never matches a guest; a "fewer past orders than 1" rule always does.
- Lists are separated by commas. You can put up to 100 customer tags and 100 product tags across all rules.
Blocking customers who refuse deliveries
- Open the customer in Shopify admin and add a tag such as
no-cod. - In the app, add the rule Customer has a tag with the value
no-cod.
From then on that customer is not offered cash on delivery when logged in.
Cash on delivery fee
Available on the Pro plan.
- In Cash on delivery fee, choose Add a fee to cash on delivery orders.
- Choose a fixed amount or a percentage of the order total, and enter the amount.
- Check the preview of what the buyer will see, then press Save.
What the buyer sees
- At checkout: the payment method is named with the fee, for example "Cash on Delivery (+20.00 EGP fee)". You can write your own wording in the field Name shown at checkout. If you leave it empty, the app writes it.
- Right after ordering: the fee is added to the order as its own line, and the amount to collect on delivery goes up by the fee.
- By email: if the switch is on, Shopify emails the customer the updated order total.
Details
- A fixed fee is set in your store currency. For orders in another currency it is converted at the order's own rate.
- A percentage fee is calculated on the order total.
- The fee line is not taxed and does not need shipping.
- Orders paid another way, cancelled orders, and orders that already have the fee are skipped.
- Orders that Shopify does not allow to be edited cannot take a fee. They appear in the list below.
Fees that were not added
If adding a fee fails, the app tries again twice within half a minute. If it still fails, the order appears at the top of the settings page under Fees that were not added, with the reason.
- Try again runs it once more.
- Remove from list clears the entry, for example after you added the fee to the order yourself.
Entries are deleted automatically after 60 days.
Pause or remove
- To pause everything without losing your settings, switch off Apply the rules and fee at checkout and press Save.
- To stop for good, uninstall the app. Cash on delivery goes back to showing for every order, and the app deletes what it stored for your store.
Plans
| Plan | Price | Includes |
|---|---|---|
| Free | $0 | 1 rule. All rule types. Email support. |
| Standard | $7.99 / month | Unlimited rules. All rule types. Email support. |
| Pro | $14.99 / month | Everything in Standard. Cash on delivery fee, fixed or percentage. Automatic retries and a missed-fee list. Priority email support. |
Plans are billed by Shopify on your normal Shopify invoice. Change plan at any time from the Plan box in the app. There are no order limits on any plan. Development stores get every feature for free.
Languages
The settings page is available in English, Arabic and Spanish and follows the language of your Shopify admin. Text the buyer sees, such as the checkout name of the fee, is whatever you type, in any language.
Troubleshooting
Cash on delivery is not hidden
- Check the status at the top of the app says Active.
- Check the payment method name in the app matches the name at checkout.
- For address rules, fill in the whole address at checkout and wait for shipping rates to appear.
- For customer-tag rules, the customer must be logged in at checkout.
- In Shopify admin, go to Settings, Payments, then the payment customizations list, and check that "Mizan COD Rules" is active.
Cash on delivery is hidden when it should not be
- Remember that one matching rule is enough. Check each rule against the order.
- "Delivery country is not one of" hides cash on delivery everywhere except the listed countries.
The fee was not added
- Look at Fees that were not added in the app for the reason.
- The fee appears on the order a few seconds after it is placed, not on the checkout page.
- Check the order was paid by cash on delivery and your plan is Pro.
Your data
The app stores no customer names, emails, addresses or phone numbers. See the privacy policy for exactly what it reads and keeps.