API

Changelog of new features and updates across all endpoints of the Mangopay API.

2026

April

Apr 22, 2026

Added

• Payouts error 121018 for Bank Account objects created after April 30, 2026

Apr 16, 2026

Changed

• User date of birth limited to 120 years ago

March

Mar 30, 2026

Changed

• 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, 2026

Added

• SCA: Mutual TLS (mTLS) authentication required for platforms using proxy

Mar 11, 2026

Added

• KYB document guidance for 15 countries across EMEA, APAC, and the Americas

Mar 9, 2026

Added

• Color customization in the SCA hosted experience

February

Feb 23, 2026

Added

• Authentication type response parameter for card transactions

Feb 19, 2026

Changed

• Rules preventing Natural Users being used for non-personal accounts

Feb 16, 2026

Added

• Test value to bypass SCA in Sandbox on Users
• ChargeBearer parameter for cost-bearing on SWIFT payouts

Feb 12, 2026

Changed

• Echo: Endpoints for uploading settlement files

Added

• Echo: Endpoints for managing Intent Refunds and disputes

Feb 11, 2026

Added

• User margin calculations on FX conversions

Changed

• FX fees based on percentage or fixed amount

Feb 3, 2026

Added

• ActionCode 008715 for blocked users requiring KYC/KYB verification

January

Jan 27, 2026

Added

• RecipientId property added to payouts
• TelephoneOrder property added to recurring card pay-ins

Jan 15, 2026

Added

• SCA: Endpoint to retrieve SCA status of a User: enrollment and consent to proxy action scopes

Jan 8, 2026

Added

• SCA: Webhooks for proxy action scope consent changes
• SCA: Webhooks for email and phone number verification

2025

December

Dec 18, 2025

Added

• KYB document guidance for USA, Canada, China, Hong Kong, Japan, UAE

Changed

• SCA: Passkey no longer optional if supported by user’s device

November

Nov 17, 2025

Added

• 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, 2025

Added

• Result code 121030 for payouts failed due to Verification of Payee (VOP)

Nov 3, 2025

Added

• SCA: Bulgarian and Swedish localization support on the hosted experience

October

Oct 23, 2025

Added

• 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, 2025

Added

• Verification of Payee (VOP) on recipients and payouts in Production

Oct 2, 2025

Added

• PayPal: Endpoint to send pre-transaction risk data

September

Sep 30, 2025

Added

• Verification of Payee (VOP) in Sandbox
• Sandbox test data to simulate KYC Document processing
• Sandbox test data to simulate UBO Declaration processing

Sep 26, 2025

Added

• SCA session language parameter

Changed

• Payconiq endpoint deprecated: Decommissioning planned end of 2025

Sep 17, 2025

Changed

• Banking Alias OwnerName value set automatically
• Banking Alias endpoints deprecated: Decommissioning planned Q3 2026

August

Aug 12, 2025

Changed

• 30-day preauth: No show and complement features no longer available for integration

Aug 6, 2025

Added

• Echo: Report types for intents, actions, settlements, and splits

July

Jul 23, 2025

Changed

• Actions refused if UserStatus is PENDING_USER_ACTION

Added

• Transfer error 002704 if UserStatus is PENDING_USER_ACTION

Jul 16, 2025

Added

• Mangopay Echo: Intents and Settlements to support third-party PSP transactions

Jul 15, 2025

Added

• Endpoint to retrieve supported banks for Pay by Bank
• Category and SKU properties of Klarna line items

June

Jun 23, 2025

Added

• 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, 2025

Added

• Pay-ins via Bizum, a popular mobile payment method in Spain
• Buut bank supported by iDEAL

Jun 17, 2025

Added

• T2 scheme option for EUR local payouts, unlocking real-time gross settlement (RTGS)

Jun 12, 2025

Added

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

Jun 5, 2025

Added

• New reporting service endpoints

May

May 22, 2025

Added

• Webhook event type for user account closure

May 21, 2025

Added

• Webhooks for instant and quoted conversions

May 14, 2025

Added

• Recipients: Country parameter added to improve international coverage

Changed

• Recipients: InternationalBankTransfer schema changed to AccountNumber and BIC

May 13, 2025

Added

• Hosted KYC/KYB verification solution

May 5, 2025

Added

• SCT Inst on FR virtual IBANs

April

Apr 24, 2025

Added

• Virtual Accounts endpoints, replacing legacy Banking Alias feature

Apr 15, 2025

Added

• 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, 2025

Added

• Endpoints to close user accounts

March

Mar 27, 2025

Added

• Pay by Bank payment method, leveraging open banking

Mar 10, 2025

Added

• Error 001405 to prevent direct debit refunds in first 7 days

Changed

• Removed limit of 5 partial refunds for direct debit pay-ins

February

Feb 27, 2025

Changed

• Payout minimum amount limit removed

Feb 26, 2025

Added

• User endpoints to enable SCA enrollment

Feb 3, 2025

Added

• Payout PaymentRef for refunding bank wire pay-in

2024

December

Dec 17, 2024

Added

• Bank transaction details for bank wire pay-ins
• FX error 004803 for off-market trading attempts (if not enabled)

Dec 12, 2024

Added

• API keys: Assign permission scopes, reset, and revoke

Dec 9, 2024

Added

• Recurring payments with PayPal

October

Oct 28, 2024

Added

• Swish (Sweden) payment method now available
• TWINT (Switzerland) payment method now available

Oct 7, 2024

Changed

• SEPA Direct Debit ChargeDate now 2 days earlier after CreationDate

September

Sep 12, 2024 - Peipus

Added

• Pay-in error 008008: Account linked to card does not exist

Changed

• Migration parameter deprecated on recurring pay-in registration

August

Aug 9, 2024 - Qottab

Added

• Quoted and Instant Conversions now available for Client Wallets

Changed

• CreditedFunds Amount can be sent on quotes

Aug 1, 2024 - Natron

Added

• CardHolderName can be added to existing Card objects

Changed

• CardHolderName accepts special characters

July

Jul 17, 2024 - Argyle

Added

• Statement descriptor available on BACS Direct Debit

Jul 15, 2024 - Kennedy

Added

• Turkish National ID card now accepted

Jul 9, 2024

Changed

• Web Direct Debit PayIn endpoint marked as deprecated
• Giropay PayIn endpoint marked as deprecated

June

Jun 27, 2024 - Dogwifhat

Changed

• Transaction objects no longer retrievable past 13 months

Jun 5, 2024 - Urmia

Added

• ValidationUsage parameter on card validation

May

May 16, 2024 - Petulla

Added

• Payouts error 121010: Further analysis needed

May 14, 2024 - Mead

Added

• CardHolderName can be sent on Card Registration

April

Apr 30, 2024 - CarreFrais

Added

• Error 121009: Payout expired before processing
• Error 130011: Instant payout mode prevents manual review
• Error 002701: Payer user requests payout

Apr 9, 2024 - Cronut

Added

• DE virtual IBANs now available in Production

Apr 29, 2024 - Hongze

Added

• StatementDescriptor available on SDD refunds

March

Mar 19, 2024 - Kivu

Added

• New MOTO payment category

February

Feb 20, 2024 - MilleFeuille

Added

• Guaranteed FX: Quoted conversions now available
• Spot FX: Fees can now be taken on instant conversions

January

Jan 29, 2024 - Kisale

Added

• New endpoint to look up metadata from BIN or Google Pay token

2023

December

Dec 14, 2023 - Empanada

Added

• Card validation feature now available

Dec 18, 2023 - Biwa

Added

• 30-day preauthorization: Complement feature
• 30-day preauthorization: No-show feature
• 30-day preauthorization: Additional endpoints and hooks

Dec 13, 2023 - Chilka

Added

• New CardInfo parameter returned on card transactions

November

Nov 15, 2023 - Opera

Added

• SpotFX: Instant Conversions now available

Nov 8, 2023 - Mozart

Changed

• New limit of 15 UBOs per UBO Declaration

October

Oct 18, 2023 - Borat

Added

• 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

July

Jul 19, 2023 - Profiteroles

Added

• Partial Refunds for Transfers now available

April

Apr 17, 2023 - Deimos

Added

• New KYC Document flag for paper-based formats

February

Feb 16, 2023 - Guzmania

Added

• New ClosedDate parameter for disputes

Feb 15, 2023 - Rosemary

Added

• New restrictions on user nationality parameters

2022

November

Nov 9, 2022 - Kurinji

Added

• New 30-day preauthorization feature

Nov 8, 2022 - Bean

Added

• New User LegalPersonType: Partnership

September

Sep 21, 2022 - Arfaj

Added

• New country authorization hook

July

Jul 12, 2022 - Azolla

Added

• New restrictions on user Country parameters

June

Jun 21, 2022 - Agave

Added

• New country authorizations endpoints

Jun 13, 2022 - Phecda

Added

• New errors for unreadable KYC documents

Jun 1, 2022 - Aster

Added

• Recurring: €0 deadlines for CIT

Changed

• Recurring objects and migration flow behaviour

May

May 11, 2022 - Shamrock

Added

• UserCategory parameter
• Recurring PayIn Registration events

May 4, 2022 - Cyclamen

Added

• Birthday can no longer be set in the future

Changed

• Error message for KYC Document creation

March

Mar 31, 2022 - Bromeliad

Added

• New terms and conditions acceptance parameter

Mar 10, 2022 - Lizzie

Added

• Instant Payment Only payout mode
• Check Instant Payout eligibility endpoint

February

Feb 17, 2022 - Anthurium

Added

• Delegation attempt

January

Jan 7, 2022 - Imai

Added

• New KYC Documents accepted

Jan 13, 2022 - Protea

Added

• New KYC Document flag

2021

November

Nov 26, 2021 - Calatea

Improved

• Flags parameter enhancement

September

Sep 8, 2021 - Primerose

Added

• New KYC Document data
• New hook for instant payment

June

Jun 3, 2021 - Khat

Added

• New recurring card pay-in feature

Jun 23, 2021 - Begonia

Added

• Get data about a recurring payment
• 3DSV2 for BCMC & MAESTRO

May

May 6, 2021 - Tulip

Added

• New Preauthorization events

Changed

• Identity proof minimum size

May 21, 2021 - Mimosa

Changed

• Blocked users feature enhancements

2020

April

Apr 22, 2020 - Aloe Vera

Added

• New KYC Level hook

Improved

• AVS score for AMEX

February

Feb 27, 2020 - Coffea

Added

• New mandate hook

Changed

• New payment page design

2019

November

Nov 7, 2019 - Waterlily

Improved

• Missing information on debited bank account

Changed

• Additional information returned on preauthorization
• Empty errors removed

October

Oct 30, 2019 - Ficus Lyrata

Added

• New Sofort errors

Improved

• CVV card number and expiry date on iOS

Changed

• UBO Declaration is now mandatory

July

Jul 30, 2019 - Squirrel

Added

• UBO declaration enhancements

May

May 24, 2019 - Lynx

Added

• New emoney endpoint

Changed

• Improved mandate events

April

Apr 1, 2019 - Butterfly

Added

• New retry feature on hooks
• New restrictions by country

Improved

• Email for disputes

Apr 4, 2019 - Guinea Pig

Added

• New UBO Declaration endpoint
• New company number accuracy checks

2018

December

Dec 4, 2018 - Wolf

Added

• CVV culture

Changed

• Error codes enhancements

August

Aug 8, 2018 - Buffalo

Added

• New CVV/CVC collection page

Changed

• 001999 error enhancement

July

Jul 13, 2018 - Cobra

Changed

• Synchronization enhancements
• CVV collection workflow

March

Mar 1, 2018 - Piranha

Added

• Piranha
• 3DS Additional information provided

Changed

• Card Fingerprint enhancements

2017

December

Dec 19, 2017 - Ocelot

Added

• New View Bank Accounts for a User endpoint
• Card Fingerprint enhancement
• New PayPal soft descriptor

Improved

• Synchronization

Changed

• 45-day historical data on events

November

Nov 8, 2017 - Cockatoo

Added

• New transactions endpoints
• New refund and repudiation endpoints
• New filtering options

Improved

• Simultaneous refunds

Changed

• URL is now optional when updating a hook

September

Sep 19, 2017 - Rhinoceros

Added

• 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

July

Jul 11, 2017 - Unicorn

Added

• New card Fingerprint feature
• New CompanyNumber parameter

Changed

• Enhancements

May

May 31, 2017 - Meerkat

Added

• New anti-fraud rules
• New UBO Declaration

Improved

• Duplicated refunds

Changed

• Retry on preauthorized pay-ins
• Enhancements

April

Apr 25, 2017 - Fox

Added

• New Wallet Reports
• Preauthorization automatic cancellation

Improved

• Corrected issues

Changed

• Enhancements

March

Mar 16, 2017 - Toucan

Added

• Permissions group
• Hook notifications analysis

Improved

• Corrected issues

Changed

• Enhancements

February

Feb 14, 2017 - Whale

Added

• New automatic expiration for bank wire pay-ins

Changed

• KYC limits update
• Enhancements

Feb 27, 2017 - New product updates

Added

• New e-money balance
• New Fee Amount filter on transaction reports

Improved

• Reporting date filters not taken into account

January

Jan 17, 2017 - Bongos

Added

• Virtual IBAN private beta

Changed

• Certain types of KYC docs can now be processed much more quickly
• Enhancements

2016

November

Nov 28, 2016 - Penguin

Added

• New statement descriptor for SEPA direct-debit

Improved

• Corrected issues
• Small enhancements

October

Oct 3, 2016 - Tuba

Added

• New request URL in idempotency

Changed

• Hook notifications changes
• Enhancements

August

Aug 3, 2016 - Kangaroo

Added

• New rate limiting feature
• New parameters for the reporting endpoint

Changed

• Enhancements

June

Jun 13, 2016 - Hotfix

Improved

• Corrected issues

May

May 26, 2016 - Kazoo

Added

• New functionalities

Changed

• Enhancements

April

Apr 16, 2016 - Mandolin

Changed

• Minor enhancements

Apr 5, 2016 - Snake

Added

• New functionalities
  
  Changed
• Enhancements

February

Feb 16, 2016 - Ukulele

Changed

• Enhancements

January

Jan 19, 2016 - Bonobo

Changed

• Enhancements

2015

October

Oct 19, 2015 - Racoon

Changed

• Handling of disputes
• New payment method – Bancontact/Mister Cash (BCMC)
• Enhancements

September

Sep 12, 2015 - Maracas

Improved

• Corrected issues

Changed

• Enhancements

Sep 16, 2015 - Piccolo

Changed

• Enhancements

August

Aug 27, 2015 - Saxophone

Added

• New payment method - IDeal
• New functionalities

Changed

• Enhancements

June

Jun 5, 2015 - New API version v2.01

Changed

• New Address parameters for bank accounts

2014

November

Nov 7, 2014 - Okapi

Improved

• Hooks

Changed

• Custom sorting for User and Event lists

September

Sep 5, 2014 - Hamster

Added

• New German payment methods ELV, SOFORT, GIROPAY
• Enhancements

August

Aug 25, 2014 - Poulet

Changed

• Enhancements

July

Jul 24, 2014 - Zebre

Changed

• Enhancements

Jul 31, 2014 - Lapin

Changed

• Enhancements