> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# NodeJS SDK - 2.0.0

Jun 2, 2026

> **Warning**
>
> **Caution – Major version change with breaking changes**
>
> This SDK major version increase raises the minimum required Node.js version and bumps several dependencies. The API runtime of the SDK is unchanged — no method signatures, models, or TypeScript typings were modified — but review the notes below and test your integration before upgrading in Production.

## Breaking change

### Minimum Node.js version raised to 22

* `engines.node` is now `>=22.0.0` (previously `>= v0.10.0`).
* Installing the SDK on Node \< 22 will produce an `EBADENGINE` warning and is no longer supported. Upgrade your runtime before installing SDK version `2.0.0`.
* `@types/node` is now pinned to `22.19.18`. Projects on older `@types/node` may see type drift in transitive types and should align their version.

If your project is on Node 16/18/20, upgrade to Node 22 (or newer) before installing SDK version `2.0.0`. The `1.x` line remains available on npm for environments that cannot upgrade their runtime yet.

No application code changes are required for SDK callers — all service methods, models, and TypeScript typings are unchanged from `1.68.0`.

### Dependency upgrades

Runtime and dev dependencies have been bumped to current versions to clear transitive vulnerabilities and align with the new Node 22 baseline:

Runtime:

* `axios`: `1.12.0` → `1.16.0`
* `form-data`: `4.0.4` → `4.0.5`
* `promise`: `8.1.x` → `8.3.0`
* `underscore`: `1.12.x` → `1.13.8`
* `@types/node`: `14.14.x` → `22.19.18`

Dev:

* `mocha`: `9.2.0` → `11.7.5`
* `chai`: `4.2.x` → `4.5.0`
* `sinon`: `9.2.x` → `21.0.1`
* `typescript`: `4.1.x` → `6.0.3`
* `ts-node`: `^9.1.1` → `10.9.2`
* `tsd` `^0.30.4` → `0.33.0`

Projects that depend on the older transitive versions (for example, code relying on Axios `1.12` request/response shapes) should re-test their integration against SDK version `2.0.0`.

## Fixed

### Garbled comment in `CardPreAuthorization`

* Replaced non-UTF-8 characters in the `IpAddress` JSDoc comment of `lib/models/CardPreAuthorization.js`. No behavior change.