> ## 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 quickstart

> Request a cash collection for a delivery, follow the carrier deposit and match the settlement with your order.

This quickstart follows order `ORD-58213` on your marketplace. The wholesaler collects **50 000 DZD** on delivery and receives the funds in the Broco account connected as `conn_ben_7Lw2cR`.

**1. The wholesaler requests a collection**

At booking, the wholesaler selects cash collection, enters 50 000 DZD and connects their Broco account. Your server creates the collection.

```bash Request theme={null}
curl -X POST https://api.broco.example/v1/collections \
  -H "Authorization: Bearer $BROCO_SECRET_KEY" \
  -H "Idempotency-Key: ORD-58213-collection" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000000,
    "currency": "DZD",
    "order_reference": "ORD-58213",
    "beneficiary_connection": "conn_ben_7Lw2cR"
  }'
```

```json Response theme={null}
{
  "id": "col_3Fk9pQ2w",
  "object": "collection",
  "status": "awaiting_collection",
  "amount": 5000000,
  "currency": "DZD",
  "order_reference": "ORD-58213",
  "beneficiary_connection": "conn_ben_7Lw2cR",
  "collected_at": null,
  "deposit": null,
  "settlement": null,
  "created_at": "2026-10-12T08:30:00Z"
}
```

**2. The carrier accepts the delivery**

Your marketplace shows the carrier that cash collection is requested, the amount to collect and the beneficiary. The carrier accepts the delivery knowing these terms.

**3. The recipient pays and confirms**

At delivery, the recipient hands 50 000 DZD to the carrier and confirms the handover independently. The recipient does not need a Broco account. Broco sends `collection.collected`.

The status is now **Collected / Awaiting deposit**. The carrier holds the cash. The wholesaler's balance does not change. See [Collection verification](https://docs.broco.app/marketplaces/collection-verification.md).

**4. The carrier deposits the cash**

Broco Transporteur shows the assigned cash point and the time left. The deposit is due at `2026-10-13T10:24:00Z`, 24 hours after the confirmed collection. The cash agent counts the cash and confirms the amount received. See [Cash deposits](https://docs.broco.app/marketplaces/cash-deposits.md).

**5. Broco settles the wholesaler**

At final validation of the full deposit, Broco reconciles it with the collection and credits the wholesaler. Your marketplace then receives `settlement.completed`.

```json Event (excerpt) theme={null}
{
  "id": "evt_S7d2Kw9a",
  "type": "settlement.completed",
  "created_at": "2026-10-12T17:05:14Z",
  "data": {
    "id": "col_3Fk9pQ2w",
    "object": "collection",
    "status": "settled",
    "amount": 5000000,
    "currency": "DZD",
    "order_reference": "ORD-58213",
    "beneficiary_connection": "conn_ben_7Lw2cR",
    "settlement": {
      "gross_amount": 5000000,
      "fee_amount": 50000,
      "net_amount": 4950000,
      "currency": "DZD",
      "settled_at": "2026-10-12T17:05:12Z"
    }
  }
}
```

Fee values are examples. Fees follow the agreement between Broco and the wholesaler.

## Next step

> [card] [Collection verification](https://docs.broco.app/marketplaces/collection-verification.md)
>
> How the recipient confirms the cash handover.


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