NodeJS SDK

​

1.67.0 - Mar 23, 2026

​

Added

​

Support for mTLS authentication

• Added cert, key, ca, certFilePath, keyFilePath, caFilePath to config.js
• Added _buildHttpsAgent() method to api.js which returns a HttpAgent that may contain the certificate configuration
• Update the TS typings to reflect the new properties
• Updated the requests logic to add the mTLS certificate if present
• Updated README.md file with details on how to configure mTLS for the SDK

​

1.66.1 - Feb 23, 2026

​

Added

​

ChargeBearer body parameter on payouts

• Added ChargeBearer param (String) to PayOutData and CreatePayOut interfaces
• Updated tests

​

Added

​

AuthenticationType response property on card pay-ins

• Added the AuthenticationResult interface
• Added AuthenticationResult param (Object containing AuthenticationType) to CardPreauthorizationData, CardValidationData, DepositData, CardWebPayInData, CardDirectPayInData, RecurringPayInData, ApplePayPayInData, GooglePayDirectPayInData interfaces
• Updated tests

​

Added

​

TelephoneOrder body parameter on recurring card pay-ins (CIT and MIT)

• Added PaymentCategory (String) to RecurringPayInData, CreateRecurringPayInCIT, CreateRecurringPayInMIT interfaces
• Updated tests

​

1.66.0 - Feb 12, 2026

​

FX

​

Breaking change

​

Custom fees

• Added Fees to CreateQuote
• Added Fees, RequestedFees to QuoteData
• Added RequestedFees to ConversionData

​

Added

​

User margin

• Added UserMargin to CreateInstantConversion and CreateQuote
• Added MarginsResponse to ConversionData and QuoteData

​

Echo

​

Breaking change

​

Settlement upload endpoints

• Updated settlement_sample.csv and tests
• Added FileName and UploadUrl to SettlementData
• Added GenerateSettlementUploadUrl interface

 api.Settlements.generateUploadUrl({FileName: "settlement_sample.csv"})

  api.Settlements.generateNewUploadUrl(settlement.SettlementId, {FileName: "settlement_sample_updated.csv"})

​

Added

​

GET validations for a Settlement endpoint

• Added SettlementValidation, SettlementValidationFooter, SettlementValidationLine interfaces
• Added getValidations method to Settlements

 api.Settlements.getValidations(settlement.SettlementId)

​

PUT Cancel a Settlement endpoint

• Added cancel method to Settlements

api.Settlements.cancel(settlement.SettlementId)

​

Intent unfunded amounts and source wallet

• Added SplitOriginWalletId to PayInIntentLineItem, PayInIntentSplitData, CreatePayIntentSplit
• Added UnfundedSellerAmount to PayInIntentLineItem
• Added UnfundedAmount to PayInIntentData, CreatePayInIntentAuthorization

​

POST Create an Intent Refund

• Added Refund and Capture to PayInIntentData
• Added createPayInIntentRefund method to Payins

 api.PayIns.createPayInIntentRefund(intent.Id, refundDto)

​

POST Reverse an Intent Refund

• Added reversePayInIntentRefund method to Payins

api.PayIns.reversePayInIntentRefund(intent.Id, intent.Refund.Id, reverseDto)

​

POST Create an Intent Dispute

• Added Dispute to PayInIntent
• Added createPayInIntentDispute method to PayInApi

api.PayIns.createPayInIntentDispute(intent.Id, intent.Capture.Id, disputeDto)

​

PUT Update an Intent Dispute

• Added Decision to PayInIntent
• Added UpdatePayInIntentDisputeOutcome interface
• Added updatePayInIntentDisputeOutcome method to PayIns

api.PayIns.updatePayInIntentDisputeOutcome(intent.Id, intent.Capture.Id, intent.Dispute.Id, dto)

​

1.65.0 - Jan 30, 2026

​

Added

​

Support for new SCA status endpoint

    /**
    * Get SCA status
    * @param {number}  userId  User identifier
    * @param {Function} callback    Callback function
    * @param {Object} options    Request options
    * @return {Object}        Request promise
    */
   getScaStatus: function(userId, callback, options) {
       options = this._api._getOptions(callback,
           options,
           {
               path: {
                   id: userId
               }
           });


       return this._api.method('users_get_sca_status', callback, options);
   }

module.exports = EntityBase.extend({
   defaults: {
       UserStatus: null,
       IsEnrolled: null,
       LastEnrollmentDate: null,
       LastConsentCollectionDate: null,
       ConsentScope: null
   }
});

    describe('Get Sca status', function() {
        const activeUserId = "user_m_01JKZW095BFB2TRQMCZ8GE7M8D";
        var scaStatus;

        before(function(done){
            api.Users.getScaStatus(activeUserId, function (data, response) {
                scaStatus = data;
                done();
            });
        });

        it('John should be the same', function(){
            expect(scaStatus).to.not.be.undefined;
            expect(scaStatus.IsEnrolled).to.be.true;
            expect(scaStatus.LastEnrollmentDate).to.not.be.undefined;
            expect(scaStatus.ConsentScope.ContactInformationUpdate).to.not.be.undefined;
        });
    });

interface ScaStatus {
       UserStatus: string;
       IsEnrolled: boolean;
       LastEnrollmentDate?: Timestamp;
       LastConsentCollectionDate?: Timestamp;
       ConsentScope?: ConsentScope;
   }


   interface ConsentScope {
       ContactInformationUpdate?: string;
       RecipientRegistration?: string;
       Transfer?: string;
       ViewAccountInformation?: string;
   }

   /**
    * Get SCA status
    * @param {string} userId User identifier
    * @param {Function} callback Callback function
    * @param {Object} options Request options
    * @return {Object} Request promise
    */
   getScaStatus: MethodOverload<string, user.ScaStatus>

​

RecipientId property on payouts

​

New event types

    type EventType =
        | "SCA_CONTACT_INFORMATION_UPDATE_CONSENT_GIVEN"
        | "SCA_CONTACT_INFORMATION_UPDATE_CONSENT_REVOKED"
        | "SCA_TRANSFER_CONSENT_GIVEN"
        | "SCA_TRANSFER_CONSENT_REVOKED"
        | "SCA_RECIPIENT_REGISTRATION_CONSENT_GIVEN"
        | "SCA_RECIPIENT_REGISTRATION_CONSENT_REVOKED"
        | "SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_GIVEN"
        | "SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_REVOKED"
        | "SCA_EMAIL_VERIFIED"
        | "SCA_PHONE_NUMBER_VERIFIED"

​

1.64.0 - Nov 26, 2025

​

Changed

• changed naming convention to mangopay4

​

1.62.2 - Nov 25, 2025

​

Added

• Support for ScaContext on POST Create a Recipient for platforms taking action by proxy with consent from the user (API release note)

​

1.62.1 - Oct 31, 2025

​

Fixed

• Upgraded form-data library version
• Upgraded axios library version

​

1.62.0 - Oct 27, 2025

​

Added

• New POST Manage proxy consent for a User endpoint to obtain and manage user consent via the hosted SCA experience (if proxy is activated). A proxy and user consent are now required to use the USER_NOT_PRESENT value for ScaContext (API release note)
• ScaContext request parameter newly added on all user POST and PUT endpoints, enabling the platform to request these actions with USER_NOT_PRESENT – provided the proxy is in place, activated, and the user has given consent (API release note)
• Support for the Licensor property on GET View a Client

​

Changed

• x-tenant-id deprecated as no longer necessary for UK platforms; the parameter is ignored by Mangopay

​

1.61.0 - Oct 1, 2025

​

Added

• Verification of Payee (VOP) API response fields (RecipientVerificationOfPayee and sub-properties) on the endpoints GET View a Recipient, POST Create a Recipient, POST Create a Payout (API release note)
• Support for the POST Cancel an Intent endpoint for Echo, Mangopay’s solution for platforms working with another third-party PSP for funds acquisition
• Support for POST Submit data for a PayPal PayIn endpoint

​

1.60.4 - Sep 26, 2025

​

Improved

• Method for building the OAuth token URL, fixing a potential issue introduced in 1.42.1

​

1.60.3 - Sep 23, 2025

​

Added

• Support for ProfilingAttemptReference on all payment methods for Mangopay’s Fraud Prevention solution
• Webhook event types for Echo, Mangopay’s solution for third-party PSP integrations: INTENT_AUTHORIZED,INTENT_CAPTURED,INTENT_REFUNDED,INTENT_REFUND_REVERSED,INTENT_DISPUTE_CREATED,INTENT_DISPUTE_DEFENDED,INTENT_DISPUTE_WON,INTENT_DISPUTE_LOST,INTENT_SETTLED_NOT_PAID,INTENT_PAID,SPLIT_CREATED,SPLIT_PENDING_FUNDS_RECEPTION,SPLIT_AVAILABLE,SPLIT_REJECTED,SPLIT_REVERSED
• Support for VirtualAccountPurpose on Banking Alias object

​

Improved

• Added missing OptionsHelper in TypeScript
• Add new library for unit tests

​

1.60.2 - Sep 2, 2025

​

Added

• XK to country ISO values

​

Fixed

• Typescript function definition
• Typings for BankingAliases.getAll
• Missing CreationDate with toJSON()
• Missing fields in CreateTransferRefund
• Missing getBlockStatus definition
• Tests

​

1.60.1 - Aug 14, 2025

​

Added

• Types for user getRegulatory function
• Support for POST Create a Quoted Conversion between Client Wallets and POST Create an Instant Conversion between Client Wallets
• Missing MarketRateDate param to FX conversionRate
• Support for POST Create a Bank Wire to the Repudiation Wallet
• Missing keys for legacy Wallets Report

​

1.60.0 - Aug 7, 2025

​

Added

• PUT Update an Intent Split
• POST Execute an Intent Split
• POST Reverse an Intent Split
• GET View an Intent Split

• ECHO_INTENT
• ECHO_INTENT_ACTION
• ECHO_SETTLEMENT
• ECHO_SPLIT

​

1.59.1 - Jul 28, 2025

​

Added

• Sku parameter on LineItem, for Klarna PayIns
• support for new endpoint View supported banks for Pay by Bank, to enable presentation of banks to user before Pay by Bank payment request

​

1.59.0 - Jul 18, 2025

​

Added

• POST Create an Intent
• GET View an Intent
• POST Create a Capture for an Intent
• POST Create a Settlement
• PUT Update a Settlement
• GET View a Settlement
• POST Create an Intent Split

​

1.58.0 - Jul 3, 2025

​

Added

• New endpoint POST Create a Bizum PayIn
• New webhook event types for SCA enrollment (API release note), note that these are triggered on enrollment not authentication:
  • SCA_ENROLLMENT_SUCCEEDED
  • SCA_ENROLLMENT_FAILED
  • SCA_ENROLLMENT_EXPIRED
• New webhook event types for UserCategory change (API release note):
  • USER_CATEGORY_UPDATED_TO_OWNER
  • USER_CATEGORY_UPDATED_TO_PAYER
  • USER_CATEGORY_UPDATED_TO_PLATFORM
• Support for PLATFORM value to UserCategory enum

​

1.57.1 - Jun 17, 2025

​

Added

• US and CA virtual accounts for local pay-in collection

​

1.57.0 - Jun 10, 2025

​

Added

• POST Create a Report
• GET View a Report
• GET List all Reports

• REPORT_GENERATED
• REPORT_FAILED

​

1.56.1 - Jun 6, 2025

​

Added

• Support for RecipientScope query parameter on GET List Recipients for a User
• POST Validate the format of User data

​

Fixed

• Status enum value on Identity Verification object changed from OUTDATED to OUT_OF_DATE