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

# Getting started

> The steps every Broco integration follows, from account connection to reconciliation.

Every Broco integration follows the same five steps. The objects change with the use case; the sequence does not.

<Steps>
  <Step title="Discuss your integration with Broco">
    Broco confirms the use case, the accounts involved and the integration credentials for your platform. See [Integration access](/get-started/integration-access).
  </Step>

  <Step title="Connect the Broco accounts">
    The merchant, supplier or wholesaler authorizes your platform to send or receive funds on their Broco account. Your server stores the connection identifier. See [Authentication & account connections](/developer/authentication).
  </Step>

  <Step title="Create the payment or collection from your server">
    Your server sends the amount, the currency, your order or invoice reference and the connection. Every creation request carries an `Idempotency-Key`.
  </Step>

  <Step title="Handle events">
    Broco notifies your server when money moves. Your server updates the order or invoice from the event, never from a browser redirect. See [Events & webhooks](/developer/events-and-webhooks).
  </Step>

  <Step title="Reconcile">
    Match each result with your reference: `order_reference` for orders, `invoice_reference` for supplier invoices.
  </Step>
</Steps>

## Use cases at a glance

| Use case | Who pays | Who receives | Payment method | Main object |
| - | - | - | - | - |
| [Broco Pay](/broco-pay/overview) | Customer with a Broco account | Merchant | Broco balance | `payment` |
| [Cash checkout](/cash-checkout/overview) | Customer, no Broco account needed | Merchant | Cash at a Broco cash point | `cash_payment` |
| [Supplier payments](/supplier-payments/overview) | Business | Supplier | Broco balance | `supplier_payment` |
| [Marketplace cash reconciliation](/marketplaces/overview) | Recipient of a delivery, no Broco account needed | Wholesaler | Cash on delivery, deposited by the carrier | `collection` |

## Conventions used in these guides

* Amounts are integers in the minor unit of the currency. 50 000 DZD is `5000000`. See [Currencies & amounts](/developer/currencies-and-amounts).
* Examples use `DZD`. The specification also covers `MAD`, `TND` and `XOF`.
* Requests are sent from your server, never from a browser or a mobile app.
* Examples use the reserved domain `api.broco.example` and example credentials.

## Next step

<Card title="Accounts & balances" href="/get-started/accounts-and-balances" horizontal>
  Who needs a Broco account and when funds become available.
</Card>


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