Saved Favourites (Contacts)

Fetch the authenticated user's saved favourites for Fahipay payment services. Each service group is fetched individually by page name.

Endpoint

GET https://fahipay.mv/api/app/favs/?page={serviceName}&lang=en

Prerequisites

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

Request

Headers

Header	Value
`authid`	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
`User-Agent`	`okhttp/4.12.0`
`Accept-Encoding`	`gzip`
`Connection`	`Keep-Alive`
`Cookie`	`__Secure-sess=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

Query Parameters

Parameter	Description
`page`	Service group name — see table below
`lang`	Language — always `en`

Service Groups

Call this endpoint once per service group. Labels shown are the ones the app surfaces in the UI (FahipayContactsClient.kt:22-25):

`page` value	Group label	`benefCategoryId`	Description
`ooredooraastas`	`Raastas`	`FAHIPAY_RAASTAS`	Ooredoo mobile top-up
`dhiraagureload`	`Reload`	`FAHIPAY_RELOAD`	Dhiraagu mobile top-up
`ooredoobillpay`	`Ooredoo Bill`	`FAHIPAY_OOREDOO_BILL`	Ooredoo bill payment
`dhiraagubillpay`	`Dhiraagu Bill`	`FAHIPAY_DHIRAAGU_BILL`	Dhiraagu bill payment

curl Example

curl --request GET \
  --url 'https://fahipay.mv/api/app/favs/?page=ooredooraastas&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'

Response

With Entries

The top-level response is a JSON object. The key matching the page query parameter contains an object of saved entries, keyed by an arbitrary server-assigned string.

{
  "ooredooraastas": {
    "1": {
      "number": "9600000001",
      "name": "Ali"
    },
    "2": {
      "number": "7600000002",
      "name": "Mohamed"
    }
  }
}

Empty Group

When the user has no saved favourites for a service, the value for the page key is an empty array (not an object):

{
  "ooredooraastas": []
}

Parse with optJSONObject(page) — this returns null for the empty-array case, so empty groups are safely skipped.

Entry Object

Field	Type	Description
`number`	`string`	The saved phone number or account number
`name`	`string`	User-assigned display name for this favourite

Only entries where number is a valid 7-digit Maldivian mobile number (starting with 7 or 9) are used as transfer contacts.

Usage

Fetch all four service groups in sequence. For each group:

Call GET /api/app/favs/?page={serviceName}&lang=en
Check that response[serviceName] is a JSON object (not an array)
Iterate keys; for each entry, validate number as a phone number
Build a contact entry with the service group as the bank/category label

← Profile Picture

3.1 KiB Raw Blame History