Tip from SmartRetry For card declines, segment by issuer country and decline reason, then test routing and 3DS triggers only on the segments with the highest decline concentration.
Adyen
Methods
- Cards
- Digital Wallets
- Bank Transfer
- Buy Now Pay Later
- Cryptocurrencies
Adyen is a global payment provider used by merchants to accept cards and local payment methods online and in-store.
Struggling with your approval ratio for this payment provider?
contact SmartRetry team →- Published
- Last updated
2 min
Proceed payment with
About Adyen
Product Type
Payment Processor
Foundation
2006
Stock ID
EURONEXT:ADYEN
Company Type
public
Employees
10,000+
Location
NLDChannel
Online In person
For developers
Features
Global acceptance & local payment methods
Supports major card schemes and a wide range of local payment methods for cross-border selling and localized checkout.
Unified online and in-store payments
Designed for omnichannel businesses that want consistent payment operations across ecommerce, mobile, and POS environments.
Authorization performance signals
Provides reporting to help monitor authorization success and investigate card declines by issuer, country, channel, or payment method.
Authentication & SCA support
Tools for 3D Secure and strong customer authentication flows to balance compliance needs with customer experience.
Risk management & fraud controls
Risk rules and monitoring options to help reduce fraud while managing false positives and conversion impact.
Disputes and chargeback handling
Workflows and reporting to track disputes, respond with evidence, and analyze chargeback drivers over time.
Security and compliance
Security and compliance features aimed at protecting payment data and supporting common regulatory requirements.
Reliability and operational tooling
Operational dashboards, logs, and status visibility to support incident response and payment performance monitoring.
Currencies
Processing currencies USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY, SGD, HKD, INR, BRL
Available in
Available countries
- 🌍Global
FAQ
Adyen is a payment provider/PSP that also offers acquiring in many markets; in some cases you may use Adyen with other acquiring or local partners depending on region and method.
Start by reviewing decline reasons and issuer patterns, confirm accurate transaction and customer data, and evaluate authentication strategy (for example, when to apply 3DS) by region and card type.
Compare declines by BIN/issuer, country, channel (web/app/in-store), and recent changes (descriptor, 3DS settings, risk rules, routing). Also confirm there are no outages or integration errors.
Yes. Adyen supports 3D Secure flows and provides options to help merchants meet SCA needs, with configuration varying by region and use case.
Yes. Many merchants use Adyen for ecommerce and in-store payments to unify reporting and operations, subject to supported terminals and regions.
Adyen provides dispute notifications, evidence submission workflows, and reporting so teams can track outcomes and improve dispute prevention.
Adyen operates globally, but onboarding, supported payment methods, and acquiring availability can vary by business model, risk profile, and region.
Statuses
| Code | Description | Level | Frequency | Resolution |
|---|---|---|---|---|
| Refusal Codes | ||||
| 0 | Authorised (No Refusal) refusalReasonCode 0 is sometimes returned alongside resultCode Authorised. When this occurs, the refusal reason code should be ignored "" the transaction succeeded. | Approved, Info | Occasional | T0 |
| 2 | Refused The transaction was refused by the issuer or acquirer without a more specific reason provided. | Declined | Common | T2 |
| 3 | Referral The transaction requires a referral. The issuer is requesting manual review or voice authorization before proceeding. | Declined, Processing | Occasional | T2 |
| 4 | Acquirer Error The transaction did not go through due to an error on the acquirer's end. This is not a shopper-side issue; it is an infrastructure or connectivity problem at the acquiring bank. | Error | Occasional | T1 |
| 5 | Blocked Card The card used for the transaction is blocked and therefore unusable. The shopper should contact their issuing bank to unblock or replace the card. | Declined | Occasional | T2 |
| 6 | Expired Card The card used for the transaction has expired and is therefore unusable. The shopper should use a different, valid card. | Declined | Common | T3 |
| 7 | Invalid Amount An amount mismatch occurred during the transaction process. The amount submitted does not match what is expected by the issuer or scheme. | Error, Declined | Occasional | T0 |
| 8 | Invalid Card Number The specified card number is incorrect or invalid. The shopper should check and re-enter their card details. | Declined | Common | T0 |
| 9 | Issuer Unavailable It is not possible to contact the shopper's bank to authorize the transaction. This is typically a temporary connectivity issue. | Error | Occasional | T0 |
| 10 | Not Supported The shopper's bank does not support or does not allow this type of transaction. The shopper should try a different payment method or contact their bank. | Declined | Occasional | T3 |
| 11 | 3D Not Authenticated 3D Secure authentication was not executed or did not complete successfully. The transaction was declined due to a failed or missing authentication step. | Declined, Error | Occasional | T0 |
| 12 | Not Enough Balance The card does not have sufficient funds to cover the payable amount. The shopper should use a different card or payment method. | Declined | Common | T3 |
| 14 | Acquirer Fraud The transaction was flagged as possible fraud by the acquirer. The payment was declined as a precautionary measure. | Declined, Error | Occasional | T1 |
| 15 | Cancelled The transaction was cancelled. This corresponds to the Cancelled payment status when a cancellation is submitted. | Declined | Occasional | T0 |
| 16 | Shopper Cancelled The shopper cancelled the transaction before completing it. No funds were charged. | Declined | Common | T0 |
| 17 | Invalid Pin The specified PIN is incorrect or invalid. The shopper should re-enter the correct PIN. | Declined | Occasional | T0 |
| 18 | Pin Tries Exceeded The shopper entered an incorrect PIN more than three times in a row. The card may now be blocked. The shopper should contact their issuing bank. | Declined | Occasional | T2 |
| 19 | Pin Validation Not Possible It is not possible to validate the specified PIN number. This may indicate a technical issue with PIN processing. | Error, Declined | Rare | T1 |
| 20 | FRAUD Pre-authorization risk checks resulted in a fraud score of 100 or more. The transaction was flagged as fraudulent and refused. Review your risk settings if this is unexpected. | Declined, Error | Occasional | T1 |
| 21 | Not Submitted The transaction was not submitted correctly for processing. Verify the payment request structure and parameters. | Error | Occasional | T0 |
| 22 | FRAUD-CANCELLED The combined sum of pre-authorization and post-authorization risk checks resulted in a fraud score of 100 or more. The transaction was flagged as fraudulent and refused. | Declined, Error | Occasional | T1 |
| 23 | Transaction Not Permitted The transaction is not permitted to the issuer/cardholder, not allowed for this merchant, or not permitted to the acquirer/terminal. Maps to issuer decline codes 57 and 58. | Declined | Occasional | T3 |
| 24 | CVC Declined The specified CVC (card security code / CVV / CID) is invalid. The shopper should re-enter the correct CVC from the back of their card. | Declined | Common | T0 |
| 25 | Restricted Card The card is restricted. Maps to issuer decline codes for restricted cards or cards invalid in a given country. The shopper should contact their bank or use a different card. | Declined | Occasional | T2 |
| 26 | Revocation Of Auth The shopper requested to stop a recurring subscription. Maps to issuer codes R0 (Stop Payment Order), R1 (Revocation of Authorization Order), and R3 (Revocation of All Authorizations Order). | Declined | Occasional | T3 |
| 27 | Declined Non Generic Maps all response codes that cannot be reliably mapped to a specific reason. Used to distinguish generic declines (e.g., Mastercard '05: Do not honor') from more specific refusal reasons. | Declined | Common | T2 |
| 28 | Withdrawal Amount Exceeded The transaction amount was higher than the withdrawal amount permitted for the shopper's card. The shopper should contact their bank or use a different card. | Declined | Occasional | T2 |
| 29 | Withdrawal Count Exceeded The shopper exceeded the number of withdrawals permitted on their card. The shopper should contact their bank or wait until the limit resets. | Declined | Occasional | T2 |
| 31 | Issuer Suspected Fraud The issuer reported the transaction as suspected fraud. The shopper should contact their issuing bank to resolve. | Declined, Error | Occasional | T2 |
| 32 | AVS Declined The address data the shopper entered does not match the address on file with the card issuer. The shopper should verify their billing address. | Declined | Occasional | T0 |
| 33 | Card Requires Online Pin The shopper's bank requires the shopper to enter a PIN to complete this transaction. The shopper should proceed with PIN entry. | Declined, Processing | Rare | T0 |
| 34 | No Checking Account Available On Card The shopper's bank requires a checking account to complete the purchase, but none is available on the card. The shopper should use a different payment method. | Declined | Rare | T3 |
| 35 | No Savings Account Available On Card The shopper's bank requires a savings account to complete the purchase, but none is available on the card. The shopper should use a different payment method. | Declined | Rare | T3 |
| 36 | Mobile Pin Required The shopper's bank requires the shopper to enter a mobile PIN to authorize the transaction. | Declined, Processing | Rare | T0 |
| 37 | Contactless Fallback The shopper abandoned the transaction after attempting a contactless payment and being prompted to try a different card entry method (PIN or swipe). | Declined | Occasional | T0 |
| 38 | Authentication Required The issuer declined the authentication exemption request and requires full 3D Secure authentication for this transaction. Retry the payment with 3D Secure enabled. | Declined | Occasional | T0 |
| 39 | RReq Not Received From DS The issuer or scheme was unable to communicate the authentication outcome via RReq (Results Request message in 3D Secure 2). Retry the transaction. | Error, Declined | Rare | T0 |
| 40 | Current AID Is In Penalty Box The payment network cannot be reached for the current Application Identifier (AID). Retry the transaction with a different payment method. | Error, Declined | Rare | T1 |
| 41 | CVM Required Restart Payment A PIN or signature is required to complete the transaction. The shopper should retry the transaction providing the required cardholder verification method. | Declined, Processing | Rare | T0 |
| 42 | 3DS Authentication Error 3D Secure authentication failed due to an issue at the card network or issuer level. Retry the transaction, or retry with a different payment method. | Error, Declined | Occasional | T0 |
| 46 | Transaction Blocked By Adyen To Prevent Excessive Retry Fees Adyen's excessive retry prevention service blocked the transaction to protect the merchant from penalty fees charged by card schemes for excessive retries of declined transactions. | Declined, Info | Occasional | T1 |
| 50 | Token Revoked The token granted to the merchant for recurring charges was disabled by the shopper. The shopper has revoked consent for future charges using this token. | Declined | Occasional | T3 |
| Result Codes | ||||
| AuthenticationFinished | Authentication Finished The payment has been successfully authenticated with 3D Secure 2. Collect the 3D Secure 2 authentication data needed to authorize the payment. | Approved | Occasional | T0 |
| AuthenticationNotRequired | Authentication Not Required The transaction does not require 3D Secure 2 authentication. Check the authenticationNotRequiredReason field to learn why authentication was not required. | Info | Occasional | T0 |
| Authorised | Authorised The payment was successfully authorised. Inform the shopper that the payment was successful. A webhook with an updated payment status will also be sent. | Approved | Common | T0 |
| Cancelled | Cancelled The payment was cancelled (by either the shopper or your own system) before processing was completed. | Declined | Common | T0 |
| ChallengeShopper | Challenge Shopper The issuer requires authentication from the shopper, for example through facial recognition or entering a code received on their phone. Initiate the challenge flow to present the challenge to the shopper. | Processing | Occasional | T0 |
| Error | Error There was an error when the payment was being processed. Inform the shopper that there was an error processing their payment. | Error | Occasional | T0 |
| IdentifyShopper | Identify Shopper The issuer requires authentication from the device the shopper is using. Initiate the frictionless flow to get the shopper device fingerprint and submit the result to Adyen. | Processing | Occasional | T0 |
| PartiallyAuthorised | Partially Authorised The payment was authorized for a partial amount. This happens when the cardholder has insufficient funds. The merchant can start a new transaction for the outstanding balance, cancel, capture the partial amount, or retry later for recurring. | Approved, Processing | Occasional | T0 |
| Pending | Pending The payment order was successfully received but the final status of the payment is not available yet. Common for payment methods with an asynchronous flow. | Processing | Occasional | T0 |
| PresentToShopper | Present To Shopper Additional information needs to be presented to the shopper so they can use it to complete the payment, for example a voucher. Present the voucher and inform the shopper to complete the payment. | Processing, Info | Occasional | T0 |
| Received | Received The payment request was successfully received by Adyen and will be processed. This is the initial state for all payments. | Processing, Info | Common | T0 |
| RedirectShopper | Redirect Shopper The issuer requires the shopper to provide authentication in an external web page or app. Redirect the shopper to complete the authentication. | Processing | Occasional | T0 |
| Refused | Refused The payment was refused. Inform the shopper that their payment was refused and ask them to try the payment again using a different payment method or card. A refusalReason will indicate the cause of the error. | Declined | Common | T2 |
| Error Codes | ||||
| 000 | Multiple Messages Generic error with multiple possible causes: incorrect API key or auth credentials, or unable to parse the message body. | Error | Occasional | T0 |
| 6_012 | Tokenization Request Timed Out The tokenization request timed out. | Error | Occasional | T0 |
| 010 | Not Allowed The API credential is missing required roles, the user API is incorrect, or you are making a third-party payment/card acquisition request without the required permissions. | Error | Occasional | T1 |
| 14_002 | Payment Data Not Provided paymentData has not been provided in the request. | Error | Occasional | T0 |
| 14_003 | Invalid Payment Data The paymentData provided is invalid. | Error | Occasional | T0 |
| 14_004 | Missing Payment Method Details Payment method details are missing from the request. | Error | Occasional | T0 |
| 14_005 | Invalid Payment Method Details Payment method details are invalid. The recurring contract on a token may be missing; for example, a payment method only supports RECURRING but a ONECLICK contract is being used. | Error | Occasional | T0 |
| 14_006 | Payment Method Object Not Provided The paymentMethod object has not been provided in the request. | Error | Occasional | T0 |
| 14_007 | Invalid Payment Method Data There is an error with information in the paymentMethod object, for example paymentMethod.type is missing. | Error | Occasional | T0 |
| 14_008 | Session Has Expired The checkout session has expired. | Error | Common | T0 |
| 14_010 | SDK Version Not Provided For Web Channel The request contains no sdkVersion although the channel is set to Web. | Error | Occasional | T0 |
| 14_011 | Channel Conflicts With Provided Parameters The provided channel conflicts with the provided parameters. Provide the correct token for iOS/Android, or sdkVersion for Web — not both. | Error | Occasional | T0 |
| 14_012 | SDK Token Could Not Be Parsed The provided SDK token could not be parsed. | Error | Occasional | T0 |
| 14_013 | Origin Required For HTML Response For an HTML response, origin must be provided. | Error | Occasional | T0 |
| 14_014 | Endpoint Requires Version This endpoint requires the version to be specified. | Error | Occasional | T0 |
| 14_015 | Token Is Missing The token is missing from the request. | Error | Occasional | T0 |
| 14_016 | Invalid SDK Version The sdkVersion provided is invalid. | Error | Occasional | T0 |
| 14_017 | SDK Token Has Invalid Timestamp The provided SDK Token has an invalid timestamp. | Error | Occasional | T0 |
| 14_018 | Invalid Payload The payload provided is invalid. | Error | Occasional | T0 |
| 14_019 | Request Missing SDK Version And Token The request does not contain sdkVersion or token. | Error | Occasional | T0 |
| 14_020 | No Issuer Selected No issuer was selected for this payment. | Error | Occasional | T0 |
| 14_022 | Missing Unique Terminal ID The uniqueTerminalId is missing from the request. | Error | Occasional | T0 |
| 14_023 | Installments Not Configured In Setup Request Installments were not configured in the setup request. | Error | Occasional | T0 |
| 14_024 | Invalid Open Invoice Request The open invoice request is invalid. | Error | Occasional | T0 |
| 14_026 | Invalid Selected Flow The selected flow is invalid. | Error | Occasional | T0 |
| 14_027 | Invalid Return URL Query String The provided returnUrlQueryString is invalid. | Error | Occasional | T0 |
| 14_028 | 3D Auth Data Incomplete 3D Auth Data is incomplete. Provide both PaRes and MD fields. | Error | Occasional | T0 |
| 14_029 | CVC Required But Not Provided CVC is required for this payment but was not provided. | Error | Occasional | T0 |
| 14_030 | Return URL Is Missing The return URL is missing from the request. | Error | Occasional | T0 |
| 14_031 | Bank Account Is Missing The bank account is missing from the request. | Error | Occasional | T0 |
| 14_032 | Provide Fingerprint Or Challenge Result Provide either threeds2.fingerprint or threeds2.challengeResult, not both. | Error | Occasional | T0 |
| 14_033 | Provided Fingerprint Is Invalid The provided fingerprint is invalid. | Error | Occasional | T0 |
| 14_034 | Provided Fingerprint Is Invalid For Field The provided fingerprint is invalid for the specified field. If the affected field is threeDSCompIn, the device fingerprint is not being forwarded to the /payments/details API call. | Error | Occasional | T0 |
| 14_035 | Origin Or Notification URL Required Either origin or notificationURL must be provided. | Error | Occasional | T0 |
| 14_036 | Missing Required Field Channel The required field channel is missing from the request. | Error | Occasional | T0 |
| 14_037 | Invalid Order Data The provided orderData is invalid. | Error | Occasional | T0 |
| 14_0378 | Invalid Recurring Expiry Format The recurringExpiry format is invalid. Required format: yyyy-MM-dd'T'HH:mm:ssX, e.g. 2019-12-31T23:59:59+02:00. | Error | Occasional | T0 |
| 14_0379 | Expiry At Exceeds Maximum Allowed Date The expiresAt value is greater than the maximum allowed date. | Error | Occasional | T0 |
| 14_0380 | Payment Data And MD Belong To Different Requests PaymentData and MD belong to different requests. Submit the correct MD. | Error | Occasional | T0 |
| 14_0381 | Missing Or Invalid Client Key Or Origin Key The clientKey or originKey is missing or invalid. | Error | Occasional | T0 |
| 14_0382 | Missing Or Invalid Checkout Attempt ID The checkoutAttemptId is missing or invalid. | Error | Occasional | T0 |
| 14_0383 | Missing Or Invalid Shopper Stage The shopperStage is missing or invalid. | Error | Occasional | T0 |
| 14_0384 | Missing Or Invalid Details For Shopper Stage The details provided for the shopperStage are missing or invalid. | Error | Occasional | T0 |
| 14_0385 | Payment Link Expired The payment link has expired. | Error, Declined | Occasional | T0 |
| 14_0386 | Hosted Session Expired The hosted session has expired. | Error | Occasional | T0 |
| 14_0387 | Payment Link Already Paid The payment link has already been paid. | Info | Rare | T0 |
| 14_0388 | Description Too Long The description field is too long. | Error | Occasional | T0 |
| 14_0389 | POS To PayByLink QR Code Expired The POS to PayByLink QR Code has expired. | Error | Occasional | T0 |
| 14_0390 | Missing Required Field Redirect Result The required field redirectResult is missing from the request. | Error | Occasional | T0 |
| 14_0391 | Invalid Redirect Result The provided redirectResult is invalid. The returnUrl format may be incorrect for the applicable channel (web, iOS, or Android). | Error | Occasional | T0 |
| 14_0392 | Payment Details Incomplete PaRes And MD Payment details are incomplete. Provide both PaRes and MD (authentication-only flow). | Error | Occasional | T0 |
| 14_0393 | Invalid Storing Method Type The storingMethod.type value is invalid. | Error | Occasional | T0 |
| 14_0394 | Recurring Processing Model Not Provided The required recurringProcessingModel is not provided. Include it when creating a token or using stored payment details. | Error | Occasional | T0 |
| 14_0395 | Storing Method Incomplete The storing method is incomplete. | Error | Occasional | T0 |
| 14_0396 | Push Account Receipt Invalid The push account receipt is invalid. | Error | Occasional | T0 |
| 14_0397 | Order Data Expired The order data has expired. | Error | Occasional | T0 |
| 14_0398 | Order Data No Access To Merchant Account The order data does not have access to the specified merchant account. | Error | Occasional | T0 |
| 14_0399 | Invalid Push Account Data Field The pushAccountData field is invalid. | Error | Occasional | T0 |
| 14_0400 | Provisioning Request Declined The provisioning request was declined. | Error, Declined | Occasional | T0 |
| 14_0401 | 3DS2 Payment Authentication Failed Authentication of a 3DS2 payment has failed. | Error, Declined | Occasional | T0 |
| 14_0402 | Missing 3DS2 Fingerprint The 3DS2 fingerprint is missing from the request. | Error | Occasional | T0 |
| 14_0403 | Missing Delegated Authentication Result The delegated authentication result is missing from the request. | Error | Occasional | T0 |
| 14_0404 | Client Data Not Allowed During Payment Link Creation Client data is not allowed to be passed during payment link creation. | Error | Occasional | T0 |
| 14_0405 | Donation Token Or Original PSP Reference Missing The donation token, donation original PSP reference, or both are missing. | Error | Rare | T0 |
| 14_0406 | Parent PSP Reference Missing For Donation The parent PSP reference is missing for the donation. | Error | Rare | T0 |
| 14_0407 | Missing Donation Account The required field donationAccount is missing. | Error | Rare | T0 |
| 14_0408 | No Payment Methods Available There are no payment methods available for the given parameters. | Error | Occasional | T0 |
| 14_0410 | Unable To Generate 3DS Redirect URL Unable to generate a redirect URL for the 3DS transaction. | Error | Occasional | T1 |
| 14_0411 | Gift Card Has Zero Balance The gift card provided for the order has 0 balance. | Error, Declined | Rare | T3 |
| 14_0412 | Payment Method Type Required For Non-Recurring The field paymentMethod.type is required for non-recurring payments. | Error | Occasional | T0 |
| 14_0413 | Payment Method Type Not Retrievable From Recurring Details The paymentMethod.type could not be retrieved from recurring details. | Error | Occasional | T0 |
| 14_0414 | Invalid 3DS2 Result The provided 3DS2 result is invalid. | Error | Occasional | T0 |
| 14_0415 | Missing Required Field Three DS Result The required field threeDSResult is missing. | Error | Occasional | T0 |
| 14_0416 | Unable To Retrieve Package Weight Unable to retrieve the total weight of a package. | Error | Rare | T0 |
| 14_0417 | Carbon Credit Project ID Not Configured The carbon credit project ID is not configured. | Error | Rare | T1 |
| 14_0418 | Invalid Terminal Response Or Missing Parameters Invalid response from the terminal or missing parameters. | Error | Occasional | T0 |
| 14_0419 | Donation Token Expired The donation token has expired. | Error | Rare | T0 |
| 14_0420 | Conflicting Installment Options Both installmentOptions.values and installmentOptions.maxValue cannot be specified in the same request. | Error | Rare | T0 |
| 14_0421 | Invalid Platform For Voucher Pass The platform specified for the Voucher Pass is invalid. | Error | Rare | T0 |
| 14_0422 | Invalid Session Identifier Or Data The provided session identifier or data is invalid. | Error | Occasional | T0 |
| 14_0423 | Session Expired The session has expired. | Error | Occasional | T0 |
| 14_0424 | Product Has Negative Quantity A product in the order has a negative quantity. | Error | Occasional | T0 |
| 14_0425 | Terminal Not Found The terminal with the specified uniqueTerminalId was not found. | Error | Occasional | T0 |
| 14_0426 | Terminal Not Deployed The terminal with the specified uniqueTerminalId is not deployed. | Error | Occasional | T1 |
| 14_0427 | Insufficient Permissions For Terminal Insufficient permissions for the terminal with the specified uniqueTerminalId. | Error | Occasional | T1 |
| 14_0428 | Merchant Account Missing Pay By Link Permissions The merchant account is missing Pay by Link permission(s). | Error | Occasional | T1 |
| 14_0429 | Donations Not Supported For Payment Method Donations are not supported for this payment method. | Error | Occasional | T0 |
| 14_0430 | Merchant Unknown The provided merchant is unknown. | Error | Occasional | T1 |
| 14_0431 | Unknown Terminal The terminal is unknown. | Error | Occasional | T0 |
| 14_0432 | Unknown Terminal (Duplicate) The terminal is unknown (secondary occurrence of code 14_0431). | Error | Occasional | T0 |
| 14_0433 | Theme And Terms Of Service Must Be Configured A theme and terms of service must be configured to send emails to the shopper. | Error | Rare | T1 |
| 14_0434 | Internal Error Sending Link To Shopper An internal error occurred when sending the link to the shopper. | Error | Rare | T1 |
| 14_0435 | Theme Name Already In Use The theme name is already in use. | Error | Rare | T0 |
| 14_0436 | Field Too Long The specified field is too long. | Error | Occasional | T0 |
| 14_0438 | Default Theme Must Be Configured A default theme must be configured for the account. | Error | Rare | T1 |
| 14_0439 | Cannot Delete Default Theme This theme is the default. Select another default theme before deleting it. | Error | Rare | T0 |
| 14_0444 | No Terms And Conditions Configured No terms and conditions were configured for this account. | Error | Rare | T1 |
| 14_0445 | Specified Theme Does Not Exist The specified theme does not exist. | Error | Occasional | T0 |
| 14_0446 | File Must Be Valid JPG Image The file specified for the field must be a valid JPG/JPEG image. | Error | Occasional | T0 |
| 14_0447 | No BIN Or Encrypted BIN Provided Neither bin nor encryptedBin was provided in the request. | Error | Occasional | T0 |
| 14_0448 | Payment Data And MD From Different Payments The provided paymentData and MD do not belong to the same payment. | Error | Occasional | T0 |
| 14_0449 | Field Not Supported For Mode The specified field is not supported when the request is in the given mode. | Error | Occasional | T0 |
| 14_0450 | Session In Invalid State The provided request cannot be processed as the session is in an invalid state. | Error | Occasional | T0 |
| 14_0451 | Subset Of Options Not Specified For Field A subset of options was not specified for the field. | Error | Occasional | T0 |
| 14_0452 | Subset Of Options Specified But All Selected A subset of options was specified for the field but all options were selected. | Error | Occasional | T0 |
| 14_0453 | No Options Expected For Empty Fill Mode No options are expected when fillMode is empty for the field. | Error | Occasional | T0 |
| 14_0454 | Options Mode Not Specified The options mode was not specified for the field. | Error | Occasional | T0 |
| 14_0455 | Field Fill Mode Must Be Mandatory The fill mode of the field must be mandatory. | Error | Occasional | T0 |
| 14_0456 | Invalid Country Code The provided country code is invalid. | Error | Occasional | T0 |
| 14_0457 | Options Mode Should Be Subset The options mode for the specified field should be subset. | Error | Occasional | T0 |
| 14_0458 | Flexible Validity Field Should Not Contain Quantity Or Unit A field with flexible validity should not contain quantity or unit. | Error | Occasional | T0 |
| 14_0459 | Fixed Validity Field Should Contain Quantity And Unit A field with fixed validity should contain both quantity and unit. | Error | Occasional | T0 |
| 14_0460 | Invalid Redirect Data The provided redirect data is invalid. | Error | Occasional | T0 |
| 14_0461 | Invalid Redirect ID The provided redirectId is invalid. | Error | Occasional | T0 |
| 14_0462 | Invalid Return Query String The provided return query string is invalid. | Error | Occasional | T0 |
| 14_0463 | Invalid Recurring Processing Model The recurringProcessingModel field is invalid. | Error | Occasional | T0 |
| 14_0464 | Session ID In Return URL Mismatch The provided request cannot be processed as the sessionID in the returnURL is different from the current sessionID. | Error | Occasional | T0 |
| 14_0465 | Missing Or Invalid Session ID The field sessionId is missing or invalid. | Error | Occasional | T0 |
| 14_0466 | Invalid Session ID The sessionId field is invalid. | Error | Occasional | T0 |
| 14_0467 | Missing Or Invalid Forward URL The field Forward-Url is missing or invalid. | Error | Occasional | T0 |
| 14_0468 | Metadata Value Size Exceeds Limit The metadata value size exceeds the allowed limit. | Error | Occasional | T0 |
| 14_0469 | Option Not Supported For New Shopper Field The option is not supported for the new shopper field. | Error | Occasional | T0 |
| 14_0470 | Payment Method Data Contains Raw And Encrypted Card Details The paymentMethodData is invalid because it contains both raw and encrypted card details. | Error | Occasional | T0 |
| 14_0471 | Expire After Refusal Field Not Allowed The field expireAfterRefusal is not allowed in this context. | Error | Occasional | T0 |
| 14_0472 | QR Code Expires At Exceeds Maximum Allowed Date The qrCodeExpiresAt value is greater than the maximum allowed date. | Error | Occasional | T0 |
| 14_0473 | Details Expired The details have expired. | Error | Occasional | T0 |
| 14_0474 | Klarna Line Items Tax Or Amount Fields Invalid Klarna lineItems fields taxAmount and amountExcludingTax are missing or not valid. | Error | Occasional | T0 |
| 14_0475 | MOTO Not Allowed Due To PCI Regulations The shopperInteraction MOTO cannot be processed because PCI compliance of the MOTO integration has not been validated. Contact Support to enable. | Error | Occasional | T1 |
| 14_0476 | Amount Value Below Original Request The amount.value cannot be less than the amount.value of the original request. | Error | Occasional | T0 |
| 14_0477 | Not Allowed To Update Shipping Address The user is not allowed to update the shipping address. | Error | Occasional | T0 |
| 14_0478 | Delivery Method Amount Mismatch The sum of the selected deliveryMethod amount and original offer amount does not match the total amount. | Error | Occasional | T0 |
| 14_0479 | Only One Delivery Method Should Be Selected Only 1 deliveryMethod should be selected. | Error | Occasional | T0 |
| 14_0480 | Order Can Only Be Updated If Payment Is Pending The order can only be updated if the payment is still pending. | Error | Occasional | T0 |
| 14_0481 | Amount Currency Does Not Match Original Request The amount.currency provided in the request does not match the amount.currency of the original request. | Error | Occasional | T0 |
| 14_0482 | Invalid Return URL Parameter The returnUrl parameter is invalid. | Error | Occasional | T0 |
| 14_0483 | Invalid Session Result Field The sessionResult field is invalid. | Error | Occasional | T0 |
| 14_0484 | Missing UPI ID Or VPA The required field UPI ID / VPA is missing. | Error | Occasional | T0 |
| 14_0485 | Missing Exchange Rate Token The exchange rate token is missing from the request. | Error | Occasional | T0 |
| 14_0486 | Invalid Exchange Rate Token The exchange rate token is invalid. | Error | Occasional | T0 |
| 14_0487 | Exchange Rate Expired The exchange rate has expired. | Error | Occasional | T0 |
| 14_0488 | Missing Shopper Tax ID The required field shopperTaxInfo.taxId is missing. | Error | Occasional | T0 |
| 14_0489 | Invalid Shopper Tax ID Field The field shopperTaxInfo.taxId is invalid. | Error | Occasional | T0 |
| 14_0490 | Transaction Amount Exceeds Maximum Allowed The transaction amount exceeds the maximum allowed amount. | Error, Declined | Occasional | T2 |
| 14_0491 | Conflicting Data In Request Fields And SDK Data Conflicting data was found on request fields and the sdkData field. | Error | Occasional | T0 |
| 14_0492 | Invalid Tax ID Type For Merchant The tax-id type is invalid for the merchant. | Error | Occasional | T0 |
| 14_0493 | UPI Collect On Android No Longer Supported UPI Collect transactions using Android are no longer supported. Use UPI Intent or UPI QR instead. | Error | Occasional | T0 |
| 14_0494 | Encrypted Card Details In Payment Method Invalid The encrypted card details in paymentMethod are invalid. | Error | Occasional | T0 |
| 15_002 | 3DS2 Required Field Missing For Device Channel A required field is missing for the specified device channel. | Error | Occasional | T0 |
| 15_003 | 3DS2 Field Should Not Be Present For Device Channel A field should not be present for the specified device channel. | Error | Occasional | T0 |
| 15_004 | 3DS2 Invalid Value In Field An invalid value was provided in the specified field. | Error | Occasional | T0 |
| 15_005 | 3DS2 Unexpected Field An unexpected field was included in the request. | Error | Occasional | T0 |
| 15_006 | 3DS2 Message Category Shall Be Present The messageCategory field shall be present in the request. | Error | Occasional | T0 |
| 15_007 | 3DS2 Field Value Too Long The value of the specified field exceeds the maximum allowed length. | Error | Occasional | T0 |
| 15_008 | Invalid Merchant Configuration For 3DS 2.0 The merchant configuration for 3DS 2.0 is invalid. | Error | Occasional | T1 |
| 15_009 | Three DS2 Token Required The threeDS2Token is required. | Error | Occasional | T0 |
| 15_010 | Invalid Device Channel Value Invalid deviceChannel value. Must be app, browser, or TRI. | Error | Occasional | T0 |
| 15_011 | PSP Reference Not Valid The pspReference is not a valid pspReference. | Error | Occasional | T0 |
| 15_012 | 3DS2 Result Not Present The 3DS2 result is not present. | Error | Occasional | T0 |
| 15_013 | Cannot Add 3DS2 Authentication Values Cannot add 3DS2 authentication values because addRawThreeDSecureDetailsResult is not enabled. | Error | Rare | T1 |
| 15_014 | Invalid Three DS2 Token The threeDS2Token is invalid. | Error | Occasional | T0 |
| 15_015 | Invalid Browser Info The browserInfo provided is invalid. | Error | Occasional | T0 |
| 15_016 | Language Must Be Valid IETF BCP47 Tag The language must be a valid tag according to the IETF BCP47 definition. | Error | Occasional | T0 |
| 15_017 | Cannot Authorise 3DS2 Transaction After 12 Hours Cannot perform an authorisation on a 3DS2 transaction more than 12 hours after the transaction began. | Error | Occasional | T0 |
| 15_018 | Invalid Color Depth colorDepth must be 1, 4, 8, 15, 16, 24, 32, or 48 bit. | Error | Occasional | T0 |
| 15_019 | State Or Province Invalid The stateOrProvince value is invalid. | Error | Occasional | T0 |
| 15_020 | Invalid Trans Status The transStatus is invalid (likely null). Check what is passed in the request and verify with the issuer. | Error | Occasional | T0 |
| 15_021 | Notification URL Cannot Be Localhost The notificationURL cannot be localhost. Deploy a public notification server if testing a browser-based 3D Secure flow. | Error | Occasional | T0 |
| 15_022 | Invalid Authentication Only Field The authenticationOnly field is invalid. | Error | Occasional | T0 |
| 15_023 | Three DS2 Request Data Not Supported For MD Flow threeDS2RequestData is not supported for threeDS2InMDFlow. Remove threeDS2RequestData from the /payments request or use the native flow instead of the redirect flow. | Error | Occasional | T0 |
| 15_024 | 3DS2 Authentication Older Than 60 Days The result is not present because the authentication is older than 60 days. | Error | Occasional | T0 |
| 15_026 | Error During 3DS Authentication Process An error occurred during the 3DS authentication process. Common causes: incorrect paReq value in the redirect form, or incorrect paResponse in the authorise3d request. | Error | Occasional | T1 |
| 26_002 | Network Token Suspended Or Deactivated The network token is suspended or deactivated. | Error, Declined | Occasional | T1 |
| 26_003 | Detokenization Request Declined Adyen's request to the scheme to fetch the cryptogram for the network token was declined. | Error | Occasional | T1 |
| 26_004 | Network Token PAN Missing No Primary Account Number (PAN) was found for the network token. | Error | Occasional | T1 |
| 26_005 | Network Token Not Active Yet The network token is not active yet. | Error | Occasional | T0 |
| 26_006 | Network Token Not Found No network token was found to complete the payment. The token may have been deleted. | Error | Occasional | T0 |
| 26_007 | Detokenization Request Timed Out Adyen's request to the scheme to fetch the cryptogram for the network token timed out. | Error | Occasional | T0 |
| 26_008 | Network Token Required Fields Missing One or more required fields for the request are missing. The missing fields are returned in the error message. | Error | Occasional | T0 |
| 26_010 | Unsupported Variant For Network Tokenization The variant is not supported for network tokenization. | Error | Occasional | T0 |
| 26_017 | Operation Not Allowed For Network Token The attempted action (Delete, Suspend, or Resume) is not allowed for this network token. | Error | Occasional | T0 |
| 26_020 | Detokenization Request Failed Adyen's request to the scheme to fetch the cryptogram for the network token failed. | Error | Occasional | T1 |
| 29_001 | Field Exceeds Maximum Character Limit The value provided in a field exceeded the allowed number of characters, was placed in the wrong field, or a generation/encryption error produced a value that is too long. | Error | Occasional | T0 |
| 29_003 | Fraud Offset Out Of Range The fraudOffset field must be between -999 and 999. | Error | Rare | T0 |
| 29_100 | Request Exceeds Maximum Size The request body contains more bytes than the maximum allowed for that endpoint. | Error | Occasional | T0 |
| 100 | Required Object Amount Not Provided Missing parameter: add the `amount` or `originalReference` field, or compare your request against a standard request for that endpoint to identify missing parameters. | Error | Occasional | T0 |
| 101 | Invalid Card Number Incorrect card number or length, or incorrect capitalisation of PaRes. | Error, Declined | Common | T0 |
| 102 | Unable To Determine Variant The card number field contains an incorrect value. | Error | Occasional | T0 |
| 103 | CVC Is Not The Right Length The CVC is not valid: it may be alphanumeric instead of numeric-only, contain more than three digits (four for Amex), or otherwise be malformed. | Error, Declined | Occasional | T0 |
| 104 | Billing Address Problem Missing a required field under billingAddress. Check the object for missing fields. | Error | Occasional | T0 |
| 105 | Invalid PaRes From Issuer The issuer returned a URL-encoded, differently named, or empty PaRes/MD. URL-decode the values and ensure the parameter name is exactly PaRes before re-submitting to /payments/details. | Error | Rare | T0 |
| 106 | Session Already Used This session was already used previously and cannot be reused. | Error | Occasional | T0 |
| 107 | Recurring Not Enabled Missing user permission. Add the Merchant Recurring role to the associated web service user. | Error | Rare | T1 |
| 108 | Invalid Bank Account Number The IBAN is incorrect. | Error, Declined | Occasional | T0 |
| 109 | Invalid Variant Missing txvariant details. Check requestData and pass the details correctly. | Error | Occasional | T0 |
| 110 | Bank Details Missing The IBAN is missing or incorrect. | Error | Occasional | T0 |
| 111 | Invalid BankCountryCode Specified The parameter name is spelled incorrectly, or the countryCode value does not follow ISO 3166-1 alpha-2 format (e.g. use DE for Germany). | Error | Occasional | T0 |
| 112 | Bank Country Not Supported The countryCode length does not follow ISO standard or the country code does not exist. | Error, Declined | Occasional | T3 |
| 113 | No Invoice Lines Provided Invoice lines are missing in the requestData. | Error | Rare | T0 |
| 114 | Incorrect Invoice Line Incorrect currency used or lineReference is null. Check the invoice line against requestData. | Error | Rare | T0 |
| 115 | Total Amount Mismatch With Lines linesTotalQuantity is not equal to request.getAmount().getValue(). | Error | Rare | T0 |
| 116 | Invalid Date Of Birth The dateOfBirth format is incorrect. Check the date and format in the dateOfBirth parameter. | Error | Occasional | T0 |
| 117 | Invalid Billing Address The billingAddress object does not contain all required fields. Check the required parameters in the API Explorer. | Error | Occasional | T0 |
| 118 | Invalid Delivery Address The deliveryAddress is null or its format is invalid. | Error | Occasional | T0 |
| 119 | Invalid Shopper Name The shopperName is null. | Error | Occasional | T0 |
| 120 | Shopper Email Not Provided The shopperEmail is missing or its format is invalid. | Error | Occasional | T0 |
| 121 | Shopper Reference Not Provided The shopperReference is null or recurring requires shopperReference. | Error | Occasional | T0 |
| 122 | Telephone Number Not Provided The phoneNumber or telephoneNumber is null. | Error | Occasional | T0 |
| 124 | Invalid Phone Number The phone number provided is invalid. | Error | Occasional | T0 |
| 125 | Invalid Recurring Contract Specified The recurring object is not passed correctly. Check requestData and ensure the recurring object is correct. | Error | Occasional | T0 |
| 126 | Bank Account Or Location Id Not Valid Or Missing The bank account or bank location ID is missing or invalid. | Error | Occasional | T0 |
| 127 | Account Holder Name Not Provided Required field accountHolderName is not provided. | Error | Occasional | T0 |
| 128 | Card Holder Name Not Provided Required field card.holderName is not provided. | Error | Occasional | T0 |
| 129 | Expiry Date Invalid Expiry date value is not numeric, contains an empty space, the expiry month is not set, or the month value is not between 1 and 12. | Error, Declined | Occasional | T0 |
| 130 | Reference Missing The reference parameter is missing or requestData is missing multiple parameters. Check that reference is passed correctly. | Error | Occasional | T0 |
| 131 | Billing Address City Not Provided Required field billingAddress.city is not provided. | Error | Occasional | T0 |
| 132 | Billing Address Street Not Provided Required field billingAddress.street is not provided. | Error | Occasional | T0 |
| 133 | Billing Address House Number Not Provided Required field billingAddress.houseNumberOrName is not provided. | Error | Occasional | T0 |
| 134 | Billing Address Country Problem The billing address country field is invalid or missing. | Error | Occasional | T0 |
| 135 | Billing Address State Or Province Not Provided Required field billingAddress.stateOrProvince is not provided. | Error | Occasional | T0 |
| 136 | Failed To Retrieve Open Invoice Lines Could not retrieve OpenInvoiceLines for the request. | Error | Rare | T1 |
| 137 | Amount Field Not Valid The amount passed is greater than the limit or is not a positive number. | Error | Occasional | T0 |
| 138 | Currency Field Not Valid The provided currency is not supported. | Error, Declined | Occasional | T3 |
| 139 | Recurring Requires Shopper Email And Reference Both shopperReference and shopperEmail are missing for a recurring payment request. | Error | Occasional | T0 |
| 140 | Invalid Expiry Month Or Year Before Now Expiry month is not in [1..12], expiry year is not > 2000, or the date is in the past. | Error, Declined | Occasional | T0 |
| 141 | Invalid Expiry Month Or Year Expiry month is not in [1..12] or expiry year is not > 2000. | Error, Declined | Occasional | T0 |
| 142 | Bank Name Or Location Not Valid Or Missing The bank name or bank location is not valid or is missing. | Error | Occasional | T0 |
| 143 | iDEAL Merchant Return URL Too Long The submitted total iDEAL merchantReturnUrl length exceeds the maximum size allowed for this request. | Error | Rare | T0 |
| 144 | Invalid Start Month Or Year startMonth is not in [1..12], startYear is not > 2000, or the date is in the future. | Error | Occasional | T0 |
| 145 | Invalid Issuer Country Code The issuer country code provided is invalid. | Error | Occasional | T0 |
| 146 | Invalid Social Security Number The social security number provided is invalid. | Error | Occasional | T0 |
| 147 | Delivery Address City Not Provided Required field deliveryAddress.city is not provided. | Error | Occasional | T0 |
| 148 | Delivery Address Street Not Provided Required field deliveryAddress.street is not provided, or the value is empty. | Error | Occasional | T0 |
| 149 | Delivery Address House Number Not Provided Required field deliveryAddress.houseNumberOrName is not provided. | Error | Occasional | T0 |
| 150 | Delivery Address Country Problem The delivery address country field is invalid or missing. | Error | Occasional | T0 |
| 151 | Delivery Address State Or Province Not Provided The stateOrProvince field is missing in the delivery address and is required for the selected country. | Error | Occasional | T0 |
| 152 | Invalid Number Of Installments Installment value is zero or the payment method is not configured with installment. Check requestData and configure installment under the specific payment method. | Error | Occasional | T0 |
| 153 | Invalid CVC The CVC is not numeric or contains invalid values. | Error, Declined | Occasional | T0 |
| 154 | No Additional Data Specified No additional data was specified in the request. | Error | Rare | T0 |
| 155 | No Acquirer Specified No acquirer was specified in the request. | Error | Rare | T1 |
| 156 | No Authorisation MID Specified No authorisation merchant ID was specified in the request. | Error | Rare | T1 |
| 157 | No Fields Specified No fields were specified in the request. | Error | Rare | T0 |
| 158 | Required Field Not Provided One of the following fields is missing: initialPspReference, orderReference, ownerName, or reference. Supply the missing value. | Error | Occasional | T0 |
| 159 | Invalid Number Of Requests The number of requests in the batch is invalid. | Error | Rare | T0 |
| 160 | Not Allowed To Store Payout Details The credential does not have permission to store payout details. | Error | Rare | T1 |
| 161 | Invalid IBAN The IBAN is incorrect, there is a mismatch between IBAN and country, or the bank does not support SEPA direct debit. | Error, Declined | Occasional | T0 |
| 162 | Inconsistent IBAN Swift Code / BIC does not exist, payout party/account BIC/Swift is invalid, BIC does not correlate to countryCode, or IBAN characters/digits exceeded. | Error | Occasional | T0 |
| 163 | Invalid BIC The BIC provided is invalid. | Error | Occasional | T0 |
| 164 | Auto Capture Delay Invalid Or Out Of Range The auto capture delay value is invalid or outside the permitted range. | Error | Rare | T0 |
| 165 | MandateId Does Not Match Pattern The mandateId does not match the required pattern. | Error | Rare | T0 |
| 166 | Amount Not Allowed For This Operation The amount provided is not permitted for this operation. | Error | Occasional | T0 |
| 167 | Original PSP Reference Required The original PSP reference in the requestData field is missing. | Error | Occasional | T0 |
| 168 | Authorisation Code Required An authorisation code is required for this operation. | Error | Rare | T0 |
| 170 | Generation Date Required But Missing The generation date is required but was not provided. | Error | Rare | T0 |
| 171 | Unable To Parse Generation Date The generation date could not be parsed. | Error | Rare | T0 |
| 172 | Encrypted Data Outside Valid Time Period The server-side date/time is not configured correctly (e.g. set to 1975, or not within 24 hours of the current time). Check server-side date/time configuration. | Error | Occasional | T1 |
| 173 | Unable To Load Private Key For Decryption The private key for decryption could not be loaded. | Error | Rare | T1 |
| 174 | Unable To Decrypt Data Decryption failed. Common causes: using HTTP GET instead of POST, environment mismatch (LIVE/TEST), incorrect origin/client key, or API key mismatch. | Error | Occasional | T1 |
| 175 | Unable To Parse JSON Data Parameters sent are not correctly formatted in JSON. Read through requestData to find the error. | Error | Occasional | T0 |
| 180 | Invalid Shopper Reference shopperReference is empty, does not exist, or is not found. | Error | Occasional | T0 |
| 181 | Invalid Shopper Email shopperEmail is empty, does not exist, or is not found. | Error | Occasional | T0 |
| 182 | Invalid Selected Brand The selected brand is not equal to the brand on the stored token, or is empty. | Error | Occasional | T0 |
| 183 | Invalid Recurring Contract The recurring contract was not found in Recharge. | Error | Occasional | T0 |
| 184 | Invalid Recurring Detail Name The recurring detail name is empty/null or does not match the recurringDetail name. | Error | Occasional | T0 |
| 185 | Invalid Additional Data Too many fields/entries, splitPayment is missing or invalid, or adyenGivingAccount is not specified/retrievable. Check the additionalData object. | Error | Occasional | T0 |
| 186 | Missing Additional Data Field A required field in additionalData is missing. | Error | Occasional | T0 |
| 187 | Invalid Additional Data Field An additionalData field is invalid: too many entries, splitPayment missing/invalid, or adyenGivingAccount not specified or retrievable. | Error | Occasional | T0 |
| 188 | Invalid PSP Echo Data The previous recurringDetail token was not saved correctly or does not exist. | Error | Occasional | T0 |
| 189 | Invalid Shopper Statement An empty value was passed in shopperStatement in requestData. | Error | Occasional | T0 |
| 190 | Invalid Shopper IP The shopperIP field is empty. | Error | Occasional | T0 |
| 191 | No Params Specified No parameters were specified in the request. | Error | Rare | T0 |
| 192 | Invalid Field A field is invalid; commonly shopperInteraction contains an invalid value. | Error | Occasional | T0 |
| 193 | BIN Details Not Found BIN details were not found for the given card number. Ensure correct parameters and applicable values are passed. | Error | Occasional | T0 |
| 194 | Billing Address Missing Required object billingAddress is missing from the request. | Error | Occasional | T0 |
| 195 | Account Not Found For Key Could not find an account with the provided key. | Error | Occasional | T1 |
| 196 | Invalid MCC The MCC length is incorrect, a non-numeric value was provided, or an alphanumeric value was provided where numeric is required. | Error | Occasional | T0 |
| 198 | Reference Too Long The reference contains more than 80 characters (maximum is 79). | Error | Occasional | T0 |
| 199 | No Key Configured For Cryptographic Operation The cryptographic operation could not proceed because no key is configured. | Error | Rare | T1 |
| 200 | Invalid Country Code The countryCode is incorrect. Use ISO 3166-1 alpha-2 format. | Error | Occasional | T0 |
| 203 | Invalid Bank Account Holder Name Account holder name is inconsistent with FATF 16 recommendations or contains numbers. | Error | Occasional | T0 |
| 205 | Missing Or Invalid Network Transaction Reference Only digits provided, incorrect format, must be alphanumeric, or recurring value is null. | Error | Occasional | T0 |
| 213 | Social Security Number Not Provided The socialSecurityNumber, which is required for the payment method, is missing. | Error | Occasional | T0 |
| 217 | Shopper Interaction Missing Or Invalid The shopperInteraction field is missing or contains an invalid value. | Error | Occasional | T0 |
| 218 | Recurring Shopper Lookup Failed The lookup for the recurring shopper failed. | Error | Occasional | T0 |
| 700 | No Method Specified No method was specified in the request. | Error | Occasional | T0 |
| 701 | Server Could Not Process Request Incorrect POST/Content-Type, XML/HTTP sent instead of JSON, incorrect shopperReference for Pay by Link, missing API version, or invalid RequestURL. | Error | Occasional | T1 |
| 702 | Problem Parsing Request The request contains an unrecognised field or invalid format (introduced in API v64), empty input resulting in a null result, or an internal error. | Error | Occasional | T0 |
| 703 | Required Resource Temporarily Unavailable The data store is not available to compare the idempotency key. Retry later or omit the idempotency-key HTTP header. | Error | Occasional | T0 |
| 704 | Request Already Processed Or In Progress The web service user is sending multiple authorised requests with the same reference. Ensure requests are sent only once. | Error | Occasional | T0 |
| 705 | Rate Limited The API request rate limit has been exceeded. Throttle your API requests and wait before retrying. | Error | Common | T0 |
| 800 | Contract Not Found shopperReference does not exist, or requestData is creating a contract while simultaneously using recurringDetailReference. Check if the details were saved previously. | Error | Occasional | T0 |
| 801 | Too Many Payment Details Defined Too many paymentDetails exist for the same recurring or shopper reference, or the integration is incorrect. | Error | Occasional | T1 |
| 802 | Invalid Contract No valid contract types (RECURRING, ONECLICK, or PAYOUT) exist, or the contract type is incorrect. Check data sent on the PAL and the recurring field. | Error | Occasional | T0 |
| 803 | Payment Detail Not Found recurringDetailReference/storedPaymentMethodId does not exist, has been disabled, requestData is missing required fields (e.g. Klarna lineItems), or the payment method specified varies from the token. | Error | Occasional | T0 |
| 803_3 | No Active Payment Details For Shopper Reference Either the shopper reference is not valid, or all payment details have been disabled. | Error | Occasional | T0 |
| 804 | Failed To Disable The attempt to disable the recurring detail failed. | Error | Rare | T1 |
| 805 | Recurring Detail Reference Not Available For Contract The recurringDetailReference is not available for the provided recurring contract. | Error | Occasional | T0 |
| 806 | No Applicable Contract Types For Payment Method The txvariant (e.g. Maestro) cannot have recurring because the scheme mandates 3D Secure for all transactions. Recreate the contract or change the requestData. | Error | Occasional | T0 |
| 807 | Invalid Combination Of Shopper Interaction And Recurring Contract The recurring contract was not set up with shopperInteraction. | Error | Occasional | T0 |
| 820 | CVC Required For OneClick Card Payment The Card Validation Code (CVC) was not supplied for a OneClick card payment. Supply the CVC number. | Error, Declined | Occasional | T0 |
| 901 | Invalid Merchant Account Incorrect merchantAccount, incorrect MD value during 3DS, web service not permitted for the merchantAccount, company not active, or merchantAccount value has incorrect casing (case-sensitive). | Error | Common | T1 |
| 902 | Invalid Or Empty Request Data The request data is invalid or empty. | Error | Occasional | T0 |
| 903 | Internal Error An internal error occurred on the Adyen platform. | Error | Occasional | T1 |
| 904 | Unable To Process An error occurred while communicating with Adyen. | Error | Occasional | T1 |
| 905 | Payment Details Not Supported The payment method, currency, or country is not configured in Customer Area. Ensure the countryCode in requestData matches the payment method txvariant. | Error, Declined | Occasional | T1 |
| 905_1 | No Acquirer Account For Txvariant And Currency The payment method is not set up in this merchant account. Add the payment method in your Customer Area. | Error, Declined | Occasional | T1 |
| 905_2 | No Acquirer Account For MPI Data And Acquirer MPI data was specified without an acquirer code. Set the defaultToAcquirerSelectionRegardlessOfMPIData ADP to true via Support. | Error | Rare | T1 |
| 905_3 | No Acquirer Account For Currency Payment type not supported, payment method restricted to a store not specified in the request, minimum amount too low, a transaction rule is blocking, currency not configured, customRoutingFlag missing, or BIN/country/issuer restriction applies. | Error, Declined | Occasional | T1 |
| 905_4 | Cashback And Cashout Not Allowed The merchant account does not allow cashback or cashout. This is specific to EFTPOS (Australia/New Zealand). Contact Support to enable. | Error | Rare | T1 |
| 905_5 | No Acquirer Account Configured For Klarna The merchant account has not been configured to accept Klarna payments. Add the payment method in Customer Area. | Error | Occasional | T1 |
| 905_6 | Both Klarna Platforms Configured Both KlarnaPayments and Klarna have been configured for the merchant account. Only one is allowed. Remove one of the Klarna payment methods. | Error | Rare | T1 |
| 906 | Original PSP Reference Invalid For Environment LIVE/TEST PSP mismatch: a TEST PSP reference was sent to the LIVE endpoint (or vice versa). Pass the correct PSP or verify the environment. | Error | Occasional | T0 |
| 907 | Payment Details Not Supported For Country Or MCC The payment method is missing or not configured for the specified country/MCC combination, or issuer restrictions apply. | Error, Declined | Occasional | T1 |
| 908 | Invalid Request Using an incorrect endpoint or sending incorrect requestData to the wrong endpoint. Verify the goal of the request and send to the correct endpoint. | Error | Occasional | T0 |
| 910 | Invalid Store The specified store does not match any store references or store IDs for the merchant account. Find the correct store ID in your Customer Area and retry. | Error | Occasional | T0 |
| 912 | TX Variant Does Not Support Redemption Type The TX variant does not support the requested redemption type. | Error | Rare | T0 |
| 916 | Transaction Amount Exceeds Card Limit The transaction amount exceeds the allowed limit for this type of card. | Error, Declined | Occasional | T2 |
| 918 | Required Object Card Not Provided The required card object is not provided in the request. | Error | Occasional | T0 |
| 919 | Additional Amount Currency Mismatch The additionalAmount currency must be the same currency as the payment. | Error | Rare | T0 |
| 920 | Total Payment Amount Less Than Zero The total payment amount should be equal to or greater than zero. | Error | Occasional | T0 |
| 921_1 | MPI Data Missing Due To Three D Reference The mpiData object is missing, but is required because threeDReference is present. | Error | Rare | T0 |
| 921_2 | MPI Data Not Valid The mpiData object is not valid: authenticationResponse is missing or directoryResponse does not match. | Error | Rare | T0 |
| 922 | Account Updater Only For Visa And Mastercard Account updater connections are only supported for Visa and MasterCard. | Error | Rare | T0 |
| 923 | No Registered Account For Account Updater No registered account was found for the AccountUpdater. | Error | Rare | T1 |
| 924 | Not Allowed To Change Shopper Interaction Changing the shopperInteraction is not permitted for this request. | Error | Rare | T0 |
| 926 | Invalid iDEAL Issuer The iDEAL issuer provided is invalid. | Error | Occasional | T0 |
| 927 | Missing Payment Details Required payment details are missing from the request. | Error | Occasional | T0 |
| 928 | Invalid Forex Type Specified The forex type specified in the request is invalid. | Error | Rare | T0 |
| 929 | Invalid Base Currency Specified The base currency specified in the request is invalid. | Error | Rare | T0 |
| 930 | Invalid Target Currency Specified The target currency specified in the request is invalid. | Error | Rare | T0 |
| 931 | Merchant Not Found There is no merchant with the specified code. | Error | Occasional | T1 |
| 950 | Invalid Acquirer Account The acquirer account is invalid. | Error | Occasional | T1 |
| 951 | Configuration Error Acquirer Identification Configuration error in acquirerIdentification. | Error | Rare | T1 |
| 952 | Configuration Error Acquirer Password Configuration error in acquirerPassword. | Error | Rare | T1 |
| 953 | Configuration Error API Key Configuration error in apiKey. | Error | Rare | T1 |
| 954 | Configuration Error Redirect URL Configuration error in redirectUrl. | Error | Rare | T1 |
| 955 | Configuration Error Acquirer Account Data Configuration error in AcquirerAccountData. | Error | Rare | T1 |
| 956 | Configuration Error Currency Code Configuration error in currencyCode. | Error | Rare | T1 |
| 957 | Configuration Error Terminal ID Configuration error in terminalId. | Error | Rare | T1 |
| 958 | Configuration Error Serial Number Configuration error in serialNumber. | Error | Rare | T1 |
| 959 | Configuration Error Password Configuration error in password. | Error | Rare | T1 |
| 960 | Configuration Error Project ID Configuration error in projectId. | Error | Rare | T1 |
| 961 | Configuration Error Merchant Category Code Configuration error in merchantCategoryCode. | Error | Rare | T1 |
| 962 | Configuration Error Merchant Name Configuration error in merchantName. | Error | Rare | T1 |
| 963 | Invalid Company Registration Number The company registration number provided is invalid. | Error | Rare | T0 |
| 964 | Invalid Company Name The company name provided is invalid. | Error | Rare | T0 |
| 965 | Missing Company Details Required company details are missing from the request. | Error | Rare | T0 |
| 966 | Configuration Error Private Key Alias Configuration error in privateKeyAlias. | Error | Rare | T1 |
| 967 | Configuration Error Public Key Alias Configuration error in publicKeyAlias. | Error | Rare | T1 |
| 1000 | Card Number Not Allowed For Incontrol Virtual Card Card number cannot be specified for Incontrol virtual card requests. | Error | Rare | T0 |
| 1001 | Recurring Not Allowed For Incontrol Virtual Card Recurring is not allowed for Incontrol virtual card requests. | Error | Rare | T0 |
| 1002 | Invalid Authorisation Type Supplied An invalid authorisation type was supplied in the request. | Error | Rare | T0 |
| 2000 | Bank Account Details Do Not Meet Instruction Format Bank details required for Payout are not being passed, or selectedRecurringDetailReference is set to LATEST which may not correspond to bank details. | Error | Occasional | T0 |
| Webhook Event Code | ||||
| AUTHENTICATION | Authentication Result of a standalone 3D Secure authentication request. | Approved, Error | Rare | T0 |
| AUTHORISATION | Authorisation Result of a payment authorization request. `success: true` means the payment was authorised; `success: false` means it was refused. | Approved, Declined | Common | T0 |
| AUTHORISATION_ADJUSTMENT | Authorisation Adjustment Result of a request to adjust the authorised amount or expiry date of a payment. | Approved, Error | Rare | T0 |
| CANCEL_OR_REFUND | Cancel Or Refund Result of a request to cancel or refund a payment, whichever is still possible depending on whether the payment has already been captured. | Approved, Error | Occasional | T0 |
| CANCELLATION | Cancellation Result of a request to cancel an authorised payment before it is captured. | Approved, Error | Occasional | T0 |
| CAPTURE | Capture Result of a request to capture funds on a previously authorised payment. | Approved, Error | Common | T0 |
| CAPTURE_FAILED | Capture Failed A previously successful capture failed after the fact (e.g. the funds could not be settled). | Error | Rare | T1 |
| CHARGEBACK | Chargeback The shopper (or their issuer) disputed the payment and Adyen has withdrawn the funds. | Declined, Error | Occasional | T1 |
| CHARGEBACK_REVERSED | Chargeback Reversed A previous chargeback was reversed and funds were returned to the merchant. | Approved | Rare | T0 |
| DISPUTE_DEFENSE_PERIOD_ENDED | Dispute Defense Period Ended The window to submit defense documents for an open dispute has ended. | Info | Rare | T0 |
| DONATION | Donation Result of a request to donate a payment (or part of it) to a charity. | Approved, Error | Rare | T0 |
| EXPIRE | Expire An authorised payment expired before it could be captured or cancelled (typically 28 days for cards). Always reported with `success: true` since the expiry itself is not a failed operation, but the payment is no longer usable. | Error | Rare | T0 |
| HANDLED_EXTERNALLY | Handled Externally The payment was handled outside of Adyen (e.g. cash) and is registered for bookkeeping purposes only. | Info | Rare | T0 |
| INFORMATION_SUPPLIED | Information Supplied Defense documents were successfully supplied for an open dispute. | Info | Rare | T0 |
| ISSUER_COMMENTS | Issuer Comments The issuer added comments to an open dispute. Informational only. | Info | Rare | T0 |
| ISSUER_RESPONSE_TIMEFRAME_EXPIRED | Issuer Response Timeframe Expired The issuer did not respond to submitted defense documents within the allowed timeframe. | Info | Rare | T0 |
| MANUAL_REVIEW_ACCEPT | Manual Review Accept A payment held for manual risk review was accepted by a reviewer. | Approved | Rare | T0 |
| MANUAL_REVIEW_REJECT | Manual Review Reject A payment held for manual risk review was rejected by a reviewer. | Declined | Rare | T2 |
| NOTIFICATION_OF_CHARGEBACK | Notification Of Chargeback Early warning that a chargeback is likely to be filed. Informational only; no funds have moved yet. | Processing, Info | Rare | T0 |
| NOTIFICATION_OF_FRAUD | Notification Of Fraud The issuer reported the transaction as fraudulent via a TC40/SAFE report. Informational; no funds move on this event alone. | Info | Rare | T0 |
| OFFER_CLOSED | Offer Closed The shopper did not complete an asynchronous payment (e.g. redirect or 3D Secure flow) within the allowed time window, so the offer was closed. | Declined, Error | Occasional | T0 |
| ORDER_CLOSED | Order Closed A partial-payment order was closed. `success: true` means the order was fully paid; `success: false` means it was not completed within the allowed time. | Approved, Error | Rare | T0 |
| ORDER_OPENED | Order Opened A partial-payment order (e.g. gift card + card) was opened. | Info, Processing | Rare | T0 |
| PAIDOUT_REVERSED | Paid Out Reversed A completed payout was reversed and funds were returned to the merchant. | Error | Rare | T1 |
| PAYOUT_DECLINE | Payout Decline A payout request was declined by the financial institution. | Declined | Rare | T2 |
| PAYOUT_EXPIRE | Payout Expire A payout request expired before it could be confirmed. | Error | Rare | T0 |
| PAYOUT_THIRDPARTY | Payout Third Party Result of a third-party payout request. | Approved, Error | Rare | T0 |
| PENDING | Pending The payment is pending completion. Used by several async payment methods (bank transfer, Boleto Bancario, direct debit, iDEAL, OXXO, and generic pending notifications). | Processing | Common | T0 |
| POSTPONED_REFUND | Postponed Refund A refund request was accepted but postponed, typically because the payment has not yet settled. | Processing | Rare | T0 |
| PREARBITRATION_LOST | Prearbitration Lost Adyen lost the pre-arbitration stage of a dispute; the disputed funds remain withdrawn. | Error, Declined | Rare | T1 |
| PREARBITRATION_WON | Prearbitration Won Adyen won the pre-arbitration stage of a dispute; the disputed funds are returned to the merchant. | Approved | Rare | T0 |
| RECURRING_CONTRACT | Recurring Contract Result of a request to store shopper details for recurring/tokenized payments. | Approved, Error | Occasional | T0 |
| REFUND | Refund Result of a request to refund a captured/settled payment. | Approved, Error | Common | T0 |
| REFUND_FAILED | Refund Failed A previously accepted refund failed and funds were not returned to the shopper. | Error | Occasional | T1 |
| REFUND_WITH_DATA | Refund With Data Result of a refund request that included additional data (e.g. for partial-payment methods). | Approved, Error | Rare | T0 |
| REFUNDED_REVERSED | Refunded Reversed A refund that appeared successful was reversed because the shopper did not receive the funds; they were returned to the merchant instead. | Error | Rare | T1 |
| REPORT_AVAILABLE | Report Available Informational notification that a scheduled report is available for download. Not tied to a specific transaction outcome. | Info | Occasional | T0 |
| REQUEST_FOR_INFORMATION | Request For Information The issuer requested additional information as part of an early dispute/RFI stage. | Processing, Info | Rare | T0 |
| SECOND_CHARGEBACK | Second Chargeback The defense of the first chargeback was not successful and the shopper disputed the payment again. This is a final status for the dispute. | Declined, Error | Rare | T1 |
| VOID_PENDING_REFUND | Void Pending Refund A void request was accepted but the payment had already started settlement, so it will be processed as a refund instead. | Processing | Rare | T0 |
Payment providers you might find interesting:
View all
UnionPay
UnionPay is a global card payment network used by issuers, acquirers, and merchants to accept UnionPay-branded card payments.
Authorize.Net
Authorize.Net is a payment gateway that helps merchants accept card and bank-account payments through supported merchant accounts and e‑/m‑/
Klarna
Klarna is a payment provider that lets merchants offer buy now, pay later and flexible payment options at checkout.
Paysafe Group
Paysafe Group is a payments provider supporting merchants with payment processing and related tools for accepting and managing transactions.
Articles you may find interesting:
View all
How Payment Teams Can Prevent Gateway Holds and Manage Dispute Ratios
Discover how automated risk reviews trigger gateway freezes and how payment teams can insulate revenue through multi-acquirer setups and smart retry logic.
Why Credit Cards Get Declined and How Payment Teams Can Fix It
Payment rejections cost merchants billions in lost sales and unforced churn. Discover the root causes behind issuer declines and how intelligent recovery strategies salvage legitimate revenue.
Why Payment Tests Pass in Staging and Fail in Production
Passing a sandbox check rarely guarantees live authorization success. Learn how real-world issuer ambiguity, webhook delays, and network retry rules impact revenue pipelines.
Testing Payment Systems: Why Sandboxes Lie and How to Test in Production
Sandboxes verify API formatting, but live issuers determine transaction success. Discover how multi-layered testing, safe retry logic, and real-time observability safeguard authorization rates and reduce involuntary customer churn.