Integration Guide

This guide walks you through the complete integration process with the IIMMPACT API. Follow these 5 steps to start processing transactions.

Integration Flow

1. Get Product Listing -> 2. Get Sub Products (if needed) -> 3. Check Network Status -> 4. Bill Presentment (if needed) -> 5. Make Payment

Quick Links

Step	Description	Link
1	Get available products and their codes	Product Listing
2	Get sub-products for JomPAY, Mobile Data, PTPTN	Sub Products
3	Check if the network/service is available	Network Status
4	Retrieve outstanding bill amounts (Beta)	Bill Presentment
5	Process the actual payment	Make Payment

Prerequisites

Before you begin integration:

1. Create an Account - Sign up for an IIMMPACT account
2. Get API Credentials - Obtain your username and password from the dashboard
3. Authenticate - Get your IdToken for API requests
4. Set up Callbacks - Configure your callback URL for transaction updates

Transaction Types

The IIMMPACT API supports various transaction types:

• Mobile Top-ups - Prepaid reload for all major telcos
• Bill Payments - Utility bills, insurance, loans via JomPAY
• Digital Vouchers - Gift cards, game credits, vouchers
• Data Plans - Mobile data packages
• Government Payments - PTPTN, SSPN contributions

Best Practices

Idempotency

Always use the same refid when retrying a failed transaction. This prevents duplicate charges.

Check Network Status

Before processing payments, always check the network status to ensure the service is available.

Support

Need help with integration?

• Error Codes Reference - Understand transaction status codes
• Postman Collection - Test API endpoints interactively
• AI Customer Support - Get assistance via AI-powered support