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

# Marketplace cash reconciliation overview

> Track cash from collection to deposit and match each settlement to the right order.

Marketplace cash reconciliation adds cash on delivery to your marketplace. The recipient pays the carrier in cash. The carrier deposits the cash at a Broco cash point. Broco credits the wholesaler once the deposit is validated and reconciled, and notifies your marketplace.

The examples in this section follow order `ORD-58213`, where a wholesaler collects **50 000 DZD** on delivery.

## Who does what

| Actor | Responsibility | Broco account |
| - | - | - |
| Your marketplace | Offers cash collection at booking and shows its status | Integration credentials |
| Wholesaler | Requests the collection and receives the funds | Required |
| Carrier | Accepts the delivery, collects the cash, deposits it within 24 hours | Uses Broco Transporteur |
| Recipient | Pays in cash and confirms the handover | Not required |
| Cash agent | Counts the deposit and confirms the amount received | Operates a Broco cash point |

## Collected is not available

Cash collected by the carrier is not yet money in the wholesaler's balance. The funds become available at settlement, after the full deposit is validated and reconciled.

| Status | Meaning for the wholesaler |
| - | - |
| Awaiting collection | The cash has not been collected yet |
| Collected / Awaiting deposit | The carrier holds the cash. Funds are not available. |
| Deposit under review | The amount received is being checked or differs from the amount expected |
| Settled | Broco credited the wholesaler. Funds are available. |

## Handover, deposit and settlement

* **Handover.** The recipient confirms the handover independently of the carrier, with a QR code or a code. This records the collection. It does not credit the wholesaler. See [Collection verification](https://docs.broco.app/marketplaces/collection-verification.md).
* **Deposit.** The specification sets the deposit deadline at 24 hours after the confirmed collection. A missed deadline sets `deposit.overdue: true` and leaves the balance unchanged.
* **Late deposit.** A complete deposit validated after the deadline still settles. The collection keeps `deposit.deposited_late: true` for history. See [Cash deposits](https://docs.broco.app/marketplaces/cash-deposits.md).
* **Settlement.** Funds are available to the wholesaler only at settlement. Your marketplace receives `settlement.completed`.

## The flow at a glance

```mermaid theme={null}
flowchart TD

  A["Wholesaler requests the collection<br/>awaiting_collection"]:::step --> B["Recipient pays the carrier in cash"]:::step
  B --> C["Recipient confirms the handover"]:::check
  C -.-> N1["collection.collected"]:::notify
  C --> D["Carrier holds the cash<br/>collected_awaiting_deposit"]:::step
  D --> E["Carrier deposits within 24 hours"]:::step
  E --> F["Agent counts the cash,<br/>Broco validates the full deposit"]:::check
  F --> G["Broco credits the wholesaler<br/>settled"]:::money
  G -.-> N2["settlement.completed"]:::notify
  classDef money fill:#158FAB,stroke:#0E6F86,color:#FFFFFF
  classDef check fill:#E8F4F7,stroke:#158FAB,color:#0E1C29
  classDef notify fill:#FFF6C2,stroke:#B89400,color:#0E1C29,stroke-dasharray:4 3
  classDef step fill:#FFFFFF,stroke:#C9D0D6,color:#0E1C29
```

In this diagram, blue steps move money, light blue steps are validations, and dashed yellow steps are notifications.

The wholesaler's balance changes only at the blue step. See [Cash deposits](https://docs.broco.app/marketplaces/cash-deposits.md) for the detailed deposit path.

**1. Request**

The wholesaler selects cash collection for the order, enters 50 000 DZD and connects their Broco account.

**2. Accept**

The carrier sees the amount and the beneficiary before accepting the delivery.

**3. Collect and confirm**

The recipient pays in cash and confirms the handover with a QR code or a code.

**4. Deposit**

Broco Transporteur shows the assigned cash point. The deposit is due 24 hours after the confirmed collection.

**5. Settle**

The cash agent confirms the amount. After final validation and reconciliation, Broco credits the wholesaler and notifies your marketplace.

## Next steps

> [card] [Quickstart](https://docs.broco.app/marketplaces/quickstart.md)
>
> Follow the 50 000 DZD order end to end.

> [card] [Collections API](https://docs.broco.app/api-reference/collections.md)
>
> Fields, statuses and examples.


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