Getting startedRelease notesSDK

NodeJS SDK - 2.0.0

Jun 2, 2026

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 please review the notes below before upgrading and test your integration thoroughly.

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.

Changed

Source repository no longer on GitHub

  • The source repository has been moved from GitHub. The previous github.com/Mangopay/mangopay2-nodejs-sdk location is no longer maintained and will not receive new commits, issues, or pull requests.
  • The repository field has been removed from package.json.
  • This change does not affect consumption: npm install mangopay4-nodejs-sdk continues to work exactly as before.

Fixed

Garbled comment in CardPreAuthorization

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