Skip to main content

What is Broco

Broco is a financial network for cash-based economies. Businesses and customers hold balances in Broco accounts, money moves between those balances, and cash enters the network at Broco cash points. Learn more at broco.app. These guides are for developers who connect a platform to Broco: an online store, accounting or ordering software, or a delivery marketplace. They cover four use cases: Broco Pay, cash checkout, supplier payments and marketplace cash reconciliation. The guides describe Broco’s integration specifications. Production API access is not available at this stage. See Integration access.

How an integration works

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

Discuss your integration with Broco

Broco confirms the use case, the accounts involved and the integration credentials for your platform. See Integration access.
2

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

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

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

Reconcile

Match each result with your reference: order_reference for orders, invoice_reference for supplier invoices.

Use cases at a glance

Conventions used in these guides

  • Amounts are integers in the minor unit of the currency. 50 000 DZD is 5000000. See Currencies & amounts.
  • Examples use DZD. The specification also covers MAD, TND and XOF. This list does not indicate in which countries a service is available.
  • 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

Accounts & balances

Who needs a Broco account and when funds become available.