Skip to main content
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.
  • 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.