Changelog

All notable changes to the Pine Labs 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-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 or later; 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 Pine Labs 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 Pine Labs 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.