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

# Node.js SDK - 2.7.0

November 4, 2026

## Added

### Hosted KYC/KYB: Parameter to preset the session language

The `IdentityVerification` model and its typings now expose an optional `SessionLanguage` field, the initial language of a hosted identity verification session created via [POST Create an IDV Session](/api-reference/idv-sessions/create-idv-session). The value isn't returned in the API response, but adds an `lng` query parameter to `HostedUrl`.

If not set, the session takes the language of the user's browser (if supported), or otherwise English. The user can also change the language from within the session. Read more about hosted KYC/KYB [session language](/guides/users/verification/hosted#session-language) **→**

---

## Added

### List PSCs of a legal user

New `Users.getPscs(userId, callback, options)` method, calling the [GET List PSC Sessions for a User](/api-reference/idv-sessions/list-psc-sessions-user) endpoint, returning the list of PSCs (persons with significant control) of a legal user. `Psc` now also exposes `MainSessionId`.

For more details, see the [API release note](/release-notes/api/2026-11-04) **→**

---

## Added

### `FlowDescriptor` exposed on the base `PayIn` model

The base `PayIn` model (`PayIn.js`) now also exposes the `FlowDescriptor` field, matching the typings already introduced in [2.1.0](/release-notes/sdk/nodejs/2-1-0).

---

## Added

### Marketplace data for Visa Marketplace reporting

New `MarketplaceData` model and typings (`ForeignRetailerIndicator`, `ForeignRetailerAmount`) carry the declarative information used for Visa Marketplace reporting. The optional `MarketplaceData` field is now exposed on:

* The card, Apple Pay, and Google Pay pay-in models: `PayInPaymentDetailsCard`, `PayInPaymentDetailsApplePay`, `PayInPaymentDetailsGooglePay`
* The preauthorization model: `CardPreAuthorization`
* The deposit model: `Deposit`
* The extended preauthorization model: `ExtendedPreauthorization`
* The recurring pay-in models: `PayInRecurringRegistration`, `RecurringPayInCIT`, `RecurringPayInMIT`

For more details, see the [API release note](/release-notes/api/2026-11-03) **→**

---

## Changed

### Sandbox credentials for the test suite are now required environment variables

If you clone the SDK repository to run its test suite, you now need to set Sandbox credentials as environment variables:

* `MANGOPAY_CLIENT_ID` – Your Sandbox `ClientId`
* `MANGOPAY_CLIENT_PASSWORD` – Your Sandbox API key

There is a second set of variables for the token-isolation test. The suite fails with a clear error if any required variable is missing.

---

## Changed

### Bumped Axios version

* Upgraded `axios` to `1.21.0`