Skip to content

Step 2: Sub Products

Some products require an additional sub-product selection before you can process a payment. Call the Sub Products API with the relevant product code to retrieve the available options.

JomPAY billers

For JomPAY biller selection, use the dedicated JomPAY Billers API instead of the Sub Products API.

API Reference

For the full endpoint specification (headers, parameters, response schema, and examples), see Sub Products API Reference.

The following product types require sub-product selection:

Product TypeWhat You RetrieveReference
Mobile DataData plans (per phone number)Sub Products — Mobile Data
PTPTN / SSPNAccount typesSub Products — PTPTN / SSPN

Mobile Data Plans

This applies when the product code is one of the mobile data / internet codes listed below.

Data plans are personalized per phone number based on the user's eligibility. The available plans can differ substantially across users, so only display the plans returned by the API for that specific number. This minimizes failed transactions and provides a better user experience.

Mobile data plan selection showing personalized plans from API

Applicable Product Codes

Product CodeProduct Name
CELCelcom Internet
DIDigi Internet
HIHotlink Internet
UMIUmobile Internet
TITunetalk Internet
OXIOnexox Internet
YESIYes Internet

PTPTN / SSPN

This applies when the product code is PTPTN.

PTPTN offers four sub-product types:

Product NameCategorySub Product Code
KonvensionalPTPTNK
UjrahPTPTNU
SSPN PrimeSSPN PrimeS
SSPN PlusSSPN PrimeSP

How to Display and Use the Data

  1. Check the description field for each item in the API response to determine its category.
  2. Group items under their category. A user may have multiple accounts associated with their NRIC number.
  3. Retrieve the account_number from the API response for the selected account.
  4. Pass to payment — Use the retrieved account_number in Step 5: Make Payment.

PTPTN account selection showing PTPTN and SSPN Prime categories

IIMMPACT API Documentation