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 coversMAD,TNDandXOF. 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.exampleand example credentials.
Next step
Accounts & balances
Who needs a Broco account and when funds become available.