forked from shihaam/thijooree
86 lines
2.1 KiB
Markdown
86 lines
2.1 KiB
Markdown
# Ooredoo API Documentation
|
|
|
|
Reverse-engineered from traffic captures of the Ooredoo Quick Pay web service (`ooredoo.mv`).
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
Ooredoo exposes a number-validation API used by their Quick Pay service to check mobile numbers before payment. It is a single unauthenticated GET request that returns the customer type for a given MSISDN.
|
|
|
|
The response determines which payment service to offer:
|
|
|
|
- **PRE** (prepaid) → Raastas top-up only
|
|
- **POST** (postpaid) → Ooredoo Bill Pay only
|
|
- **HYBRID** → both Raastas and Ooredoo Bill Pay (user must choose)
|
|
- No match → number is not an Ooredoo number
|
|
|
|
---
|
|
|
|
## Base URL
|
|
|
|
```
|
|
https://www.ooredoo.mv
|
|
```
|
|
|
|
---
|
|
|
|
## Authentication Model
|
|
|
|
No authentication required. The endpoint is publicly accessible.
|
|
|
|
---
|
|
|
|
## Common Request Headers
|
|
|
|
No special headers are required. Standard HTTP/HTTPS headers apply.
|
|
|
|
---
|
|
|
|
## Number Lookup Flow
|
|
|
|
```
|
|
Client Server
|
|
| |
|
|
| GET /ooredoo-prod/QuickPayPackage/v1/ |
|
|
| numberTypeValidation |
|
|
| ?action=cust_details |
|
|
| &msisdn=9607654321 |
|
|
|------------------------------------------->|
|
|
| { custType: "PRE" } |
|
|
|<-------------------------------------------|
|
|
```
|
|
|
|
---
|
|
|
|
## Result Interpretation
|
|
|
|
| `custType` | Meaning |
|
|
|---|---|
|
|
| `"PRE"` | Prepaid — offer **Raastas** top-up |
|
|
| `"POST"` | Postpaid — offer **Ooredoo Bill Pay** |
|
|
| `"HYBRID"` | Both prepaid and postpaid — offer both (user selects) |
|
|
| `null` / absent | Not an Ooredoo number |
|
|
|
|
---
|
|
|
|
## Applicable Numbers
|
|
|
|
Only Ooredoo mobile numbers are returned by this API. Ooredoo numbers in the Maldives start with **9** (7-digit local format, e.g. `9654321`). The API expects the full MSISDN including country code `960`.
|
|
|
|
---
|
|
|
|
## Documents
|
|
|
|
| # | File | Description |
|
|
|---|---|---|
|
|
| 1 | [Number Validation](01-number-validation.md) | Validate an Ooredoo number and determine account type |
|
|
|
|
---
|
|
|
|
|
|
|
|
---
|
|
|
|
> **Next →** [Number Validation](01-number-validation.md)
|