Getting startedRelease notesAPICopy pageChangelog of new features and updates across all endpoints of the Mangopay API. 2026JuneJun 18, 2026Added SCT Inst for DE, ES, and LU Virtual Accounts MayMay 27, 2026Added Virtual Accounts for Australia (AU) and Liechtenstein (LI), accepting AUD and CHF PayPal preauthorization enabling a single capture within 3 days (recommended) May 19, 2026Changed Recipient validation errors now include regex pattern May 11, 2026Changed Email property per Hook for failed notification alerts Added SCA: Theme parameter to set dark or light mode on SCA redirection DateRangeBy property to generate reports based on transaction ExecutionDate Ability to list all Recipients regardless of scope VOP: Dedicated property for suggested name during Recipients check AprilApr 22, 2026Added Payouts error 121018 for Bank Account objects created after April 30, 2026 Apr 16, 2026Changed User date of birth limited to 120 years ago MarchMar 30, 2026Changed Virtual Accounts: DK local response changed from IBAN to local Added AMEX: Support for recurring, 30-day preauth, and 7-day multi-capture Klarna: Discount amount on line items Mar 23, 2026Added SCA: Mutual TLS (mTLS) authentication required for platforms using proxy Mar 11, 2026Added KYB document guidance for 15 countries across EMEA, APAC, and the Americas Mar 9, 2026Added Color customization in the SCA hosted experience FebruaryFeb 23, 2026Added Authentication type response parameter for card transactions Feb 19, 2026Changed Rules preventing Natural Users being used for non-personal accounts Feb 16, 2026Added Test value to bypass SCA in Sandbox on Users ChargeBearer parameter for cost-bearing on SWIFT payouts Feb 12, 2026Changed Echo: Endpoints for uploading settlement files Added Echo: Endpoints for managing Intent Refunds and disputes Feb 11, 2026Added User margin calculations on FX conversions Changed FX fees based on percentage or fixed amount Feb 3, 2026Added ActionCode 008715 for blocked users requiring KYC/KYB verification JanuaryJan 27, 2026Added RecipientId property added to payouts TelephoneOrder property added to recurring card pay-ins Jan 15, 2026Added SCA: Endpoint to retrieve SCA status of a User: enrollment and consent to proxy action scopes Jan 8, 2026Added SCA: Webhooks for proxy action scope consent changes SCA: Webhooks for email and phone number verification 2025DecemberDec 18, 2025Added KYB document guidance for USA, Canada, China, Hong Kong, Japan, UAE Changed SCA: Passkey no longer optional if supported by user’s device NovemberNov 17, 2025Added SCA: ScaContext request parameter on Recipient creation endpoint Changed SCA: Legacy User endpoints deprecated SCA: In Sandbox, SCA applied to all Legal User types Nov 10, 2025Added Result code 121030 for payouts failed due to Verification of Payee (VOP) Nov 3, 2025Added SCA: Bulgarian and Swedish localization support on the hosted experience OctoberOct 23, 2025Added SCA: Endpoint for managing user consent to actions under proxy Changed SCA: ScaContext value USER_NOT_PRESENT requires integration of proxy and user consent Added SCA: ScaContext request parameter on User endpoints Oct 9, 2025Added Verification of Payee (VOP) on recipients and payouts in Production Oct 2, 2025Added PayPal: Endpoint to send pre-transaction risk data SeptemberSep 30, 2025Added Verification of Payee (VOP) in Sandbox Sandbox test data to simulate KYC Document processing Sandbox test data to simulate UBO Declaration processing Sep 26, 2025Added SCA session language parameter Changed Payconiq endpoint deprecated: Decommissioning planned end of 2025 Sep 17, 2025Changed Banking Alias OwnerName value set automatically Banking Alias endpoints deprecated: Decommissioning planned for 2027 AugustAug 12, 2025Changed 30-day preauth: No show and complement features no longer available for integration Aug 6, 2025Added Echo: Report types for intents, actions, settlements, and splits JulyJul 23, 2025Changed Actions refused if UserStatus is PENDING_USER_ACTION Added Transfer error 002704 if UserStatus is PENDING_USER_ACTION Jul 16, 2025Added Mangopay Echo: Intents and Settlements to support third-party PSP transactions Jul 15, 2025Added Endpoint to retrieve supported banks for Pay by Bank Category and SKU properties of Klarna line items JuneJun 23, 2025Added Webhook event types for SCA enrollment Webhook event types for change of user category Error 002702 if transfer attempted to Payer Changed Rule preventing fake user names Jun 18, 2025Added Pay-ins via Bizum, a popular mobile payment method in Spain Buut bank supported by iDEAL Jun 17, 2025Added T2 scheme option for EUR local payouts, unlocking real-time gross settlement (RTGS) Jun 12, 2025Added US and CA virtual accounts for local pay-in collection Jun 5, 2025Added New reporting service endpoints MayMay 22, 2025Added Webhook event type for user account closure May 21, 2025Added Webhooks for instant and quoted conversions May 14, 2025Added Recipients: Country parameter added to improve international coverage Changed Recipients: InternationalBankTransfer schema changed to AccountNumber and BIC May 13, 2025Added Hosted KYC/KYB verification solution May 5, 2025Added SCT Inst on FR virtual IBANs AprilApr 24, 2025Added Virtual Accounts endpoints, replacing legacy Banking Alias feature Apr 15, 2025Added Recipient endpoints, replacing legacy Bank Account feature ScaContext and PendingUserAction to Transfers ScaContext and PendingUserAction to wallet access endpoints ResultCode 007101 and 007102 for SCA-related transfer failures Changed User-initiated transfer status remains CREATED until SCA completed Wallet access endpoints return 401 if SCA required Apr 14, 2025Added Endpoints to close user accounts MarchMar 27, 2025Added Pay by Bank payment method, leveraging open banking Mar 10, 2025Added Error 001405 to prevent direct debit refunds in first 7 days Changed Removed limit of 5 partial refunds for direct debit pay-ins FebruaryFeb 27, 2025Changed Payout minimum amount limit removed Feb 26, 2025Added User endpoints to enable SCA enrollment Feb 3, 2025Added Payout PaymentRef for refunding bank wire pay-in 2024DecemberDec 17, 2024Added Bank transaction details for bank wire pay-ins FX error 004803 for off-market trading attempts (if not enabled) Dec 12, 2024Added API keys: Assign permission scopes, reset, and revoke Dec 9, 2024Added Recurring payments with PayPal OctoberOct 28, 2024Added Swish (Sweden) payment method now available TWINT (Switzerland) payment method now available Oct 7, 2024Changed SEPA Direct Debit ChargeDate now 2 days earlier after CreationDate SeptemberSep 12, 2024 - PeipusAdded Pay-in error 008008: Account linked to card does not exist Changed Migration parameter deprecated on recurring pay-in registration AugustAug 9, 2024 - QottabAdded Quoted and Instant Conversions now available for Client Wallets Changed CreditedFunds Amount can be sent on quotes Aug 1, 2024 - NatronAdded CardHolderName can be added to existing Card objects Changed CardHolderName accepts special characters JulyJul 17, 2024 - ArgyleAdded Statement descriptor available on BACS Direct Debit Jul 15, 2024 - KennedyAdded Turkish National ID card now accepted Jul 9, 2024Changed Web Direct Debit PayIn endpoint marked as deprecated Giropay PayIn endpoint marked as deprecated JuneJun 27, 2024 - DogwifhatChanged Transaction objects no longer retrievable past 13 months Jun 5, 2024 - UrmiaAdded ValidationUsage parameter on card validation MayMay 16, 2024 - PetullaAdded Payouts error 121010: Further analysis needed May 14, 2024 - MeadAdded CardHolderName can be sent on Card Registration AprilApr 30, 2024 - CarreFraisAdded Error 121009: Payout expired before processing Error 130011: Instant payout mode prevents manual review Error 002701: Payer user requests payout Apr 9, 2024 - CronutAdded DE virtual IBANs now available in Production Apr 29, 2024 - HongzeAdded StatementDescriptor available on SDD refunds MarchMar 19, 2024 - KivuAdded New MOTO payment category FebruaryFeb 20, 2024 - MilleFeuilleAdded Guaranteed FX: Quoted conversions now available Spot FX: Fees can now be taken on instant conversions JanuaryJan 29, 2024 - KisaleAdded New endpoint to look up metadata from BIN or Google Pay token 2023DecemberDec 14, 2023 - EmpanadaAdded Card validation feature now available Dec 18, 2023 - BiwaAdded 30-day preauthorization: Complement feature 30-day preauthorization: No-show feature 30-day preauthorization: Additional endpoints and hooks Dec 13, 2023 - ChilkaAdded New CardInfo parameter returned on card transactions NovemberNov 15, 2023 - OperaAdded SpotFX: Instant Conversions now available Nov 8, 2023 - MozartChanged New limit of 15 UBOs per UBO Declaration OctoberOct 18, 2023 - BoratAdded New endpoint to validate the format of a CompanyNumber New hooks when the format of a User’s CompanyNumber is valid or not Changed New limit of 5 pages for KYC Documents JulyJul 19, 2023 - ProfiterolesAdded Partial Refunds for Transfers now available AprilApr 17, 2023 - DeimosAdded New KYC Document flag for paper-based formats FebruaryFeb 16, 2023 - GuzmaniaAdded New ClosedDate parameter for disputes Feb 15, 2023 - RosemaryAdded New restrictions on user nationality parameters 2022NovemberNov 9, 2022 - KurinjiAdded New 30-day preauthorization feature Nov 8, 2022 - BeanAdded New User LegalPersonType: Partnership SeptemberSep 21, 2022 - ArfajAdded New country authorization hook JulyJul 12, 2022 - AzollaAdded New restrictions on user Country parameters JuneJun 21, 2022 - AgaveAdded New country authorizations endpoints Jun 13, 2022 - PhecdaAdded New errors for unreadable KYC documents Jun 1, 2022 - AsterAdded Recurring: €0 deadlines for CIT Changed Recurring objects and migration flow behaviour MayMay 11, 2022 - ShamrockAdded UserCategory parameter Recurring PayIn Registration events May 4, 2022 - CyclamenAdded Birthday can no longer be set in the future Changed Error message for KYC Document creation MarchMar 31, 2022 - BromeliadAdded New terms and conditions acceptance parameter Mar 10, 2022 - LizzieAdded Instant Payment Only payout mode Check Instant Payout eligibility endpoint FebruaryFeb 17, 2022 - AnthuriumAdded Delegation attempt JanuaryJan 7, 2022 - ImaiAdded New KYC Documents accepted Jan 13, 2022 - ProteaAdded New KYC Document flag 2021NovemberNov 26, 2021 - CalateaImproved Flags parameter enhancement SeptemberSep 8, 2021 - PrimeroseAdded New KYC Document data New hook for instant payment JuneJun 3, 2021 - KhatAdded New recurring card pay-in feature Jun 23, 2021 - BegoniaAdded Get data about a recurring payment 3DSV2 for BCMC & MAESTRO MayMay 6, 2021 - TulipAdded New Preauthorization events Changed Identity proof minimum size May 21, 2021 - MimosaChanged Blocked users feature enhancements 2020AprilApr 22, 2020 - Aloe VeraAdded New KYC Level hook Improved AVS score for AMEX FebruaryFeb 27, 2020 - CoffeaAdded New mandate hook Changed New payment page design 2019NovemberNov 7, 2019 - WaterlilyImproved Missing information on debited bank account Changed Additional information returned on preauthorization Empty errors removed OctoberOct 30, 2019 - Ficus LyrataAdded New Sofort errors Improved CVV card number and expiry date on iOS Changed UBO Declaration is now mandatory JulyJul 30, 2019 - SquirrelAdded UBO declaration enhancements MayMay 24, 2019 - LynxAdded New emoney endpoint Changed Improved mandate events AprilApr 1, 2019 - ButterflyAdded New retry feature on hooks New restrictions by country Improved Email for disputes Apr 4, 2019 - Guinea PigAdded New UBO Declaration endpoint New company number accuracy checks 2018DecemberDec 4, 2018 - WolfAdded CVV culture Changed Error codes enhancements AugustAug 8, 2018 - BuffaloAdded New CVV/CVC collection page Changed 001999 error enhancement JulyJul 13, 2018 - CobraChanged Synchronization enhancements CVV collection workflow MarchMar 1, 2018 - PiranhaAdded Piranha 3DS Additional information provided Changed Card Fingerprint enhancements 2017DecemberDec 19, 2017 - OcelotAdded New View Bank Accounts for a User endpoint Card Fingerprint enhancement New PayPal soft descriptor Improved Synchronization Changed 45-day historical data on events NovemberNov 8, 2017 - CockatooAdded New transactions endpoints New refund and repudiation endpoints New filtering options Improved Simultaneous refunds Changed URL is now optional when updating a hook SeptemberSep 19, 2017 - RhinocerosAdded New payout refunds List Users for a Card Fingerprint endpoint Improved Wrong wallet balance Payment methods naming Changed Information displayed on end users’ bank statements Improved performance JulyJul 11, 2017 - UnicornAdded New card Fingerprint feature New CompanyNumber parameter Changed Enhancements MayMay 31, 2017 - MeerkatAdded New anti-fraud rules New UBO Declaration Improved Duplicated refunds Changed Retry on preauthorized pay-ins Enhancements AprilApr 25, 2017 - FoxAdded New Wallet Reports Preauthorization automatic cancellation Improved Corrected issues Changed Enhancements MarchMar 16, 2017 - ToucanAdded Permissions group Hook notifications analysis Improved Corrected issues Changed Enhancements FebruaryFeb 14, 2017 - WhaleAdded New automatic expiration for bank wire pay-ins Changed KYC limits update Enhancements Feb 27, 2017 - New product updatesAdded New e-money balance New Fee Amount filter on transaction reports Improved Reporting date filters not taken into account JanuaryJan 17, 2017 - BongosAdded Virtual IBAN private beta Changed Certain types of KYC docs can now be processed much more quickly Enhancements 2016NovemberNov 28, 2016 - PenguinAdded New statement descriptor for SEPA direct-debit Improved Corrected issues Small enhancements OctoberOct 3, 2016 - TubaAdded New request URL in idempotency Changed Hook notifications changes Enhancements AugustAug 3, 2016 - KangarooAdded New rate limiting feature New parameters for the reporting endpoint Changed Enhancements JuneJun 13, 2016 - HotfixImproved Corrected issues MayMay 26, 2016 - KazooAdded New functionalities Changed Enhancements AprilApr 16, 2016 - MandolinChanged Minor enhancements Apr 5, 2016 - SnakeAdded New functionalities Changed Enhancements FebruaryFeb 16, 2016 - UkuleleChanged Enhancements JanuaryJan 19, 2016 - BonoboChanged Enhancements 2015OctoberOct 19, 2015 - RacoonChanged Handling of disputes New payment method – Bancontact/Mister Cash (BCMC) Enhancements SeptemberSep 12, 2015 - MaracasImproved Corrected issues Changed Enhancements Sep 16, 2015 - PiccoloChanged Enhancements AugustAug 27, 2015 - SaxophoneAdded New payment method - IDeal New functionalities Changed Enhancements JuneJun 5, 2015 - New API version v2.01Changed New Address parameters for bank accounts 2014NovemberNov 7, 2014 - OkapiImproved Hooks Changed Custom sorting for User and Event lists SeptemberSep 5, 2014 - HamsterAdded New German payment methods ELV, SOFORT, GIROPAY Enhancements AugustAug 25, 2014 - PouletChanged Enhancements JulyJul 24, 2014 - ZebreChanged Enhancements Jul 31, 2014 - LapinChanged Enhancements