LakiConnect

Platform fees & revenue sharing

Fee Configuration

Fee rules are configured at two levels:

Master default — applies to all connected accounts without an override.
Per-connected override — applies to a specific connected account; takes precedence.

Get Fee Configuration

Endpointbash

# Master default
GET /api/v2/lakiconnect/connected-accounts/fee-config
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxx

# Per-connected resolved config
GET /api/v2/lakiconnect/connected-accounts/fee-config
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxx
X-Connected-Merchant-ID: cm_a1b2c3d4-e5f6-7890-abcd-ef1234567890

The per-connected endpoint returns the resolved configuration — either the per-connected override if set, or the master default.

Set Fee Configuration

Endpointbash

PUT /api/v2/lakiconnect/connected-accounts/fee-config

Master default (no connected merchant header):

JSONjson

{
  "fee_model": "PERCENT",
  "fee_value": 5.0
}

Per-connected override (with X-Connected-Merchant-ID header):

JSONjson

{
  "fee_model": "FIXED",
  "fee_value": 500
}

Fee Models

Model	Description	Example
`FREE`	No platform fee deducted.	Connected merchant receives 100% of gross.
`PERCENT`	Percentage of transaction amount.	5% on ETB 25,000 → ETB 1,250 platform fee.
`FIXED`	Flat fee per transaction.	ETB 500 flat on every deposit.

Settlement Math

For a transaction of ETB 25,000 with a 5% PERCENT fee model:

Headerstext

gross_amount         = 25,000 ETB
platform_fee         = 25,000 × 0.05 = 1,250 ETB
merchant_net         = 25,000 - 1,250 = 23,750 ETB

→ Connected merchant wallet credited: 23,750 ETB
→ Master merchant wallet credited:     1,250 ETB
→ Derived MASTER_FEE transaction created, linked via parent_transaction_id

Connected Merchant Wallet

Endpointbash

GET /api/v2/lakiconnect/connected-accounts/wallet
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxx
X-Connected-Merchant-ID: cm_a1b2c3d4-e5f6-7890-abcd-ef1234567890

Response

JSONjson

{
  "connected_merchant_id": "cm_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "balance": 47500,
  "currency": "ETB",
  "pending_balance": 23750,
  "updated_at": "2025-10-01T09:05:00Z"
}

Continue

Webhooks & events

Next section in this guide.