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

> Collect 50 000 DZD on delivery, from request to settlement.

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`.

<Steps>
  <Step title="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"
    }
    ```
  </Step>

  <Step title="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.
  </Step>

  <Step title="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](/marketplaces/collection-verification).
  </Step>

  <Step title="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](/marketplaces/cash-deposits).
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Next step

<Card title="Collection verification" href="/marketplaces/collection-verification" horizontal>
  How the recipient confirms the cash handover.
</Card>


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