Skip to navigation
Getting startedRelease notesSDK

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

Added

New Users.getPscs(userId, callback, options) method, calling the GET List PSC Sessions for a 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 →

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.

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 →

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