update docs

2026-06-13 21:30:12 +05:00
parent 281864347e
commit a8cd22cbe1
51 changed files with 1830 additions and 469 deletions
@@ -48,6 +48,8 @@ Body: `benefAccount=7700000000000`

 Use `bankNo=3` and `transferLocal` for the transfer.

+> **USD cross-bank accounts**: `getIPSAccount` only succeeds for **MVR** cross-bank accounts. A 13-digit `7…` account that is denominated in USD returns `success: false` here and cannot be resolved via IPS at all. The client hardcodes `currency = "MVR"` for IPS results (`MibTransferClient.kt:135-137`). For USD BML→MIB transfers the user must first save a BML contact (see Notes below).
+
 ---

 ### 1b. MIB Internal Account (17 digits, starts with `9`)
@@ -62,11 +64,13 @@ Body: `accountNo=90100000000000000`
 ```json
 {
  "success": true,
-  "accountName": "ACCOUNT HOLDER NAME"
+  "accountName": "ACCOUNT HOLDER NAME",
+  "currencyCode": "462"
 }
 ```

- `accountName` may be at root level or inside a `data` object — check both
+- `accountName` may be at root level or inside a `data` object — check both (`MibTransferClient.kt:160-161`)
+- `currencyCode` may also be at root level or inside `data` (`MibTransferClient.kt:162-163`). `"462"` = MVR, `"840"` = USD. The client maps this into `MibIpsAccountInfo.currency` ∈ `{"MVR", "USD", ""}` — this is the **MIB→MIB USD detection** fix from commit `16fd909`.
 - Bank is always MIB (`MADVMVMV`)

 Use `bankNo=2` and `transferInternal` for the transfer.
@@ -201,6 +205,26 @@ POST https://faisamobilex-wv.mib.com.mv/ajaxTransfer/transferLocal

 ---

+## `MibIpsAccountInfo` (client model)
+
+All three lookups return this unified structure (`MibModels.kt:42-47`):
+
+| Field | Description |
+|---|---|
+| `accountName` | Account holder name (trimmed) |
+| `accountNumber` | Resolved account number |
+| `bankId` | Bank BIC (`MADVMVMV` = MIB, `MALBMVMV` = BML, etc.) |
+| `currency` | `"MVR"`, `"USD"`, or `""` (unknown). Populated from `currencyCode` for MIB internal lookups; hardcoded `"MVR"` for IPS lookups; default `""` for alias lookups. |
+
+---
+
+## Notes
+
+- **BML → MIB USD transfers** require a saved BML contact first. Because `getIPSAccount` rejects USD accounts (`success: false`), the app cannot validate the BML USD account number directly. The workaround in `TransferFragment.kt` is to call `MibContactsClient.createContact` (see [09-contacts.md](09-contacts.md)) to auto-add the BML account as a beneficiary, then transfer to that beneficiary. Introduced in commit `16fd909`.
+- **Session expiry**: HTTP `419` on either lookup or transfer means the session expired. See [README](README.md) for the unified expiry detection rules.
+
+---
+
 &nbsp;

 ---