Skip to content

Product Listing

Deprecated

This endpoint is being replaced by the Catalog API, which provides a richer structure with hierarchical navigation, field configurations, fulfillment mapping, and wholesale pricing. We recommend migrating to the Catalog API for new integrations. See the Migration Guide for details.

Retrieve a real-time, structured list of all available products on the IIMMPACT platform, including their details, pricing, and status.

Use this API to dynamically populate your product listings instead of hardcoding them. Any changes on the platform — such as adding new billers, deactivating products, or changing denominations — are reflected instantly.

TIP

For a step-by-step integration walkthrough, see the Product Listing Guide.

API Endpoint

http
GET https://api.iimmpact.com/v2/product-list

Request Headers

HeaderDescriptionRequired
X-Api-KeyYour API keyYes
X-TimestampUnix timestamp in secondsYes
X-NonceUnique request identifierYes
X-SignatureHMAC-SHA256 signature (v1=...)Yes

See API Key Authentication for how to sign your requests.

Response 200

FieldTypeDescription
dataarrayArray of product objects
data[].statusstringActive or Inactive. Inactive products should not be displayed to users
data[].has_subproductbooleanWhether the product requires a Sub Products API call to retrieve further options
data[].product_codestringProduct code — used when initiating a payment via Make Payment
data[].product_namestringCustomer-facing product name
data[].product_remarksstringCustomer-facing information such as redemption instructions
data[].account_labelstringSuggested label for the user input field (e.g., "Mobile Number", "Account No."). null if no input is required
data[].keyboard_typestringRecommended virtual keyboard type (e.g., "Numeric", "Alphanumeric")
data[].denominationstringAvailable denominations for the product
data[].common_denominationsstringSuggested popular denominations, ideal for quick-select buttons
data[].denomination_data_typestringData type for the amount (e.g., "Integer", "Decimal")
data[].denomination_currencystringDenomination currency
data[].product_groupstringBroad classification for filtering (e.g., "Vouchers", "Bill Payment", "eWallet")
data[].categorystringSpecific sub-classification (e.g., "In Store Voucher", "Utilities")
data[].image_urlstringDirect URL to the product's logo or banner image
data[].account_typestringPossible values: account_number, phone_number, both, not_required
data[].is_refundablebooleanWhether the product is eligible for the Void Transaction API

Example Response:

json
{
  "data": [
    {
      "status": "Inactive",
      "has_subproduct": false,
      "product_code": "ABS",
      "product_name": "Alam Beauty & Wellness Spa",
      "product_remarks": "To redeem present your digital voucher to cashier",
      "account_label": null,
      "keyboard_type": null,
      "denomination": "50,100,150,200",
      "common_denominations": "50,100,150,200",
      "denomination_data_type": "Integer",
      "denomination_currency": "MYR",
      "product_group": "Vouchers",
      "category": "In Store Voucher",
      "image_url": "https://dashboard.iimmpact.com/img/ABS.png",
      "account_type": "not_required",
      "is_refundable": false
    }
  ]
}

IIMMPACT API Documentation