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.

Note - Categories are indicative

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

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

User category

002701

Refused due to author’s UserCategory: PAYER
The action was refused because the user is a Payer, not an Owner.

User verification

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 has been refused refused because the 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.

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
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.

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

101109

The payment period has expired
The bank wire pay-in has expired.

101110

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

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
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.

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.
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.

121999

Generic withdrawal error
Generic withdrawal error.

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.
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
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.

Reports

805001

There was an error validating your report request
The report couldn’t be validated.

809001

There was an error executing your report request
The report couldn’t be executed.