Settle COD by Wallet

Settle by wallet is used when the business wants to clear the driver's pending COD by charging the driver's wallet balance instead of receiving physical cash.

This means the driver may keep the cash collected from customers, while the system deducts the same COD amount from the driver's wallet.

Settlement logic

When you click Settle by Wallet, the system:

1. Finds the selected driver.
2. Finds all COD collections for that driver with status collected.
3. Adds the COD amounts together.
4. Checks whether the driver's wallet balance is enough.
5. Deducts only the COD total from the driver wallet.
6. Marks those COD records as settled_by_wallet.

Example:

Item	Amount
Driver wallet balance	1,000
Pending collected COD	300
Wallet settlement debit	-300
New wallet balance	700

The system does not deduct the full wallet balance. It deducts only the pending COD total.

important

settled_by_wallet is not the same status as remitted. Remitted means cash was handed over. Settled by wallet means the COD was recovered from the driver wallet.

From Dispatcher

Go to Dispatcher -> Remit Collections, then click Settle by Wallet.

Select the driver, add an optional reference, and confirm.

Use this path when the dispatcher or operations team is clearing a driver directly from the remittance screen.

From Tenant Admin

Go to Admin -> Drivers, open the driver, then open the Accounting tab.

Click Settle by Wallet.

Use this path when a tenant admin is reviewing driver accounting and wants to clear all pending collected COD for that driver.

What happens if the wallet balance is too low?

The settlement fails. The system requires the driver wallet balance to be greater than or equal to the pending COD total.

Example:

Item	Amount
Driver wallet balance	200
Pending collected COD	300
Result	Settlement blocked

No COD rows are changed when the wallet settlement fails.

What changes after settlement?

After success:

• A negative wallet transaction is created for the driver.
• The transaction source is COD settlement.
• The COD records become settled_by_wallet.
• Driver accounting shows the wallet-settled COD under order costs / wallet settlement totals.
• The COD records no longer appear as pending collected COD.

When to use wallet settlement

Use wallet settlement when:

• The driver has enough wallet balance.
• The business allows the driver to keep the physical cash.
• You want a clean wallet ledger instead of recording physical cash handover.
• The driver has earnings or credits in wallet that should offset COD owed.

Do not use wallet settlement when:

• The driver has already handed over cash.
• The wallet balance is lower than the COD total.
• The business needs a cash remittance record for the selected COD rows.