basedbank/docs/fahipayapi/03-profile.md

User Profile

Fetch the authenticated user's full profile, including personal details, linked bank accounts, wallet settings, and permissions.

---

Endpoint

GET https://fahipay.mv/actions/getprofile/?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

---

curl Example

curl --request GET \
  --url 'https://fahipay.mv/actions/getprofile/?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

{
  "nidexpiry": "2027-06-01",
  "about": "",
  "email": "user@example.com",
  "country": "Maldives",
  "fullname": "Mohamed Ali",
  "postcode": "",
  "props": {
    "accs": {
      "bml": {
        "mvr": "7730000000001",
        "usd": "7730000000002",
        "mvr2": "7770000000003"
      },
      "cbm": {
        "mvr": "1000000001"
      },
      "mib": {
        "mvr": "90101000000001000",
        "usd": "90101000000002000"
      },
      "sbi": {
        "mvr": "12600000000001"
      }
    },
    "lang": "en",
    "wsize": 5000,
    "withdraw": {
      "fee": "3",
      "unit": "%",
      "freelimit": 0
    },
    "IDverified": 1,
    "thresholds": {
      "amount": 0,
      "countries": {
        "list": [],
        "mode": "deny"
      },
      "frequency": 0
    },
    "amountTopup": 1,
    "receiptTopup": 1,
    "verifiedWith": "efaas",
    "notifications": {
      "txn": ["push"],
      "login": ["push", "email"],
      "balance": ["push"]
    },
    "allowedActions": [
      "withdraw",
      "payment",
      "topup",
      "transfer"
    ],
    "two_factor_enabled": 1,
    "efaas_login_enabled": 0,
    "acc": "500000000001",
    "walletType": "basic"
  },
  "mobile": "9600000001",
  "city": "101",
  "nid": "A123456",
  "level": "1",
  "address": "Example Address",
  "accs": {
    "bml": [
      { "name": "MOHAMED ALI" }
    ]
  },
  "invitecode": "XXXXX",
  "profileID": "0000",
  "verificationUploadMethods": ["camera", "file"],
  "faceVerificationRequired": true,
  "p2pqr": "https://fahipay.mv/api/qrcode/?data=9600000001",
  "smsAuth": "xxxxxxxxxxxxxxxxxxxx",
  "type": "success"
}

---

Key Fields

Top-level

Field	Type	Description
fullname	string	User's full name
email	string	Registered email address
mobile	string	Registered mobile number
nid	string	National ID card number (e.g. A239225)
nidexpiry	string	NID expiry date (YYYY-MM-DD)
profileID	string	Fahipay internal numeric user ID — use in loginTag
level	string	Account verification level
country	string	Registered country
city	string	City code
address	string	Street address
invitecode	string	Referral invite code
p2pqr	string	URL to this user's P2P QR code image
type	string	"success" or "error"

---

props Object

Field	Type	Description
acc	string	The user's Fahipay wallet account number
walletType	string	"basic" or "premium"
wsize	number	Wallet size / transaction limit
two_factor_enabled	number	1 if TOTP 2FA is active
efaas_login_enabled	number	1 if eFaas login is enabled
IDverified	number	1 if identity is verified
allowedActions	string[]	Permitted operations: withdraw, payment, topup, transfer

props.acc is the wallet account number shown in the app and used as the primary account identifier.

---

props.accs — Linked Bank Accounts

Contains the user's bank accounts linked to Fahipay, organised by bank code. Used when topping up or withdrawing via linked banks.

Key	Bank
bml	Bank of Maldives
mib	Maldives Islamic Bank
cbm	Central Bank of Maldives
sbi	State Bank of India

Each bank entry is an object of named account numbers:

"bml": {
  "mvr": "7730000145458",
  "usd": "7730000199959",
  "mvr2": "7770000045775"
}

Store the raw JSON of props.accs — it is needed to determine the source account when initiating top-ups or withdrawals.

---

props.withdraw

Field	Description
fee	Withdrawal fee amount
unit	Fee unit — % = percentage, otherwise fixed
freelimit	Free withdrawal limit (0 = no free limit)

---

Error Response

{
  "title": "Error",
  "msg": "Unauthorized",
  "type": "error"
}

If the authID is invalid or expired, re-run the full login flow.

---

 

---

← OTP / 2FA     Next → Balance