Appearance
Bill Presentment SDK
Coming Soon
This feature is under active development and not yet available. The API endpoints, SDK packages, and behavior described here are subject to change before release.
The Bill Presentment SDK is an embeddable component that lets client applications (banks, e-wallets) show Malaysian users their outstanding bills and select which to pay. The SDK handles bill discovery and selection; the client handles payment through their own rails.
How It Works
- Your backend creates a session via
POST /v2/sdk/sessions - Your frontend opens the SDK with the returned
session_token - SDK shows bills in an iframe/WebView, user selects which to pay
- SDK returns the selection to your app via
postMessage - Your app handles payment through its own rails
The SDK is a thin wrapper around a hosted web app (bills.iimmpact.com) that runs inside an iframe or WebView. All bill data is fetched from the IIMMPACT API using a single short-lived session token.
Architecture
Supported Platforms
| Platform | Package | Display Mode |
|---|---|---|
| Web (browsers) | @iimmpact/billpresentment-sdk | Modal, fullscreen, or inline iframe |
| React Native | @iimmpact/billpresentment-sdk-react-native | Fullscreen or modal WebView |
What the SDK Does
- Creates a scoped bill-selection session from your backend using existing B2B API Key + HMAC auth
- Displays the user's registered bill accounts and loads outstanding amounts progressively
- Shows retry actions for bills whose outstanding lookup fails
- Returns selected bills with full metadata (
billerCode,billerName,billerCategory,jompayBillerCode,jompayRef2) and total amount
What the SDK Does NOT Do
- Payment processing -- the client app handles payment through its own rails
- User registration -- bill accounts are pre-registered via IIMMPACT
- Separate SDK credential management -- no
client_id/client_secret, no secret rotation flow - Custom origin allowlists -- CORS is open; security relies on session scoping + token validation
Next Steps
- Quickstart -- Get up and running in 10 minutes
- Authentication -- Understand API Key + HMAC session auth and session token behavior
- Web SDK -- Browser integration guide
- React Native SDK -- Mobile integration guide