All error codes | Mangopay docs

This page lists the functional errors returned by the API as a ResultCode and its ResultMessage.

For KYC document refusals (RefusedReasonType, RefusedReasonMessage, and Flag), see the dealing with refusals article.

For ActionCodes applied when a user is blocked, see the blocked users article.

Note - Categories are indicative

The categories presented on this page are not exhaustive and errors may be returned on multiple features and endpoints.

Success

000000

Success

The 000000 result code indicates a successful outcome.

Generic

001015

The client API access is not active

The API access of the platform is not active.

001999

Generic Operation error

An incident or connection issue has occurred and closed all transactions.

009999

Technical error

Technical error.

User limits

Closed users

002601

User owning debited wallet is closed and cannot transfer to another wallet

The transaction is requested from a wallet belonging to a closed user and is therefore refused.

002602

User owning credited wallet is closed and and cannot receive funds from another wallet

The transaction is targeting a wallet belonging to a closed user and is therefore refused.

User category

002701

Users with category PAYER cannot make transfers to other users with category PAYER.

The action was refused because the user is a Payer, not an Owner.

002702

Users with category PAYER cannot receive transfers from users with category OWNER.

The action was refused because the user receiving the transfer is a Payer, not an Owner.

002703

Refused due to user’s UserCategory: PAYER

The action was refused because it is only permitted if the user is an OWNER.

002704

Users in PENDING_USER_ACTION status cannot create transfers

The transfer failed because the user’s UserStatus is PENDING_USER_ACTION.

Owner user SCA

007101

Transfer authentication failed. Please retry with a new request.

The user reached the maximum number of retries for one of the authentication factors, so the SCA session failed.

007102

Transfer authentication expired. Please initiate a new request.

The user did not complete all steps required within 10 minutes, so the SCA session expired.

User KYC/KYB verification

002951

Beneficiary OWNER user(s) not KYC verified (KYCLevel is not REGULAR): [list of UserId]

The transaction was refused because a targeted user is not an OWNER whose KYCLevel is REGULAR (or a PLATFORM user). The unverified user may be the CreditedWalletId holder or (on a pay-in, if declared) a FlowDescriptor.Beneficiaries.UserId.

002996

Blocked due to User Balance limitations (maximum owned amount reached)

The payout was blocked due to user balance limitations.

002997

Blocked due to KYC limitations (maximum debited or credited amount reached)

The payout was blocked due to KYC limitations in terms of credited or debited amount.

002998

Blocked due to the Bank Account User’s KYC limitations (maximum debited or credited amount reached)

The payout was refused refused because the Recipient (bank account) owner is not verified.

002999

Blocked due to a Debited User’s KYC limitations (maximum debited or credited amount reached)

The payout was blocked due to KYC limitations in terms of credited or debited amount.

Card input and registration

001599

Token processing error

The token for the card wasn’t created.

105101

Invalid card number

The given card number doesn’t match the real number of the card.

105102

Invalid cardholder name

The given card holder’s name doesn’t match the name of the owner of the card.

105103

Invalid PIN code

The PIN (”personal identification number”) is invalid.

105104

Invalid PIN format

The format of the personal identification number is not valid.

105202

Card number: invalid format

The card number’s format provided for the card registration is invalid.

105203

Expiry date: missing or invalid format

The card’s expiry date information provided for the card registration is either invalid or missing.

105204

CVV: missing or invalid format

The card verification code information provided for the card registration is either invalid or missing.

105205

Callback URL: Invalid format

The ReturnURL parameter value is invalid in the card registration.

105206

Registration data : Invalid format

The RegistrationData provided for the card registration is invalid.

105299

Token input Error

An error occurred when submitting the token to the bank.

101699

CardRegistration error

The card registration failed.

Generic transaction errors

001001

Unsufficient wallet balance

The wallet does not contain enough funds to process the transaction.

001002

Author is not the wallet owner

The user Id used as Author has to be the wallet owner

001003

Unsufficient balance for this emoney owner

The transaction failed due to insufficient balance for the e-money owner.

001011

Transaction amount is higher than maximum permitted amount

The pay-in cannot be processed because the amount is higher than the maximum permitted amount.

001012

Transaction amount is lower than minimum permitted amount

The transaction cannot be performed because the amount is lower than the minimum permitted amount.

001013

Invalid transaction amount

The end user’s bank has rejected the transaction.

001014

CreditedFunds must be more than 0 (DebitedFunds can not equal Fees)

The debited funds must be greater than the fees.

101108

Transaction refused: the Debited Wallet and the Credited Wallet must be different

Funds cannot be transferred to the same wallet.

Pay-ins

009101

PSP timeout please try later

PSP timeout please try later.

009103

PSP configuration error

009199

PSP technical error

The pay-in failed due to a technical error linked to the PSP.

009499

Bank technical error

The Bank has denied the payment for unknown reasons.

101101

Transaction refused by the bank (Do not honor)

The transaction has been refused due to restrictions on the issuing bank side.

101109

The payment period has expired

The period allowed for the user to complete the payment has ended.

101111

Maximum number of attempts reached

The pay-in is blocked due to too many attempts for the same transaction.

101199

Transaction refused

The transaction has been refused by the bank.

Card payments

001023

Author is not the card owner

The pay-in failed because the author is different from the card owner.

101102

Transaction refused by the bank (Amount limit)

The card has reached the amount limit set by the issuing bank.

101103

Transaction refused by the terminal

Transaction refused by the terminal.

101104

Transaction refused by the bank (card limit reached)

The card limit has been reached.

101105

The card has expired

The pay-in failed because the card has expired.

101106

The card is inactive

The pay-in failed because the card is inactive according to the issuing bank.

101112

Maximum amount exceeded

The card has reached the amount limit set by the issuing bank.

101113

Maximum amount exceeded

The card has reached the amount limit set by the issuing bank.

101115

Debit limit exceeded

The spent amount limit set by the bank has been reached.

101116

Debit transaction frequency exceeded

The maximum number of authorized daily transactions has been exceeded.

101118

An initial transaction with the same card is still pending

The pay-in failed because another transaction with the same card is still pending.

101410

The card is not active

The card has been disabled on Mangopay and can no longer be used.

3D Secure

008511

The 3DS authentification has failed due to supplementary security checks

The pay-in failed due to supplementary security checks preventing 3DS authentication.

008515

Authentication not available: do not benefit from liability shift

3DSecure is not available on this transaction. Liability shift has been rejected by the issuing bank.

101301

SecureMode: 3DSecure authentication has failed

The 3DSecure authentication has failed.

101302

Secure mode: The card is not enrolled with 3DSecure

The 3DSecure feature is not enabled for this card.

101303

Secure mode: The card is not compatible with 3DSecure

The 3DSecure feature is not supported for this card.

101304

Secure mode: The 3DSecure authentication session has expired

The 3DSecure authentication session has expired.

101305

SecureMode: Soft decline

Strong customer authentication is required in order to be able to proceed to the payment due to soft decline.

101399

Secure mode: 3DSecure authentication is not available

The 3DSecure feature is not available.

Card preauthorization

001505

The PayIn DebitedFunds can’t be higher than the PreAuthorization remaining amount

The captured funds amount cannot be higher than the preauthorization remaining amount.

Web card pay-ins

001030

User has not been redirected

The pay-in failed because the user has not been redirected to the payment page.

001031

User canceled the payment

The pay-in failed because the user canceled the payment.

001032

User is filling in the payment card details

The user is still on the payment page.

001033

User has not been redirected then the payment session has expired

The pay-in failed because the user wasn’t redirected to the payment page.

001034

User has let the payment session expire without paying

The user has let the payment session expire.

101001

The user does not complete transaction

The user didn’t provide all the information.

101002

The transaction has been cancelled by the user

The transaction has been canceled by the end user.

Bank wire

101110

The payment has been refused

The bank transfer has been declined or canceled due to a bank wire issue.

Pay by Bank

206101

RedirectURL page embedded

The payment failed because the redirect URL is embedded in a page.

206102

RedirectURL already processed

The payment failed because the redirect URL has already been processed.

206103

Bank not supported

The payment failed because the selected bank is not supported.

206104

User not recognized

The payment failed because the user is not recognized by the bank.

206105

Authentication method not supported

The payment failed because the authentication method selected is not supported.

206106

Invalid user credentials

The payment failed due to invalid user credentials.

206107

Parallel session detected

The payment failed due to another session being open for the user.

206108

User blocked by bank

The payment failed because the user has been blocked by their bank.

206109

User denied by bank

The payment failed because the user is not authorized to perform this action.

Virtual IBAN

101025

The banking alias is not active

The pay-in to the ibanized wallet failed because the Banking Alias is not active.

Direct debit

001024

Author is not the Mandate owner

The pay-in failed because the author is not the mandate owner.

001801

The bank account has been closed

The bank account for the mandate has been closed.

001802

The bank details supplied were incorrect

The mandate cannot be created because the bank account is incorrect.

001803

Direct debit is not enabled for this bank account

The mandate cannot be created because direct debit is not supported for this bank account.

001804

The user has disputed the authorisation of the mandate

The pay-in failed because the user has contested the authorization of the mandate.

001805

The user has cancelled the mandate

The mandate has been canceled by the end user.

001806

The client has cancelled the mandate

The mandate has been canceled by the platform.

001807

User has let the mandate session expire without confirming

The mandate wasn’t confirmed and has expired

001830

There are insufficient funds in the bank account

The pay-in failed due to insufficient funds in the bank account.

001831

Contact the user

The pay-in failed for an unknown reason. The end user should be contacted.

001832

The payment has been cancelled

The pay-in failed because the end user canceled it.

001833

The Status of this Mandate does not allow for payments

The pay-in failed due to the status of the corresponding mandate.

001834

The user has disputed the payment

The user requested a chargeback for this payment.

001835

The mandate has expired

The pay-in failed because the corresponding mandate is expired.

001836

The mandate has been submitted to the user’s bank

The mandate has been submitted to the user’s bank.

Google Pay

105207

Invalid PaymentData

The PaymentData provided for the Google Pay pay-in is not valid

Klarna

202001

AdditionalData format error

The AdditionalData value is not the expected format, not complete, or not present.

PayPal

201001

PayPal account balance insufficient

The pay-in failed due to insufficient funds in the PayPal account.

201002

PayPal related payment instrument declined.

201003

PayPal transaction approval has expired

The pay-in failed because the PayPal account owner did not confirm the payment.

201004

PayPal account’s owner has not approved payment

The pay-in failed because the PayPal account owner rejected the payment.

201005

Shipping address is invalid

The shipping address is not valid.

201051

This transaction has been refused by PayPal risk

The transaction has been refused by PayPal risk.

201052

PayPal account is restricted

The PayPal account is restricted.

201053

PayPal account locked or closed

The PayPal account is locked or closed.

205001

Data validation error

One of the required parameters may be missing or invalid.

Refunds

001401

Transaction has already been successfully refunded

The transaction has already been successfully refunded.

001403

The transaction cannot be refunded (max 11 months)

The initial transaction occurred more than 11 months ago

001404

No more refunds can be created against this transaction

No more refunds can be created against this transaction.

001405

The initial transaction occured less than 7 days ago

A direct debit pay-in cannot be refunded within 7 calendar days of the pay-in CreationDate.

005403

The refund cannot exceed initial transaction amount

The amount of the refund exceeds the amount of the initial transaction.

005404

The refunded fees cannot exceed initial fee amount

The refund fees amount exceeds the initial transaction fees.

005405

Balance of client fee wallet unsufficient

The refund failed because the fees exceeds the balance of the Fees Wallet.

005406

Another refund for this transaction is still pending.

005407

Duplicated operation: you cannot reimburse the same amount more than once for a transaction during the same day.

The refund failed because the same amount as already been refunded in the last 24 hours for the initial transaction.

005408

Due to repudiations against this transaction, you can not refund this amount.

The refund failed because the pay-in is already being disputed.

Dispute settlement transfers

003010

The total DebitedFunds settled cannot exceed the initial transaction DebitedFunds available for settlement

The settlement transfer failed due to a debited funds Amount exceeding the debited funds of the initial transaction.

003011

The total Fees settled cannot exceed the initial transaction Fees available for settlement

The settlement transfer failed due to a fees Amount exceeding the fees of the initial transaction.

003012

The repudiation has already been successfully settled

The settlement transfer failed because the repudiation has already been settled.

FX conversions

004801

Conversion could not be debited from wallet

The funds could not be withdrawn from the debited wallet.

004802

Conversion failed during conversion operation

The funds could not be converted.

004803

Conversions while market is closed are not enabled. Contact your support to activate this feature.

The conversion failed because FX markets were closed and off-market trading is not enabled.

Risk management

008500

Transaction blocked by Fraud Policy

This payment does not comply with Mangopay’s anti-fraud rules.

008501

Transaction refused due to blocked Country

The payout cannot be performed because the target country is not authorized.

008502

Transaction refused due to blocked IBAN

The payout cannot be performed because the target IBAN bank account is blocked.

008503

Transaction refused due to blocked BIC

The payout cannot be performed because the target bank is not authorized.

008504

Amount of the transaction exceeded the amount permitted

The transaction amount exceeds the permitted amount.

008505

Number of accepted transactions exceeded the velocity limit set

Credit/debit cards are limited to 10 payments per day for security reasons.

008506

Unauthorized IP address country

The pay-in failed because the IP address is located in an unauthorized country.

008507

Cumulative value of transactions exceeded

The pay-in failed because the cumulative value of transactions is exceeded.

008600

Wallet blocked by Fraud policy

The wallet has been blocked because it doesn’t comply with Mangopay’s anti-fraud rules.

008700

User blocked by Fraud policy

The user has been blocked because of Mangopay’s anti-fraud rules.

008999

Suspicion of fraud

The transaction failed due to a suspicion of fraud.

008001

Counterfeit Card

The pay-in failed because the issuing bank declared the card as a counterfeit.

008002

Lost Card

The pay-in failed because the issuing bank declared the card as lost.

008003

Stolen Card

The pay-in failed because the issuing bank declared the card as stolen.

008004

Card bin not authorized

This card has been blocked by Mangopay’s Fraud team.

008005

Security violation

The card has been blocked due to abnormal behavior.

008006

Fraud suspected by the bank

The card has been blocked by the issuing bank due to abnormal behavior.

008007

Opposition on bank account (Temporary)

The card has temporarily been blocked on Mangopay’s side.

008008

Pay-in failed: the issuing bank reports that the bank account linked to this card does not exist.

The issuer indicates the account linked to this card no longer exists, perhaps because it has been closed.

008508

Unauthorized Card issuer country

The card issuer is domiciled in an unauthorized country.

008509

Number of bank cards allowed is exceeded

The number of cards allowed is exceeded.

008510

Number of clients per card is exceeded

The number of clients per card is exceeded.

008512

IP location different than card issuer country

The IP location is different from the country the card issuer is domiciled in.

008513

Number of device fingerprints allowed is exceeded

The pay-in failed because the number of cards for this fingerprint is exceeded.

008514

Unauthorized Card BIN

The card BIN is not authorized.

008516

Transaction refused due to blocked GB account

The payout cannot be performed because the target GB bank account is blocked.

008517

Transaction refused due to blocked US account

The payout cannot be performed because the target US bank account is blocked.

008518

Transaction refused due to blocked CA account

The payout cannot be performed because the target CA bank account is blocked.

008519

Transaction refused due to blocked OTHER account

The payout cannot be performed because the target OTHER bank account is blocked.

Payouts

101119

Invalid or missing bank details

The payout cannot be performed due to missing or invalid banking information.

121001

The bank wire has been refused

The bank wire has been refused by Mangopay or canceled by the end user.

121002

The author is not the wallet owner

The payout author is not the corresponding wallet owner.

121003

Insufficient wallet balance

The wallet does not contain enough funds to process the payout.

121004

Specific case: please contact our Finance Team

The payout failed due to a specific issue.

121005

Refused due to the Fraud Policy

The payout failed because it didn’t comply with Mangopay anti-fraud rules.

121006

The associated bank account is not active

The bank account targeted by the payout is inactive.

121007

The author is not the bank account owner

The payout author is not the corresponding bank account owner.

121009

Payout expired before processing

The payout request expired before it could be processed.

121010

Remitter or beneficiary identified as requiring further analysis

The payout was refused because further analysis of the payout author or bank account owner is required following routine screening.

121012

Inapproriate bank account type used

The payout has been rejected by Mangopay’s team because the bank account is not of the correct type.

121019

Payout refused because the bank account address is formatted as an unstructured string in AddressLine1 (created via an API v2 endpoint). Re-register as a Recipient and try again.

The BankAccountId used was registered on a legacy API v2 endpoint, so the address is a single string containing the full address including city, postal code, and country. The external account must be re-registered with a structured address format.

121999

Generic withdrawal error

Generic withdrawal error.

SCA via Recipients

121018

This payout uses a non-SCA compliant bank account. Please create via the recipient endpoint and try again.

The payout failed because the linked Bank Account object was created after April 30, 2026.

Verification of Payee (VOP)

121030

Verification of Payee failed: account name and IBAN do not match. Please provide matching details to proceed with the payout

The payout failed because the result of the Verification of Payee (VOP) was NO_MATCH or MATCH_NOT_POSSIBLE and the VOP amendment is not signed

Instant payments

130001

The client’s settings are incorrectly configured for instant payout

The Instant Payment feature is not activated for the platform.

130002

The amount requested is greater than the authorised amount

The payout failed because the requested amount is higher than the authorized amount.

130003

The user is not KYC-validated

The Instant Payment has been refused because the user is not verified.

130004

The user is blocked by Fraud policy

The instant payment is refused because the user has been blocked by Mangopay’s policy.

130005

One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.

130006

technical error, please try again later

A technical error occurred.

130007

Destination Bank is not reachable

The bank to which the payout is made is not reachable.

130008

Duplicate transaction identified

An instant payment has already been made to the same bank account for the same amount in the last 24 hours.

130009

The destination IBAN is not valid

The payout failed because the IBAN of the bank account is not valid.

130010

Generic operation error

130011

Manual review required - not compatible with payout mode requested

A manual review is required for this payout, so the INSTANT_PAYMENT_ONLY value for PayoutModeRequested cannot be processed.