This commit is contained in:
@@ -187,6 +187,76 @@ Fall back to `bookingDate` as-is.
|
||||
|
||||
---
|
||||
|
||||
## Pending History
|
||||
|
||||
Locked / pending amounts for a CASA account (e.g. unsettled card authorisations, holds). Returned as a flat list — no pagination.
|
||||
|
||||
### Endpoint
|
||||
|
||||
```
|
||||
GET https://www.bankofmaldives.com.mv/internetbanking/api/mobile/history/pending/{accountId}
|
||||
```
|
||||
|
||||
| Path parameter | Description |
|
||||
|---|---|
|
||||
| `accountId` | Internal account ID (`id` field from [dashboard](04-dashboard.md)) |
|
||||
|
||||
### Headers
|
||||
|
||||
| Header | Value |
|
||||
|---|---|
|
||||
| `Authorization` | `Bearer <access_token>` |
|
||||
| `User-Agent` | `bml-mobile-banking/348 ({manufacturer}; Android {version}; {model})` |
|
||||
| `x-app-version` | `2.1.44.348` |
|
||||
|
||||
```bash
|
||||
curl --request GET \
|
||||
--url 'https://www.bankofmaldives.com.mv/internetbanking/api/mobile/history/pending/abc123def456' \
|
||||
--header 'Authorization: Bearer <access_token>' \
|
||||
--header 'User-Agent: bml-mobile-banking/348 ({manufacturer}; Android {version}; {model})' \
|
||||
--header 'x-app-version: 2.1.44.348'
|
||||
```
|
||||
|
||||
### Response
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"payload": [
|
||||
{
|
||||
"LockedID": "L00012345",
|
||||
"FromDate": "2026-05-16",
|
||||
"LockedAmount": 75.00,
|
||||
"Description": "Card authorisation — Merchant Name"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Response Fields
|
||||
|
||||
| Field | Type | Description |
|
||||
|---|---|---|
|
||||
| `success` | `bool` | `true` on success |
|
||||
| `payload` | `array` | List of pending entries (top-level array, **not** under `payload.history`) |
|
||||
|
||||
### Pending Entry
|
||||
|
||||
| Field | Type | Description |
|
||||
|---|---|---|
|
||||
| `LockedID` | `string` | Unique ID for the pending entry |
|
||||
| `FromDate` | `string` | Date the hold was placed |
|
||||
| `LockedAmount` | `number` | Held amount — always a positive number on the wire; the client treats it as a **debit** by negating (`BmlHistoryClient.kt:184`) |
|
||||
| `Description` | `string` | Free-form description (counterparty/merchant) |
|
||||
|
||||
> **Amount sign:** the server returns `LockedAmount` as a positive number with no debit/credit indicator. All pending entries are debits (funds reserved out of the available balance), so the client negates the value before display.
|
||||
|
||||
> **Currency:** not returned by the server. The client assumes MVR.
|
||||
|
||||
Called from `AccountHistoryFragment.kt:263` to populate the pending tab of the account history view.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user