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.

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 Type	What You Retrieve	Reference
JomPAY	Biller list	Sub Products — JomPAY
Mobile Data	Data plans (per phone number)	Sub Products — Mobile Data
PTPTN / SSPN	Account types	Sub Products — PTPTN / SSPN

JomPAY Billers

API Reference

See Sub Products API Reference — JomPAY.

This applies when the product code is JOMPAY.

Your application should allow users to provide the JomPAY Biller Code in one of two ways:

1. Manual input — Users type the Biller Code directly into a designated field.
2. Searchable dropdown — Users search for and select the Biller Code from a list retrieved via the Sub Products API.

The Biller Code is a mandatory parameter when making a JomPAY payment in Step 5: Make Payment.

Mobile Data Plans

API Reference

See Sub Products API Reference — Mobile Data.

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.

Applicable Product Codes

Product Code	Product Name
CEL	Celcom Internet
DI	Digi Internet
HI	Hotlink Internet
UMI	Umobile Internet
TI	Tunetalk Internet
OXI	Onexox Internet
YESI	Yes Internet

PTPTN / SSPN

API Reference

See Sub Products API Reference — PTPTN / SSPN.

This applies when the product code is PTPTN.

PTPTN offers four sub-product types:

Product Name	Category	Sub Product Code
Konvensional	PTPTN	K
Ujrah	PTPTN	U
SSPN Prime	SSPN Prime	S
SSPN Plus	SSPN Prime	SP

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.