Skip to Content
eTulip Docs

Balances and fees

Available XOF by operator, fee calculation and movements.

GET /v1/merchant/account and /v1/merchant/balance return available_minor, gross_collected_minor, fees_minor, transferred_minor, and by_operator for operators the merchant may read. The global amount is the sum of those operator balances.

GET /v1/merchant/movements?page=1&page_size=25 returns each confirmed balance change with amount_minor, fee_minor, delta_minor, balance_before_minor, and balance_after_minor.

The administrator sets collection and transfer rates per merchant/operator. Rates use basis points: 150 = 1.5%, 200 = 2%. For each collection, the applicable rate is captured when the request is created. The fee is rounded to a whole XOF unit (half upward). On a successful collection, net = gross - fee is credited. Failed or pending collections do not credit the balance.

Transfer rates are configurable but no transfer execution endpoint is public yet. transferred_minor remains zero until a verified payout flow is implemented.