All error codes
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.
Card-related
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.
Bank-related
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.
Was this page helpful?