API - Mangopay docs

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

2025

June

June 23, 2025

Webhook event types for SCA enrollment
Webhook event types for change of user category
Error 002702 if transfer attempted to Payer

Rule preventing fake user names

June 18, 2025

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

June 17, 2025

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

June 12, 2025

US and CA virtual accounts for local pay-in collection

June 5, 2025

New reporting service endpoints

May

May 22, 2025

Webhook event type for user account closure

May 21, 2025

Webhooks for instant and quoted conversions

May 14, 2025

Recipients: Country parameter added to improve international coverage

Recipients: InternationalBankTransfer schema changed to AccountNumber and BIC

May 13, 2025

Hosted KYC/KYB verification solution

May 5, 2025

SCT Inst on FR virtual IBANs

April

Apr 24, 2025

Virtual Accounts endpoints, replacing legacy Banking Alias feature

Apr 15, 2025

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

User-initiated transfer status remains CREATED until SCA completed
Wallet access endpoints return 401 if SCA required

Apr 14, 2025

Endpoints to close user accounts

March

Mar 27, 2025

Pay by Bank payment method, leveraging open banking

Mar 10, 2025

Error 001405 to prevent direct debit refunds in first 7 days

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

February

Feb 27, 2025

Payout minimum amount limit removed

Feb 26, 2025

User endpoints to enable SCA enrollment

Feb 3, 2025

Payout PaymentRef for refunding bank wire pay-in

2024

December

Dec 17, 2024

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

Dec 12, 2024

API keys: Assign permission scopes, reset, and revoke

Dec 9, 2024

Recurring payments with PayPal

October

Oct 28, 2024

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

Oct 7, 2024

SEPA Direct Debit ChargeDate now 2 days earlier after CreationDate

September

Sep 12, 2024 - Peipus

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

Migration parameter deprecated on recurring pay-in registration

August

Aug 9, 2024 - Qottab

Quoted and Instant Conversions now available for Client Wallets

CreditedFunds Amount can be sent on quotes

Aug 1, 2024 - Natron

CardHolderName can be added to existing Card objects

CardHolderName accepts special characters

July

Jul 17, 2024 - Argyle

Statement descriptor available on BACS Direct Debit

Jul 15, 2024 - Kennedy

Turkish National ID card now accepted

Jul 9, 2024

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

June

Jun 27, 2024 - Dogwifhat

Transaction objects no longer retrievable past 13 months

Jun 5, 2024 - Urmia

ValidationUsage parameter on card validation

May

May 16, 2024 - Petulla

Payouts error 121010: Further analysis needed

May 14, 2024 - Mead

CardHolderName can be sent on Card Registration

April

Apr 30, 2024 - CarreFrais

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

Apr 9, 2024 - Cronut

DE virtual IBANs now available in Production

Apr 29, 2024 - Hongze

StatementDescriptor available on SDD refunds

March

Mar 19, 2024 - Kivu

New MOTO payment category

February

Feb 20, 2024 - MilleFeuille

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

January

Jan 29, 2024 - Kisale

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

2023

December

Dec 14, 2023 - Empanada

Card validation feature now available

Dec 18, 2023 - Biwa

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

Dec 13, 2023 - Chilka

New CardInfo parameter returned on card transactions

November

Nov 15, 2023 - Opera

SpotFX: Instant Conversions now available

Nov 8, 2023 - Mozart

New limit of 15 UBOs per UBO Declaration

October

Oct 18, 2023 - Borat

New endpoint to validate the format of a CompanyNumber
New hooks when the format of a User’s CompanyNumber is valid or not

New limit of 5 pages for KYC Documents

July

Jul 19, 2023 - Profiteroles

Partial Refunds for Transfers now available

April

Apr 17, 2023 - Deimos

New KYC Document flag for paper-based formats

February

Feb 16, 2023 - Guzmania

New ClosedDate parameter for disputes

Feb 15, 2023 - Rosemary

New restrictions on user nationality parameters

2022

November

Nov 9, 2022 - Kurinji

New 30-day preauthorization feature

Nov 8, 2022 - Bean

New User LegalPersonType: Partnership

September

Sep 21, 2022 - Arfaj

New country authorization hook

July

Jul 12, 2022 - Azolla

New restrictions on user Country parameters

June

Jun 21, 2022 - Agave

New country authorizations endpoints

Jun 13, 2022 - Phecda

New errors for unreadable KYC documents

Jun 1, 2022 - Aster

Recurring: €0 deadlines for CIT

Recurring objects and migration flow behaviour

May

May 11, 2022 - Shamrock

UserCategory parameter
Recurring PayIn Registration events

May 4, 2022 - Cyclamen

Birthday can no longer be set in the future

Error message for KYC Document creation

March

Mar 31, 2022 - Bromeliad

New terms and conditions acceptance parameter

Mar 10, 2022 - Lizzie

Instant Payment Only payout mode
Check Instant Payout eligibility endpoint

February

Feb 17, 2022 - Anthurium

Delegation attempt

January

Jan 7, 2022 - Imai

New KYC Documents accepted

Jan 13, 2022 - Protea

New KYC Document flag

2021

November

Nov 26, 2021 - Calatea

Flags parameter enhancement

September

Sep 8, 2021 - Primerose

New KYC Document data
New hook for instant payment

June

Jun 3, 2021 - Khat

New recurring card pay-in feature

Jun 23, 2021 - Begonia

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

May

May 6, 2021 - Tulip

New Preauthorization events

Identity proof minimum size

May 21, 2021 - Mimosa

Blocked users feature enhancements

2020

April

Apr 22, 2020 - Aloe Vera

New KYC Level hook

AVS score for AMEX

February

Feb 27, 2020 - Coffea

New mandate hook

New payment page design

2019

November

Nov 7, 2019 - Waterlily

Missing information on debited bank account

Additional information returned on preauthorization
Empty errors removed

October

Oct 30, 2019 - Ficus Lyrata

New Sofort errors

CVV card number and expiry date on iOS

UBO Declaration is now mandatory

July

Jul 30, 2019 - Squirrel

UBO declaration enhancements

May

May 24, 2019 - Lynx

New emoney endpoint

Improved mandate events

April

Apr 1, 2019 - Butterfly

New retry feature on hooks
New restrictions by country

Email for disputes

Apr 4, 2019 - Guinea Pig

New UBO Declaration endpoint
New company number accuracy checks

2018

December

Dec 4, 2018 - Wolf

CVV culture

Error codes enhancements

August

Aug 8, 2018 - Buffalo

New CVV/CVC collection page

001999 error enhancement

July

Jul 13, 2018 - Cobra

Synchronization enhancements
CVV collection workflow

March

Mar 1, 2018 - Piranha

Piranha
3DS Additional information provided

Card Fingerprint enhancements

2017

December

Dec 19, 2017 - Ocelot

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

Synchronization

45-day historical data on events

November

Nov 8, 2017 - Cockatoo

New transactions endpoints
New refund and repudiation endpoints
New filtering options

Simultaneous refunds

URL is now optional when updating a hook

September

Sep 19, 2017 - Rhinoceros

New payout refunds
List Users for a Card Fingerprint endpoint

Wrong wallet balance
Payment methods naming

Information displayed on end users’ bank statements
Improved performance

July

Jul 11, 2017 - Unicorn

New card Fingerprint feature
New CompanyNumber parameter

Enhancements

May

May 31, 2017 - Meerkat

New anti-fraud rules
New UBO Declaration

Duplicated refunds

Retry on preauthorized pay-ins
Enhancements

April

Apr 25, 2017 - Fox

New Wallet Reports
Preauthorization automatic cancellation

Corrected issues

Enhancements

March

Mar 16, 2017 - Toucan

Permissions group
Hook notifications analysis

Corrected issues

Enhancements

February

Feb 14, 2017 - Whale

New automatic expiration for bank wire pay-ins

KYC limits update
Enhancements

Feb 27, 2017 - New product updates

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

Reporting date filters not taken into account

January

Jan 17, 2017 - Bongos

Virtual IBAN private beta

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

2016

November

Nov 28, 2016 - Penguin

New statement descriptor for SEPA direct-debit

Corrected issues
Small enhancements

October

Oct 3, 2016 - Tuba

New request URL in idempotency

Hook notifications changes
Enhancements

August

Aug 3, 2016 - Kangaroo

New rate limiting feature
New parameters for the reporting endpoint

Enhancements

June

Jun 13, 2016 - Hotfix

Corrected issues

May

May 26, 2016 - Kazoo

New functionalities

Enhancements

April

Apr 16, 2016 - Mandolin

Minor enhancements

Apr 5, 2016 - Snake

New functionalities

Changed
Enhancements

February

Feb 16, 2016 - Ukulele

Enhancements

January

Jan 19, 2016 - Bonobo

Enhancements

2015

October

Oct 19, 2015 - Racoon

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

September

Sep 12, 2015 - Maracas

Corrected issues

Enhancements

Sep 16, 2015 - Piccolo

Enhancements

August

Aug 27, 2015 - Saxophone

New payment method - IDeal
New functionalities

Enhancements

June

Jun 5, 2015 - New API version v2.01

New Address parameters for bank accounts

2014

November

Nov 7, 2014 - Okapi

Hooks

Custom sorting for User and Event lists

September

Sep 5, 2014 - Hamster

New German payment methods ELV, SOFORT, GIROPAY
Enhancements

August

Aug 25, 2014 - Poulet

Enhancements

July

Jul 24, 2014 - Zebre

Enhancements

Jul 31, 2014 - Lapin

Enhancements

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

2025

June

June 23, 2025

Webhook event types for SCA enrollment
Webhook event types for change of user category
Error 002702 if transfer attempted to Payer

Rule preventing fake user names

June 18, 2025

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

June 17, 2025

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

June 12, 2025

US and CA virtual accounts for local pay-in collection

June 5, 2025

New reporting service endpoints

May

May 22, 2025

Webhook event type for user account closure

May 21, 2025

Webhooks for instant and quoted conversions

May 14, 2025

Recipients: Country parameter added to improve international coverage

Recipients: InternationalBankTransfer schema changed to AccountNumber and BIC

May 13, 2025

Hosted KYC/KYB verification solution

May 5, 2025

SCT Inst on FR virtual IBANs

April

Apr 24, 2025

Virtual Accounts endpoints, replacing legacy Banking Alias feature

Apr 15, 2025

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

User-initiated transfer status remains CREATED until SCA completed
Wallet access endpoints return 401 if SCA required

Apr 14, 2025

Endpoints to close user accounts

March

Mar 27, 2025

Pay by Bank payment method, leveraging open banking

Mar 10, 2025

Error 001405 to prevent direct debit refunds in first 7 days

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

February

Feb 27, 2025

Payout minimum amount limit removed

Feb 26, 2025

User endpoints to enable SCA enrollment

Feb 3, 2025

Payout PaymentRef for refunding bank wire pay-in

2024

December

Dec 17, 2024

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

Dec 12, 2024

API keys: Assign permission scopes, reset, and revoke

Dec 9, 2024

Recurring payments with PayPal

October

Oct 28, 2024

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

Oct 7, 2024

SEPA Direct Debit ChargeDate now 2 days earlier after CreationDate

September

Sep 12, 2024 - Peipus

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

Migration parameter deprecated on recurring pay-in registration

August

Aug 9, 2024 - Qottab

Quoted and Instant Conversions now available for Client Wallets

CreditedFunds Amount can be sent on quotes

Aug 1, 2024 - Natron

CardHolderName can be added to existing Card objects

CardHolderName accepts special characters

July

Jul 17, 2024 - Argyle

Statement descriptor available on BACS Direct Debit

Jul 15, 2024 - Kennedy

Turkish National ID card now accepted

Jul 9, 2024

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

June

Jun 27, 2024 - Dogwifhat

Transaction objects no longer retrievable past 13 months

Jun 5, 2024 - Urmia

ValidationUsage parameter on card validation

May

May 16, 2024 - Petulla

Payouts error 121010: Further analysis needed

May 14, 2024 - Mead

CardHolderName can be sent on Card Registration

April

Apr 30, 2024 - CarreFrais

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

Apr 9, 2024 - Cronut

DE virtual IBANs now available in Production

Apr 29, 2024 - Hongze

StatementDescriptor available on SDD refunds

March

Mar 19, 2024 - Kivu

New MOTO payment category

February

Feb 20, 2024 - MilleFeuille

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

January

Jan 29, 2024 - Kisale

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

2023

December

Dec 14, 2023 - Empanada

Card validation feature now available

Dec 18, 2023 - Biwa

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

Dec 13, 2023 - Chilka

New CardInfo parameter returned on card transactions

November

Nov 15, 2023 - Opera

SpotFX: Instant Conversions now available

Nov 8, 2023 - Mozart

New limit of 15 UBOs per UBO Declaration

October

Oct 18, 2023 - Borat

New endpoint to validate the format of a CompanyNumber
New hooks when the format of a User’s CompanyNumber is valid or not

New limit of 5 pages for KYC Documents

July

Jul 19, 2023 - Profiteroles

Partial Refunds for Transfers now available

April

Apr 17, 2023 - Deimos

New KYC Document flag for paper-based formats

February

Feb 16, 2023 - Guzmania

New ClosedDate parameter for disputes

Feb 15, 2023 - Rosemary

New restrictions on user nationality parameters

2022

November

Nov 9, 2022 - Kurinji

New 30-day preauthorization feature

Nov 8, 2022 - Bean

New User LegalPersonType: Partnership

September

Sep 21, 2022 - Arfaj

New country authorization hook

July

Jul 12, 2022 - Azolla

New restrictions on user Country parameters

June

Jun 21, 2022 - Agave

New country authorizations endpoints

Jun 13, 2022 - Phecda

New errors for unreadable KYC documents

Jun 1, 2022 - Aster

Recurring: €0 deadlines for CIT

Recurring objects and migration flow behaviour

May

May 11, 2022 - Shamrock

UserCategory parameter
Recurring PayIn Registration events

May 4, 2022 - Cyclamen

Birthday can no longer be set in the future

Error message for KYC Document creation

March

Mar 31, 2022 - Bromeliad

New terms and conditions acceptance parameter

Mar 10, 2022 - Lizzie

Instant Payment Only payout mode
Check Instant Payout eligibility endpoint

February

Feb 17, 2022 - Anthurium

Delegation attempt

January

Jan 7, 2022 - Imai

New KYC Documents accepted

Jan 13, 2022 - Protea

New KYC Document flag

2021

November

Nov 26, 2021 - Calatea

Flags parameter enhancement

September

Sep 8, 2021 - Primerose

New KYC Document data
New hook for instant payment

June

Jun 3, 2021 - Khat

New recurring card pay-in feature

Jun 23, 2021 - Begonia

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

May

May 6, 2021 - Tulip

New Preauthorization events

Identity proof minimum size

May 21, 2021 - Mimosa

Blocked users feature enhancements

2020

April

Apr 22, 2020 - Aloe Vera

New KYC Level hook

AVS score for AMEX

February

Feb 27, 2020 - Coffea

New mandate hook

New payment page design

2019

November

Nov 7, 2019 - Waterlily

Missing information on debited bank account

Additional information returned on preauthorization
Empty errors removed

October

Oct 30, 2019 - Ficus Lyrata

New Sofort errors

CVV card number and expiry date on iOS

UBO Declaration is now mandatory

July

Jul 30, 2019 - Squirrel

UBO declaration enhancements

May

May 24, 2019 - Lynx

New emoney endpoint

Improved mandate events

April

Apr 1, 2019 - Butterfly

New retry feature on hooks
New restrictions by country

Email for disputes

Apr 4, 2019 - Guinea Pig

New UBO Declaration endpoint
New company number accuracy checks

2018

December

Dec 4, 2018 - Wolf

CVV culture

Error codes enhancements

August

Aug 8, 2018 - Buffalo

New CVV/CVC collection page

001999 error enhancement

July

Jul 13, 2018 - Cobra

Synchronization enhancements
CVV collection workflow

March

Mar 1, 2018 - Piranha

Piranha
3DS Additional information provided

Card Fingerprint enhancements

2017

December

Dec 19, 2017 - Ocelot

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

Synchronization

45-day historical data on events

November

Nov 8, 2017 - Cockatoo

New transactions endpoints
New refund and repudiation endpoints
New filtering options

Simultaneous refunds

URL is now optional when updating a hook

September

Sep 19, 2017 - Rhinoceros

New payout refunds
List Users for a Card Fingerprint endpoint

Wrong wallet balance
Payment methods naming

Information displayed on end users’ bank statements
Improved performance

July

Jul 11, 2017 - Unicorn

New card Fingerprint feature
New CompanyNumber parameter

Enhancements

May

May 31, 2017 - Meerkat

New anti-fraud rules
New UBO Declaration

Duplicated refunds

Retry on preauthorized pay-ins
Enhancements

April

Apr 25, 2017 - Fox

New Wallet Reports
Preauthorization automatic cancellation

Corrected issues

Enhancements

March

Mar 16, 2017 - Toucan

Permissions group
Hook notifications analysis

Corrected issues

Enhancements

February

Feb 14, 2017 - Whale

New automatic expiration for bank wire pay-ins

KYC limits update
Enhancements

Feb 27, 2017 - New product updates

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

Reporting date filters not taken into account

January

Jan 17, 2017 - Bongos

Virtual IBAN private beta

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

2016

November

Nov 28, 2016 - Penguin

New statement descriptor for SEPA direct-debit

Corrected issues
Small enhancements

October

Oct 3, 2016 - Tuba

New request URL in idempotency

Hook notifications changes
Enhancements

August

Aug 3, 2016 - Kangaroo

New rate limiting feature
New parameters for the reporting endpoint

Enhancements

June

Jun 13, 2016 - Hotfix

Corrected issues

May

May 26, 2016 - Kazoo

New functionalities

Enhancements

April

Apr 16, 2016 - Mandolin

Minor enhancements

Apr 5, 2016 - Snake

New functionalities

Changed
Enhancements

February

Feb 16, 2016 - Ukulele

Enhancements

January

Jan 19, 2016 - Bonobo

Enhancements

2015

October

Oct 19, 2015 - Racoon

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

September

Sep 12, 2015 - Maracas

Corrected issues

Enhancements

Sep 16, 2015 - Piccolo

Enhancements

August

Aug 27, 2015 - Saxophone

New payment method - IDeal
New functionalities

Enhancements

June

Jun 5, 2015 - New API version v2.01

New Address parameters for bank accounts

2014

November

Nov 7, 2014 - Okapi

Hooks

Custom sorting for User and Event lists

September

Sep 5, 2014 - Hamster

New German payment methods ELV, SOFORT, GIROPAY
Enhancements

August

Aug 25, 2014 - Poulet

Enhancements

July

Jul 24, 2014 - Zebre

Enhancements

Jul 31, 2014 - Lapin

Enhancements