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 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.