Marketplace cash reconciliation quickstart

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.

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.

Request

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"
  }'

Response

{
  "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"
}

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.

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.

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.

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.

Event (excerpt)

{
  "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

Collection verification

How the recipient confirms the cash handover.

Get started

Product

Developer

API Reference

Marketplace cash reconciliation quickstart

Next step

Collection verification

​Next step

Collection verification

Next step