Payments
Track payment status and method for every delivery task. Deliverty Hub records payment details to give dispatchers and admins visibility into cash flow and collection status.
Payment Methods
Each task can have a payment associated with it. The platform supports three payment methods:
| Method | Description |
|---|---|
| CASH | Cash on delivery. The agent collects payment from the customer at the drop-off location. |
| ONLINE | Pre-paid online payment. No cash exchange happens during delivery. |
| WALLET | Paid via a digital wallet or credit balance within the sending system. |
Payment Statuses
Every payment goes through a status lifecycle:
| Status | Meaning |
|---|---|
| PENDING | Payment has been created but not yet collected or confirmed. |
| PAID | Payment has been successfully collected or confirmed. |
| CANCELLED | Payment was cancelled (typically when the task is cancelled). |
| REFUNDED | Payment was collected but later refunded to the customer. |
| FAILED | Payment processing failed (e.g., online payment gateway error). |
Payment Fields
| Field | Type | Description |
|---|---|---|
amount | Decimal | The payment amount (e.g., 150.00) |
currency | String | ISO currency code. Supported: EGP, USD, EUR, GBP, SAR, AED, KWD, QAR, OMR, BHD, JOD, LBP, TRY, CAD, AUD, JPY, CNY, INR |
method | Enum | One of: CASH, ONLINE, WALLET |
status | Enum | One of: PENDING, PAID, CANCELLED, REFUNDED, FAILED |
reference | String | External payment reference (e.g., gateway transaction ID) |
notes | String | Optional notes about the payment |
Cash on Delivery (COD)
The most common payment method for last-mile delivery in many markets. The workflow is:
- Task is created with
method: CASHand a specified amount. - Payment starts in PENDING status.
- The agent collects cash from the customer upon delivery.
- The agent confirms collection in the Deliverty Driver app.
- Payment status moves to PAID.
For cash-heavy operations, dispatchers can create cash_drop tasks to instruct agents to deposit collected cash at a designated location. This helps manage cash flow and reduces risk for agents carrying large amounts.
Online Payments
When the customer has already paid online, the task is created with method: ONLINE. The payment is typically already in PAID status. The agent simply delivers the package without collecting payment.
Supported Currencies
Deliverty Hub supports 18 currencies out of the box. The currency is set per-payment and is typically determined by the organization's default currency or the channel's configuration:
Payments in the Dashboard
The task detail view in the dashboard shows the payment section with:
- Payment amount and currency
- Current payment status with a colored badge
- Payment method (cash, online, wallet)
- External reference if available
- Timestamp of the last status change
Admins can filter the task list by payment status to quickly find unpaid or pending deliveries.