> ## Documentation Index
> Fetch the complete documentation index at: https://help.eaglecart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Cash on Delivery in Eaglecart

> Offer Cash on Delivery in Eaglecart. Set its name, instructions, an optional fee, minimum and maximum order amounts and the shipping rates it works with.

[Help Center](https://help.eaglecart.com/introduction.md)

[Payments](https://help.eaglecart.com/payments.md)

Cash on Delivery

# Cash on Delivery

Cash on Delivery (COD) lets customers place an order now and pay when it arrives. It's a manual payment method: Eaglecart doesn't take any money online. The order is created straight away and you collect the payment when the parcel is delivered.

COD is built into Eaglecart. You don't need an account with a payment provider, only to configure it for each region you sell in.

## Before you start

* Decide which regions should offer COD. Payment methods are set up per region. See [Configure payments by region](https://help.eaglecart.com/payments/payments-by-region.md).
* Decide whether to charge an extra fee for COD, and whether to limit it by order amount.
* Check your shipping rates. COD can be limited to specific rates, so it helps to know which ones you offer. See [Set up shipping rates](https://help.eaglecart.com/shipping-delivery/shipping-rates.md).

## Add or edit Cash on Delivery

1. Go to **Settings → Payments**.
2. Select the region on the left.
3. Under **Manual payment methods**:
   * If **Cash on Delivery** isn't listed yet, click **Manual payment method** and choose **Cash on Delivery**.
   * If it's already listed, click the ⋯ menu on its row to edit it.
4. Fill in the fields below.
5. Click **Save**.

When it's active, the row shows an **Active** badge.

## Fields

| Field | What it does |
| - | - |
| **Payment method name** | The name customers see at checkout, for example "Cash on Delivery" or "Pay cash to the driver". |
| **Description** | A short line shown under the name at checkout. Optional. |
| **Payment instructions** | Instructions for the customer, for example "Please prepare exact change for the driver". Shown on the Thank You page and in confirmation emails. Optional. |
| **Additional fee** | An extra charge for choosing Cash on Delivery. Leave it blank for no fee. You can limit the fee to a range of order subtotals, for example to waive it on larger orders. |
| **Availability** | Optional limits: a minimum and maximum order subtotal, and the shipping rates COD can be used with. If you don't select any shipping rates, COD stays available for all of them. |

> [!NOTE]
>
> Write your instructions in the language your customers read. To show them in other store languages, use **Localize** if the method offers it. See [Manage and deactivate payment methods](https://help.eaglecart.com/payments/manage-payment-methods.md).

## When customers see Cash on Delivery

Cash on Delivery has more checkout rules than any other manual method. At checkout it can be shown, shown but greyed out, or hidden:

| Situation | What happens |
| - | - |
| The customer hasn't chosen a delivery method yet | COD is hidden. |
| The chosen shipping rate isn't one you allowed for COD | COD is hidden. |
| The order is above your **maximum** | COD is hidden. |
| The order is below your **minimum** | COD is shown greyed out, with a message telling the customer how much more to add, for example "Add AED 45.00 more to use this method." |
| None of the above | COD is shown and can be selected. |

### Does the minimum include shipping and tax?

No. The minimum and maximum are checked against the **sub-total**: the products only, before shipping and tax. A cart with AED 90 of products and AED 20 shipping has a sub-total of AED 90. If your minimum is AED 100, COD is greyed out.

> [!NOTE]
>
> COD's minimum and maximum decide whether the payment method is offered. They don't change what the customer pays for shipping. Shipping prices come from your shipping rates.

### Why does COD disappear after the customer chooses shipping?

If you limited COD to certain shipping rates, choosing any other rate hides it. For example, if COD is allowed only on your "Standard" rate, a customer who picks "Express" won't see COD. Check the shipping rates selected under **Availability**, or leave none selected to allow all rates.

COD is also hidden before a delivery method is chosen, so customers usually see it appear once they've picked shipping.

## What the customer sees

1. At checkout, the customer selects Cash on Delivery. If you wrote a **Description**, it opens under the name.
2. The button reads **Confirm order**, not "Pay now", because no money is taken online.
3. After they confirm, the order is created immediately and they see the Thank You page with your **Payment instructions**.

## After the order is placed

* The order appears in **Orders** straight away.
* No money has been collected, so the payment isn't marked as paid. It waits until you collect the cash. See [Understanding payment statuses](https://help.eaglecart.com/payments/payment-statuses.md).
* When the courier collects the cash and you've received it, update the order's payment status on the order page. See [Change an order's status](https://help.eaglecart.com/orders/change-order-status.md).

> [!WARNING]
>
> An order paid by Cash on Delivery hasn't been paid when it's created. Only mark it as paid once you've actually received the money.

## Pause or remove Cash on Delivery

* **Deactivate** pauses COD without deleting your settings. You can turn it back on later.
* **Delete** removes the method and its settings.

See [Manage and deactivate payment methods](https://help.eaglecart.com/payments/manage-payment-methods.md).

## Troubleshooting

**Cash on Delivery is missing at checkout.** Check, in order: the customer has chosen a delivery method; that shipping rate is allowed for COD; the sub-total isn't above your maximum; COD is **Active** for the region the customer is shopping in.

**COD is greyed out.** The sub-total is below your minimum. The message shows how much more the customer needs to add.

**COD works in one region but not another.** COD is configured per region. Open **Settings → Payments**, select the other region and set it up there too.

**Customers see "This store can not accept payments at this time. Please try again later."** No payment method is active for that region. Activate at least one.

## Related guides

* [Payment methods at checkout](https://help.eaglecart.com/payments/checkout-payment-methods.md): how all methods are shown, greyed out or hidden.
* [Bank transfer](https://help.eaglecart.com/payments/bank-transfer.md): another manual method, with your bank details.
* [Set up shipping rates](https://help.eaglecart.com/shipping-delivery/shipping-rates.md): the rates you can allow COD on.
* [Understanding payment statuses](https://help.eaglecart.com/payments/payment-statuses.md): what happens to the payment status after a COD order.
* [Set up payments](https://help.eaglecart.com/get-started/set-up-payments.md): the quick-start version.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.