add support to detect dhiraagu and ooredoo packages

2026-05-17 00:25:48 +05:00
parent 93405aade2
commit ccc9e11d55
9 changed files with 781 additions and 3 deletions
@@ -0,0 +1,100 @@
+# Dhiraagu API Documentation
+
+Reverse-engineered from traffic captures of the Dhiraagu Easy Pay web service (`dhiraagu.com.mv`).
+
+---
+
+## Overview
+
+Dhiraagu exposes a number-lookup API used by their Easy Pay web page to validate mobile numbers before payment. The API uses a two-step flow:
+
+1. **Nonce extraction** — fetch the Easy Pay HTML page and extract a one-time nonce token embedded in the page JavaScript.
+2. **Number lookup** — POST the mobile number with the nonce to the IO API endpoint, which returns the account type and owner name.
+
+The nonce is single-use and page-session-specific; it must be re-fetched for each lookup.
+
+---
+
+## Base URL
+
+```
+https://www.dhiraagu.com.mv
+```
+
+---
+
+## Authentication Model
+
+| Value | How obtained | How used |
+|---|---|---|
+| `nonce` | Extracted from Easy Pay page HTML | Sent as `nonce` request header on the lookup POST |
+
+No persistent session or login is required. The nonce is valid for a single lookup request.
+
+---
+
+## Common Request Headers
+
+```
+User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:150.0) Gecko/20100101 Firefox/150.0
+Origin: https://dhiraagu.com.mv
+```
+
+The `User-Agent` header is required; requests without it are rejected by the server.
+
+---
+
+## Number Lookup Flow
+
+```
+Client                                      Server
+  |                                           |
+  |  GET /services/easy-pay                   |  ← fetch page to get nonce
+  |----------------------------------------->|
+  |  200 OK (HTML page)                       |
+  |  var nonce = "feb6acb9-a532-428e-..."     |
+  |<-----------------------------------------|
+  |                                           |
+  |  POST /api/sdk-dhr-webapi.ashx            |
+  |  ?website_id=CA2BB809...                  |
+  |  &sub=dhiraaguIO&act=infoUnlisted         |
+  |  nonce: feb6acb9-a532-428e-...            |
+  |  { "number": "7654321" }                  |
+  |----------------------------------------->|
+  |  { respStatus: "OK",                      |
+  |    serviceDetails: [{prepaidIndicator}],  |
+  |    accountOwnerInfo: { name } }           |
+  |<-----------------------------------------|
+```
+
+---
+
+## Result Interpretation
+
+| `prepaidIndicator` | Meaning |
+|---|---|
+| `"Y"` | Prepaid — use **Dhiraagu Reload** |
+| `"N"` | Postpaid — use **Dhiraagu Bill Pay** |
+| absent / other | Number not found or unsupported |
+
+---
+
+## Applicable Numbers
+
+Only Dhiraagu mobile numbers are returned by this API. Dhiraagu numbers in the Maldives start with **7** (7-digit local format, e.g. `7654321`).
+
+---
+
+## Documents
+
+| # | File | Description |
+|---|---|---|
+| 1 | [Number Lookup](01-number-lookup.md) | Validate a Dhiraagu number and determine account type |
+
+---
+
+&nbsp;
+
+---
+
+> **Next →** [Number Lookup](01-number-lookup.md)