Changelog

All notable changes to the IIMMPACT API are documented on this page. Entries are listed in reverse chronological order.

We use the following categories:

• New — New endpoints, features, or capabilities
• Changed — Changes to existing behavior or responses
• Deprecated — Endpoints or features scheduled for removal
• Removed — Endpoints or features that have been removed
• Fixed — Bug fixes affecting integrators

2026-10-09

Changed

• POST /v2/topup returns HTTP 400 with statusCode 49 ("Please try again") when the transaction could not be created because of a temporary system error. No transaction exists and the same refid can be resent. Status 47 is now only the final status of an existing transaction. See Rejected requests.

Fixed

• POST /v2/topup no longer returns a rejection (HTTP 400 without transaction_id) after a transaction was created. If a step after creation fails, the response is the transaction itself with its transaction_id, and a rejection (HTTP 400 without transaction_id) always means the request created no transaction.

New

• Model Context Protocol (MCP) — Added 4 read tools and 11 human-approved write tools for managing the dynamic product catalog: groups, categories, product visibility, names, ordering, price adjustments, amount ranges, individual options, and the catalog webhook. get_catalog can now include products that are turned off.

2026-10-08

Changed

• Catalog Webhooks — Every non-delete event now carries the complete state of the resource for your account, with null meaning "no value". Option events always use the PRODUCT:FIELD:CODE id and a single data object, and include denomination, price, cost, rrp matching /v2/options (min_amount and max_amount are currently null). Removing a customisation sends an updated event with the base view. Webhook URLs must be public https addresses; redirects are not followed.
• X-API-Version dates later than tomorrow (UTC) and malformed values are ignored and use the default contract. See Versioning.
• /v2/catalog and /v2/options no longer list or resolve products your account is restricted from purchasing. A static options field whose options are all disabled returns an empty list.
• Catalog SDK order webhooks now generate one order.timeout event when an order times out before payment is confirmed with IIMMPACT. See Catalog SDK Webhooks.

2026-09-23

Changed

• POST /v2/topup validates supplied plan codes for catalogue-listed products: the code must match an active option and its denomination must equal amount; a code is required when several plans share an amount. Failures return HTTP 400 with statusCode 44 and create no transaction. Not dependent on X-API-Version.

2026-09-16

Changed

• /v2/options pricing-select options include numeric denomination, and /v2/catalog fulfillment maps the payment amount from it and adds extras.subproduct_code. Available with X-API-Version: 2026-09-16; default for all requests from 2027-01-11.

2026-09-08

New

• Balance Webhooks — Receive signed balance.added events for eligible balance credits. See the event reference for payload and retry details, or automate setup and delivery replays with the configuration API.

2026-08-19

Changed

• Transaction Webhook IP Allowlist — Production callbacks use 18.140.170.98 and 13.215.6.214. Staging callbacks can originate from 3.1.120.89 or either production IP address.

2026-08-18

New

• Model Context Protocol (MCP) — Added stateless Streamable HTTP access for AI hosts, with 15 reseller-scoped read tools, 6 human-approved write tools, and the public @iimmpact-sdn-bhd/mcp HMAC-signing bridge. Start in staging before connecting production.

2026-07-22

Changed

• Payment Error Codes — Added status code 62 (Failed, NRIC not eligible) for JomPAY transactions that fail NRIC eligibility checks. This final status distinguishes these failures from invalid-account responses and should not be retried.

2026-06-09

New

• GET /v1/jompay/billers — Added a dedicated JomPAY biller list endpoint with biller_code and advisory suggested_category fields for biller selection. Suggested categories are maintained by IIMMPACT and are not official PayNet categories.

Changed

• Sub Products — JomPAY biller selection now points to the dedicated JomPAY Billers API. Sub Products documentation focuses on Mobile Data and PTPTN / SSPN sub-products.

2026-04-30

New

• Catalog SDK — Added React SDK documentation for embedding the hosted IIMMPACT catalog checkout with @iimmpact-sdn-bhd/catalog-sdk, backend bootstrap-token creation, callback handling, and production troubleshooting.

2026-04-22

Changed

• Bill Presentment SDK — Updated documentation for the published v0.2.1 SDK release, including official package names, simplified result payloads with JomPAY fields, Web SDK environment and origin options, and a new error handling guide.

2026-03-24

New

• Added this Changelog page to track API changes going forward.

Deprecated

• GET /v2/product-list — Use the Catalog API instead. See the Migration Guide for details. Removal timeline will be announced once the Catalog API reaches GA.
• GET /v2/subproducts — Use the Options API instead. See the Migration Guide for details. Removal timeline will be announced once the Catalog API reaches GA.

Preview

• Catalog API — Dynamic product catalog with hierarchical navigation, field configurations, and wholesale pricing. Currently in Preview; GA timeline to be announced.
• Bill Presentment SDK — Client-side SDK for bill presentment flows. Currently in Beta.