Network Status

Check if a biller or product is experiencing service interruptions or intermittent downtime before initiating a payment.

TIP

For a step-by-step integration walkthrough, see the Network Status Guide.

API Endpoint

GET https://api.iimmpact.com/v2/networkstatus

Request Headers

Header	Description	Required
X-Api-Key	Your API key	Yes
X-Timestamp	Unix timestamp in seconds	Yes
X-Nonce	Unique request identifier	Yes
X-Signature	HMAC-SHA256 signature (v1=...)	Yes

See API Key Authentication for how to sign your requests.

Query Parameters

Parameter	Type	Required	Description
product	string	Yes	Product code to check (e.g., TNB). Use a code from the Product Listing API

Response 200

Field	Type	Description
data	object	Network status information
data.product_code	string	Product code
data.product_name	string	Product name
data.product_img	string	Product image URL
data.network_status	string	Status: Healthy or Interruption
metadata	object	Response metadata
metadata.status_code	number	HTTP status code
metadata.last_updated	string	Timestamp (GMT+8)

Example Response (Healthy):

{
  "data": {
    "product_code": "TNB",
    "product_name": "Tenaga Nasional Berhad",
    "product_img": "https://dashboard.iimmpact.com/img/TNB.png",
    "network_status": "Healthy"
  },
  "metadata": {
    "status_code": 200,
    "last_updated": "19-05-2025 14:49:03"
  }
}

Example Response (Interruption):

{
  "data": {
    "product_code": "TNB",
    "product_name": "Tenaga Nasional Berhad",
    "product_img": "https://dashboard.iimmpact.com/img/TNB.png",
    "network_status": "Interruption"
  },
  "metadata": {
    "status_code": 200,
    "last_updated": "19-05-2025 14:49:03"
  }
}

Status Values

Status	Meaning
Healthy	Service is operating normally
Interruption	Service is experiencing issues — transactions may be slow or fail

Staging test behavior

In the staging environment, product code FP always returns Interruption. Use this product code when testing interruption warning handling. This staging override does not apply in production.

WARNING

Users should still be able to proceed to checkout and pay even when the status is Interruption. Display a warning but do not block the payment flow.