API · Direct

Balance

The current state of your merchant float. Three buckets per currency: available (settled, can be paid out), pending (in-flight settlements), and reserved (held against disputes or fraud).

1 endpoint

Endpoints

GET/v1/balance

Retrieve your current balance, snapshot-style.

Response shape

Name	Type	Description
`available` required	array	Per-currency available balance. Pay-outable today.
`pending` required	array	Funds in-flight. Move to available once provider settlement clears.
`reserved` required	array	Held against disputes, chargebacks, fraud rules. Releases over time per policy.
`updated_at`	datetime	Snapshot timestamp.

Sample

bashbash

curl https://api.merashub.com/v1/balance \
  -H "Authorization: Bearer sk_test_..."

200 OKjson

{
  "available": [
    { "currency": "DJF", "amount_minor": 8750000 },
    { "currency": "USD", "amount_minor": 12500 }
  ],
  "pending":   [
    { "currency": "DJF", "amount_minor":  450000 }
  ],
  "reserved":  [
    { "currency": "DJF", "amount_minor":   75000 }
  ],
  "updated_at": "2026-05-25T10:15:30Z"
}