basedbank/docs/fahipayapi/04-balance.md

Wallet Balance

Fetch the current balance of the authenticated user's Fahipay wallet.

---

Endpoint

GET https://fahipay.mv/actions/getbalance/?lang=en

---

Prerequisites

• Valid authID from login or OTP
• Valid __Secure-sess session cookie

---

Request

Headers

Header	Value
authid	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
content-type	multipart/form-data
User-Agent	okhttp/4.12.0
Accept-Encoding	gzip
Connection	Keep-Alive
Cookie	__Secure-sess=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Query Parameters

Parameter	Value	Description
lang	en	Language — always en

---

curl Example

curl --request GET \
  --url 'https://fahipay.mv/actions/getbalance/?lang=en' \
  --compressed \
  --header 'Accept-Encoding: gzip' \
  --header 'Connection: Keep-Alive' \
  --header 'Cookie: __Secure-sess=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'User-Agent: okhttp/4.12.0' \
  --header 'authid: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: multipart/form-data'

---

Response

Success

{
  "balance": 1.01,
  "rewards": "0",
  "error": false,
  "type": "success"
}

Field	Type	Description
balance	number	Current wallet balance in MVR
rewards	string	Rewards/cashback points balance
error	bool	false on success
type	string	"success"

All Fahipay wallet balances are in MVR (Maldivian Rufiyaa). There is no multi-currency wallet.

---

Error

{
  "error": true,
  "type": "error",
  "msg": "Unauthorized"
}

If error is true or type is "error", the session is invalid. Re-run the login flow.

---

Notes

• This endpoint only returns the Fahipay wallet balance, not any linked bank account balances.
• The rewards field is returned as a string even though it represents a numeric value. Parse it with toDoubleOrNull().
• Call this endpoint after fetching the profile to construct the full account object with both account number and balance.

---

 

---

← Profile     Next → Transaction History