Wallet Balance

This endpoint is used to fetch the wallet balance in real time.

Endpoint

GET https://api.lipila.dev/api/v1/merchants/balance

Headers

The following headers are accepted.

Header	Type	Description	Required
accept	application/json	Expected response format	Yes
x-api-key	string	Wallet API authentication key	Yes

---

Example Request

curl -X 'GET' \
  'https://api.lipila.dev/api/v1/merchants/balance' \
  -H 'accept: application/json' \
  -H 'x-api-key: your_secret_key'

Example Successful Response

Below is an example successful response.

{
  "success": true,
  "message": "Wallet balance retrieved successfully.",
  "data": {
    "balance": 80.771
  }
}

HTTP Status Code	Error Code	Description
200	SUCCESSFUL	Request successful
401	UNAUTHORIZED	Missing or invalid API key
403	FORBIDDEN	API key is inactive or revoked
429	TOO MANY REQUESTS	Rate limit exceeded, slow down requests