Appearance
Integration Guide
This guide walks you through the complete integration process with the IIMMPACT API. Follow these 7 steps to start processing transactions.
Starting a New Integration?
We recommend the Dynamic Product Catalog for new integrations. It provides structured product fields, built-in validation, fulfillment mapping, and real-time updates via webhooks.
The step-by-step guide below uses the legacy Product Listing API, which is maintained for existing integrations. See the Migration Guide if you are migrating from legacy to the new catalog.
Integration Flow
| 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 |
| 6 | Verify final transaction status | Make Payment |
| 7 | Reconcile transactions | Reconciliation |
Prerequisites
Before you begin integration:
- Create an account — Sign up on staging for testing or request production access.
- Get API credentials — Generate your API key and HMAC secret from Developer > API Keys in the Dashboard.
- Authenticate — Set up API Key authentication for API requests.
- Set up callbacks — Configure your callback URL for transaction updates.
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.
Complete Example
See a complete end-to-end walkthrough showing every API call for a Digi Prepaid reload, from authentication to reconciliation.
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