mangopay4-nodejs-sdk 1.67.0 → 2.0.0

package/CHANGELOG.md

@@ -1,3 +1,42 @@
+## [2.0.0] - 2026-05-27
+
+> **⚠️ Breaking release.** This version raises the minimum required Node.js version and bumps several dependencies. The runtime API of the SDK is unchanged — no method signatures, models, or TypeScript typings were modified — but please review the notes below before upgrading.
+
+### 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 `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.
+
+### Breaking change - 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 `2.0.0`.
+
+### Changed - Source repository no longer on GitHub
+- The source repository has been moved off 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.
+
+### Notes for upgraders
+- If your project is on Node 16/18/20, upgrade to Node 22 (or newer) before installing `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`.
+
+## [1.68.0] - 2026-03-25
+### Added - Acquiring pay-in service
+- New `Acquiring` service with `createPayIn` (Card, iDEAL, Apple Pay, Google Pay, PayPal), `createPayInRefund`, `createPayPalDataCollection`, and `createCardValidation` methods
+- TypeScript typings under the `acquiring` namespace (`typings/models/acquiring.d.ts`, `typings/services/Acquiring.d.ts`)
+
+### Breaking change - Payconiq removed
+- Payconiq was discontinued on 4 December 2025; all related code has been removed: `PayInPaymentDetailsPayconiq` model, `PAYCONIQ` enum value, `createPayconiqWeb`/`getPayconiqWeb` methods, and associated TypeScript typings
+
+### Added - Klarna `Discount` field
+- Optional `Discount` field added to `LineItemData` and `CreateLineItem` interfaces in `payIn.d.ts`
+
 ## [1.67.0] - 2026-03-19
 ### Added - mTLS certificates support
 - mTLS certificates are now configurable in the SDK via file paths or encoded strings

package/README.md

@@ -244,12 +244,6 @@ Sample usage of Mangopay SDK installed with npm in a Node.js project
 -------------------------------------------------
 Don't forget to check examples folder !
 
-Contributing
--------------------------------------------------
-    npm start                       // installs dependencies and global mocha for testing and jsdox for documentation
-    npm test                        // runs the mocha tests
-    npm run-script documentation    // update documentation using jsdox, make sure to have it installed globally
-
 Unit Tests
 -------------------------------------------------
 Mocha tests are placed under ``/test/`` folder. To run the tests, make sure you have all dependencies installed.

package/lib/apiMethods.js

@@ -50,8 +50,6 @@ module.exports = {
     "payins_recurring_registration_put": ["/${apiVersion}/${clientId}/recurringpayinregistrations/${id}", "PUT"],
     "payins_create_recurring_card_direct": ["/${apiVersion}/${clientId}/payins/recurring/card/direct", "POST"],
     "payins_create_recurring_paypal": ["/${apiVersion}/${clientId}/payins/payment-methods/paypal/recurring", "POST"],
-    "payins_payconiq-web_create": ["/${apiVersion}/${clientId}/payins/payconiq/web", "POST"],
-    "payins_payconiqv2-web_create": ["/${apiVersion}/${clientId}/payins/payment-methods/payconiq", "POST"],
     "payins_create_card_pre_authorized_deposit": ["/${apiVersion}/${clientId}/payins/deposit-preauthorized/direct/full-capture", "POST"],
     "payins_deposit_preauthorized_prior_to_complement": ["/${apiVersion}/${clientId}/payins/deposit-preauthorized/direct/capture-with-complement", "POST"],
     "payins_deposit_preauthorized_complement": ["/${apiVersion}/${clientId}/payins/deposit-preauthorized/direct/complement", "POST"],
@@ -272,5 +270,14 @@ module.exports = {
     "recipients_validate": ["/${apiVersion}/${clientId}/users/${userId}/recipients/validate", "POST"],
     "recipients_deactivate": ["/${apiVersion}/${clientId}/recipients/${recipientId}", "PUT"],
 
-    "pay_by_bank_get_supported_banks": ["/${apiVersion}/${clientId}/payment-methods/openbanking/metadata/supported-banks", "GET"]
+    "pay_by_bank_get_supported_banks": ["/${apiVersion}/${clientId}/payment-methods/openbanking/metadata/supported-banks", "GET"],
+
+    "acquiring_payins_card-direct_create": ["/${apiVersion}/${clientId}/acquiring/payins/card/direct/", "POST"],
+    "acquiring_payins_ideal-web_create": ["/${apiVersion}/${clientId}/acquiring/payins/payment-methods/ideal", "POST"],
+    "acquiring_payins_applepay-direct_create": ["/${apiVersion}/${clientId}/acquiring/payins/payment-methods/applepay", "POST"],
+    "acquiring_payins_googlepay-direct_create": ["/${apiVersion}/${clientId}/acquiring/payins/payment-methods/googlepay", "POST"],
+    "acquiring_payins_paypal-web_create": ["/${apiVersion}/${clientId}/acquiring/payins/payment-methods/paypal", "POST"],
+    "acquiring_payins_paypal_data_collection_create": ["/${apiVersion}/${clientId}/acquiring/payins/payment-methods/paypal/data-collection", "POST"],
+    "acquiring_payins_createrefunds": ["/${apiVersion}/${clientId}/acquiring/payins/${id}/refunds", "POST"],
+    "acquiring_card_validation_create": ["/${apiVersion}/${clientId}/acquiring/cards/${id}/validation", "POST"],
 };

package/lib/models/CardPreAuthorization.js

@@ -93,8 +93,8 @@ var CardPreAuthorization = Model.extend({
         MultiCapture: null,
 
         /**
-         *  Is not Mandatory for 3DSv1 (flag �Use 3DSV2 Scenario� OFF)
-         *  Is mandatory when the flag �Use 3DSV2 Scenario� is active for (FORCE/DEFAULT/FRICTIONLESS both 3)
+         *  Is not Mandatory for 3DSv1 (flag Use 3DSV2 Scenario OFF)
+         *  Is mandatory when the flag Use 3DSV2 Scenario is active for (FORCE/DEFAULT/FRICTIONLESS both 3)
          */
         IpAddress: null,
 

package/lib/models/PayInPaymentType.js

@@ -6,7 +6,6 @@ module.exports = {
     PayPal: 'PAYPAL',
     ApplePay: 'APPLEPAY',
     GooglePay: 'GOOGLE_PAY',
-    Payconiq: 'PAYCONIQ',
     Mbway: 'MBWAY',
     Bancontact: 'BCMC',
     Bizum: 'BIZUM',

package/lib/models/ReportFilterV2.js

@@ -4,7 +4,8 @@ var ReportFilterV2 = Model.extend({
     defaults: {
         Currency: null,
         UserId: null,
-        WalletId: null
+        WalletId: null,
+        SettlementId: null
     }
 });
 

package/lib/services/Acquiring.js

@@ -0,0 +1,152 @@
+const _ = require('underscore');
+
+const Service = require('../service');
+
+const PayIn = require('../models/PayIn');
+const PayInPaymentDetailsBankWire = require('../models/PayInPaymentDetailsBankWire');
+const PayInPaymentDetailsCard = require('../models/PayInPaymentDetailsCard');
+const PayInPaymentDetailsDirectDebitDirect = require('../models/PayInPaymentDetailsDirectDebitDirect');
+const PayInPaymentDetailsDirectDebitWeb = require('../models/PayInPaymentDetailsDirectDebitWeb');
+const PayInPaymentDetailsPreAuthorized = require('../models/PayInPaymentDetailsPreAuthorized');
+const PayInPaymentDetailsPayPal = require('../models/PayInPaymentDetailsPayPal');
+const PayInExecutionDetailsWeb = require('../models/PayInExecutionDetailsWeb');
+const PayInExecutionDetailsDirect = require('../models/PayInExecutionDetailsDirect');
+const PayInExecutionDetailsBankingAlias = require('../models/PayInExecutionDetailsBankingAlias');
+const PayInPaymentDetailsApplePay = require('../models/PayInPaymentDetailsApplePay');
+const PayInPaymentDetailsGooglePay = require('../models/PayInPaymentDetailsGooglePay');
+const PayInPaymentDetailsMbway = require('../models/PayInPaymentDetailsMbway');
+const PayInPaymentDetailsBancontact = require('../models/PayInPaymentDetailsBancontact');
+const PayInPaymentDetailsBizum = require('../models/PayInPaymentDetailsBizum');
+const Refund = require('../models/Refund');
+const PayInPaymentDetailsMultibanco = require("../models/PayInPaymentDetailsMultibanco");
+const PayInPaymentDetailsSatispay = require("../models/PayInPaymentDetailsSatispay");
+const PayInPaymentDetailsBlik = require("../models/PayInPaymentDetailsBlik");
+const PayInPaymentDetailsKlarna = require("../models/PayInPaymentDetailsKlarna");
+const PayInPaymentDetailsIdeal = require("../models/PayInPaymentDetailsIdeal");
+const PayInPaymentDetailsGiropay = require("../models/PayInPaymentDetailsGiropay");
+const PayInPaymentDetailsSwish = require("../models/PayInPaymentDetailsSwish");
+const PayInPaymentDetailsTwint = require("../models/PayInPaymentDetailsTwint");
+const PayInPaymentDetailsPayByBank = require("../models/PayInPaymentDetailsPayByBank");
+const CardValidation = require('../models/CardValidation');
+
+
+const Acquiring = Service.extend({
+    /**
+     * Create new pay-in
+     * @param {Object}  payIn     PayIn object
+     * @param {Function} callback Callback function
+     * @param {Object} options    Request options
+     * @return {Object}           Request promise
+     */
+    createPayIn: function (payIn, callback, options) {
+        options = this._api._getOptions(callback, options, {
+            data: payIn,
+            dataClass: PayIn
+        });
+
+        const paymentKey = this.getPaymentKey(payIn);
+        const executionKey = this.getExecutionKey(payIn);
+
+        return this._api.method('acquiring_payins_' + paymentKey + '-' + executionKey + '_create', callback, options);
+    },
+
+    /**
+     * Create refund for pay-in object
+     * @param {number}  payInId   PayIn identifier
+     * @param {Object}  refund    Refund data
+     * @param {Function} callback Callback function
+     * @param {Object} options    Request options
+     * @return {Object}           Request promise
+     */
+    createPayInRefund: function (payInId, refund, callback, options) {
+        options = this._api._getOptions(callback, options, {
+            path: {
+                id: payInId
+            },
+            dataClass: Refund,
+            data: refund
+        });
+
+        return this._api.method('acquiring_payins_createrefunds', callback, options);
+    },
+
+    /**
+     * Send key pre-transaction data such as order details, buyer information,
+     * and merchant context before initiating a PayPal payment
+     *
+     * @param dataCollection The data collection to be created
+     * @param callback       Callback function
+     * @param options        Request options
+     * @returns {Object}     Request promise
+     */
+    createPayPalDataCollection: function (dataCollection, callback, options) {
+        options = this._api._getOptions(callback, options, {
+            data: dataCollection
+        });
+
+        return this._api.method('acquiring_payins_paypal_data_collection_create', callback, options);
+    },
+
+    /**
+     * Create card validation
+     * @param cardId         The ID of the card
+     * @param cardValidation The create card validation dto
+     * @param callback       Callback function
+     * @param options        Request promise
+     * @returns {Object}
+     */
+    createCardValidation: function (cardId, cardValidation, callback, options) {
+        options = this._api._getOptions(callback, options, {
+            path: {
+                id: cardId
+            },
+            data: cardValidation,
+            dataClass: CardValidation
+        });
+
+        return this._api.method('acquiring_card_validation_create', callback, options);
+    },
+
+    getPaymentKey: function (payIn) {
+        if (payIn.PaymentType) {
+            return payIn.PaymentType.toLowerCase().replaceAll('_', '');
+        }
+
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsBankWire) return 'bankwire';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsCard) return 'card';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsDirectDebitDirect) return 'directdebit';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsDirectDebitWeb) return 'directdebit';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsPreAuthorized) return 'preauthorized';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsPayPal) return 'paypal';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsApplePay) return 'applepay';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsGooglePay) return 'googlepay';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsMbway) return 'mbway';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsBancontact) return 'bcmc';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsBizum) return 'bizum';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsMultibanco) return 'multibanco';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsSatispay) return 'satispay';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsBlik) return 'blik';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsKlarna) return 'klarna';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsIdeal) return 'ideal';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsGiropay) return 'giropay';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsSwish) return 'swish';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsTwint) return 'twint';
+        if (payIn.PaymentDetails instanceof PayInPaymentDetailsPayByBank) return 'paybybank';
+
+        throw new Error(`PaymentType ${payIn.PaymentType} not handled`);
+    },
+
+    getExecutionKey: function (payIn) {
+        if (payIn.ExecutionType) {
+            return payIn.ExecutionType.toLowerCase();
+        }
+
+        if (payIn.ExecutionDetails instanceof PayInExecutionDetailsWeb) return 'web';
+        if (payIn.ExecutionDetails instanceof PayInExecutionDetailsDirect) return 'direct';
+        if (payIn.ExecutionDetails instanceof PayInExecutionDetailsBankingAlias) return 'bankingalias';
+
+        throw new Error(`ExecutionType ${payIn.ExecutionType} not handled`);
+    }
+});
+
+module.exports = Acquiring;

package/lib/services/PayIns.js

@@ -24,7 +24,6 @@ var PayInPaymentDetailsBancontact = require('../models/PayInPaymentDetailsBancon
 var PayInPaymentDetailsBizum = require('../models/PayInPaymentDetailsBizum');
 var Refund = require('../models/Refund');
 var PayInRecurringRegistration = require('../models/PayInRecurringRegistration');
-var PayInPaymentDetailsPayconiq = require('../models/PayInPaymentDetailsPayconiq');
 const RecurringPayIn = require('../models/RecurringPayIn');
 const PayInPaymentDetailsMultibanco = require("../models/PayInPaymentDetailsMultibanco");
 const PayInPaymentDetailsSatispay = require("../models/PayInPaymentDetailsSatispay");
@@ -359,22 +358,6 @@ var PayIns = Service.extend({
         return this._api.method('payins_card-web_get_details', callback, options);
     },
 
-    /**
-     * Create new pay-in Payconiq Web, using the latest API url (/payment-methods/payconiq)
-     * @param {Object}  payIn    PayIn object
-     * @param {Function} callback    Callback function
-     * @param {Object} options    Request options
-     * @return {Object}         Request promise
-     */
-    createPayconiq: function(payIn, callback, options) {
-        options = this._api._getOptions(callback, options, {
-            data: payIn,
-            dataClass: PayIn
-        });
-
-        return this._api.method('payins_payconiqv2-web_create', callback, options);
-    },
-
     /**
      * Create a pay in intent authorization
      * @param {Object}  payInIntentAuthorization    PayInIntentAuthorization object
@@ -745,7 +728,6 @@ var PayIns = Service.extend({
         if (payIn.PaymentDetails instanceof PayInPaymentDetailsPayPal) return 'paypal';
         if (payIn.PaymentDetails instanceof PayInPaymentDetailsApplePay) return 'applepay';
         if (payIn.PaymentDetails instanceof PayInPaymentDetailsGooglePay) return 'googlepay';
-        if (payIn.PaymentDetails instanceof PayInPaymentDetailsPayconiq) return 'payconiq';
         if (payIn.PaymentDetails instanceof PayInPaymentDetailsMbway) return 'mbway';
         if (payIn.PaymentDetails instanceof PayInPaymentDetailsBancontact) return 'bcmc';
         if (payIn.PaymentDetails instanceof PayInPaymentDetailsBizum) return 'bizum';

package/lib/services/index.js

@@ -30,5 +30,6 @@ module.exports = {
     IdentityVerifications: require('./IdentityVerifications'),
     Recipients: require('./Recipients'),
     ReportsV2: require('./ReportsV2'),
-    Settlements: require('./Settlements')
+    Settlements: require('./Settlements'),
+    Acquiring: require('./Acquiring'),
 };

package/package.json

@@ -1,40 +1,32 @@
 {
   "name": "mangopay4-nodejs-sdk",
-  "version": "1.67.0",
+  "version": "2.0.0",
   "types": "./typings/index.d.ts",
   "description": "Mangopay Node.js SDK",
-  "repository": "https://github.com/Mangopay/mangopay2-nodejs-sdk.git",
   "license": "MIT",
-  "keywords": [
-    "mangopay",
-    "nodejs",
-    "sdk",
-    "credit cards",
-    "api"
-  ],
   "engines": {
-    "node": ">= v0.10.0"
+    "node": ">=22.0.0"
   },
   "main": "./index.js",
   "dependencies": {
-    "@types/node": "14.14.x",
-    "axios": "1.12.0",
-    "form-data": "4.0.4",
-    "promise": "8.1.x",
-    "underscore": "1.12.x"
+    "@types/node": "22.19.18",
+    "axios": "1.16.0",
+    "form-data": "4.0.5",
+    "promise": "8.3.0",
+    "underscore": "1.13.8"
   },
   "devDependencies": {
-    "chai": "4.2.x",
-    "mocha": "9.2.0",
-    "sinon": "9.2.x",
-    "tsd": "^0.30.4",
-    "ts-node": "^9.1.1",
-    "typescript": "4.1.x"
+    "c8": "11.0.0",
+    "chai": "4.5.0",
+    "mocha": "11.7.5",
+    "sinon": "21.0.1",
+    "ts-node": "10.9.2",
+    "tsd": "0.33.0",
+    "typescript": "6.0.3"
   },
   "scripts": {
-    "start": "npm install -g mocha && npm install -g jsdox && npm install",
-    "documentation": "jsdox -t docs/templates/ -i README -o docs lib/services",
     "test": "mocha 'test/**/*.js' --recursive --timeout 30000 --ui bdd",
+    "test:coverage": "c8 --reporter=lcov --reporter=text pnpm test",
     "test:types": "tsd"
   }
-}
+}

package/typings/enums.d.ts

@@ -10,7 +10,6 @@ export namespace enums {
         DirectDebit: "DIRECT_DEBIT";
         Preauthorized: "PREAUTHORIZED";
         PayPal: "PAYPAL";
-        Payconiq: "PAYCONIQ";
         Mbway: "MBWAY";
         Multibanco: "MULTIBANCO";
         Satispay: "SATISPAY";

package/typings/index.d.ts

@@ -46,6 +46,7 @@ import { cardPreAuthorization } from "./models/cardPreauthorization";
 import { entityBase } from "./models/entityBase";
 import { user } from "./models/user";
 import { payIn } from "./models/payIn";
+import { acquiring } from "./models/acquiring";
 import { refund } from "./models/refund";
 import { repudiation } from "./models/repudiation";
 import { client } from "./models/client";
@@ -76,6 +77,7 @@ import { identityVerification } from "./models/identityVerification";
 import { recipient } from "./models/recipient";
 import { Recipients } from "./services/Recipients";
 import { Settlements } from "./services/Settlements";
+import { Acquiring } from "./services/Acquiring";
 import { OptionsHelper } from "./services/OptionsHelper";
 
 export = MangoPay;
@@ -116,6 +118,7 @@ declare class MangoPay {
     IdentityVerifications: IdentityVerifications;
     Recipients: Recipients;
     Settlements: Settlements;
+    Acquiring: Acquiring;
     OptionsHelper: OptionsHelper;
 
     models: typeof MangoPay.models;
@@ -666,10 +669,6 @@ declare namespace MangoPay {
             constructor(data: any);
         }
 
-        class PayInPaymentDetailsPayconiq extends PayInPaymentDetails {
-            constructor(data: any);
-        }
-
         class PayInPaymentDetailsCardDirect extends PayInPaymentDetails {
             constructor(data: any);
         }
@@ -880,6 +879,7 @@ declare namespace MangoPay {
         conversion,
         virtualAccount,
         identityVerification,
-        recipient
+        recipient,
+        acquiring
     };
 }

package/typings/index.test-d.ts

@@ -812,21 +812,6 @@ api.PayIns.create({
     expectType<Mangopay.payIn.BankWireDirectPayInData>(data);
 });
 
-// create Payconiq PayIn
-api.PayIns.create({
-    PaymentType: "PAYCONIQ",
-    ExecutionType: "WEB",
-    Tag: "custom meta",
-    AuthorId: "user-id",
-    CreditedWalletId: "wallet-id",
-    DebitedFunds: {Amount: 500, Currency: "GBP"},
-    Fees: {Amount: 500, Currency: "GBP"},
-    ReturnURL: "http://www.my-site.com/returnURL",
-    Country: "BE"
-}).then(data => {
-    expectType<Mangopay.payIn.PayconiqWebPayInData>(data);
-});
-
 api.PayIns.create({
     PaymentType: "DIRECT_DEBIT",
     ExecutionType: "DIRECT",