Roaming

Authorization

Authorization API calls All API call request to ideabiz.lk required Authorization headers. Please refer (http://docs.ideabiz.lk/Getting_Started/Token_Manegment) for Authorization

Query Roaming rates.

API will returns the current roaming rates from the submitted Local Location to Destination Location.

Method

GET

URL

https://ideabiz.lk/apicall/roaminginfor/v0.1/<MCC>/<MNC>/<MSISDN>/<Home Location ID>/<Local Location ID>/<Destination Location ID>

Parameter Description

Note

• If the Destination Location ID is set to null
  The API will return the Roaming rates for transactions from Local Location to Home Location.
• If the Destination Location ID is set accordingly
  The API will return the Roaming rates for transactions from Local Location to Destination Location.
• If the Home Location is same as the Local location
  The API will return the domestic rates of the home location.

Response body

{
  "VISITED COUNTRY": "China",
  "VISITED OPERATOR": "All",
  "CALLED COUNTRY": {
    "DEFAULT": {
      "WITHOUTTAX": {
        "MOIDD": "250",
        "UCB": "51"
      },
      "WITHTAX": {
        "MOIDD": "250",
        "UCB": "51"
      }
    },
    "OCOR": {
      "WITHOUTTAX": {
        "MOIDD": "250",
        "UCB": "51"
      },
      "WITHTAX": {
        "MOIDD": "250",
        "UCB": "51"
      }
    }
  }
}

Response Parameters

Query Roaming Usage

API will return the roaming usage details of the given time period of the submitted msisdn. Return data will categorize as Voice / SMS/ Data and the Total usage in rupees and Usage count will be displayed for each category. Response will be in json format.

Method

POST

URL

https://ideabiz.lk/apicall/roaminginfor/v0.1/<MCC>/<MNC>/<MSISDN>

POST Body parameters

{
    "startdate":"20151023",
    "enddate":"20151123"
}

Parameter Description

Response Body Format

[
  "777123456",
  {
    "data": "3.5624",
    "voice": "6536.774",
    "sms": "344.385"
  }
]

Query Account Information

API will return the below information relates to the submitted msisdn. For both account information and the Roaming product information can be queried via above API. . Response will be in json format (key->value).

Method

GET

URL

https://ideabiz.lk/apicall/roamingservice/v0.1/<MCC>/<MNC>/<msisdn>

Parameter Description

Response body format

{
  "paidMode": "POS",
  "creditbalance": 0,
  "unbilledValue": 12675.9002,
  "accountvalidity": "0",
  "mainpackage": "STAFF-STAFF PACKAGE",
  "raompackage": [
    "I_AIRA_AIR",
    "I_OCOR",
    "I_ROAM_ALERT"
  ],
  "allroamingpkg": [
    "I_AIR_NO_DEP",
    "I_DF_CORP_BB_UN",
    "I_DF_BB_DAILY",
    "I_OCOR",
    "I_DF_SMRT_RM_D",
    "I_DF_SMRT_RM_M",
    "I_ROAM_ALERT"
  ]
}

Response Parameters

Roaming service Activation

Above API will activate the submitter Roaming service product ID to the submitted msisdn.

Method

POST

URL

https://ideabiz.lk/apicall/roamingservice/v0.1/<MCC>/<MNC>/<msisdn>/< PackageID >/< Operation>

Parameter Description

Response Body Format

{
  "status": "200",
  "desc": "successful"
}

Response Codes

Following standard response codes will be used in the REST response header.