Skip to main content
Broco Pay lets a customer pay an online order from their Broco balance. The customer’s balance is debited and the merchant’s balance is credited. The money stays inside the Broco network.

How a payment works

In this diagram, blue steps move money, light blue steps are validations, and dashed yellow steps are notifications.
1

The merchant connects their Broco account

The merchant authorizes your website to receive payments into their Broco account and adds Broco Pay to the payment methods at checkout.
2

Your server creates the payment

When the customer selects Broco Pay, your server sends the amount, the currency, the order reference and the merchant connection.
3

The customer authorizes the payment in Broco

A Broco page or the Broco app opens. The customer sees the merchant and the amount, signs in if needed, and confirms.
4

Broco records the payment

The customer’s balance is debited and the merchant’s balance is credited, net of any agreed fees.
5

Your server confirms the result

Broco sends payment.succeeded to your server. Your server marks the order as paid and starts fulfilment.
6

Both parties see the transaction

The customer and the merchant find the payment in their Broco history.
A customer returning to your website does not prove that the payment succeeded. Confirm the status on your server before you fulfil the order.

What you need

When a payment does not go through

Next steps

Quickstart

Integrate a 12 500 DZD order step by step.

Payments API

Fields, statuses and examples.