Wallet API
Wallet information for personal accounts: balances, limits, usage, and transaction history.
Explore wallet endpoints
| Endpoint | Use it to | Availability |
|---|---|---|
GET /balance | Check ledger, available, and hold balances. | Available |
GET /usage | Check tier, limits, usage, remaining allowance, and reset times. | Available |
GET /transactions | Browse successful and failed transactions with cursor pagination. | Available |
Who can use it?
Use the Wallet API with your personal FahiPay account to view your wallet balance, browse transaction history, and check how much of your daily, weekly, and monthly allowance remains.
Authentication
Get your API key from FahiPay Developers. Send it in the X-API-Key header without a prefix.
Keep the key on your server. In the API explorer, choose Authorize and enter your API key.
Base URL
https://api.fahipay.mv/walletMoney and responses
Wallet balances, transaction amounts, limits, usage, and remaining amounts are in MVR. For example, 359.49 means MVR 359.49. Merchant payment amounts use integer laari.
GET /balance returns success and a data array of account balance records. GET /usage returns success and a data object. GET /transactions returns success, a data array, and pagination. Use each endpoint's documented response shape.
Limits vary by account. Read the current values and reset_at timestamps from the usage response.