{"title":"Terminal API refusal reasons","category":"default","creationDate":1779796134,"content":"<p>When your <a href=\"\/point-of-sale\/error-scenarios#declined-payment\">payment request is declined<\/a>, we include an error category in the <code>ErrorCondition<\/code> field of the payment response, and a further explanation in the <code>refusalReason<\/code> inside the <code>Response.AdditionalResponse<\/code>.<\/p>\n<p>The refusal reasons we provide are based on the <a href=\"\/point-of-sale\/error-scenarios\/raw-acquirer-responses\">raw responses<\/a> we receive from acquirers and issuers.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>You can use the <code>ErrorCondition<\/code> to code your POS app. The <code>refusalReason<\/code> and <code>message<\/code> fields are included for additional insight, and should not be coded against.<\/p>\n<\/div><\/div>\n<h2 id=\"refusal-reasons-list\">Refusal reasons by error condition<\/h2>\n<p>The following tables show the most common refusal reasons for point-of-sale payment transactions, grouped by the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment#responses-200-Response-ErrorCondition\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">ErrorCondition<\/a> in the <code>PaymentResponse.Response<\/code>:<\/p>\n<ul>\n<li><a href=\"#error-condition-aborted\">\n  <span translate=\"no\">Aborted<\/span>\n<\/a><\/li>\n<li><a href=\"#error-condition-busy\">\n  <span translate=\"no\">Busy<\/span>\n<\/a><\/li>\n<li><a href=\"#error-condition-cancel\">\n  <span translate=\"no\">Cancel<\/span>\n<\/a><\/li>\n<li><a href=\"#error-condition-deviceout\">DeviceOut<\/a><\/li>\n<li><a href=\"#error-condition-invalidcard\">InvalidCard<\/a><\/li>\n<li><a href=\"#error-condition-notallowed\">NotAllowed<\/a><\/li>\n<li><a href=\"#error-condition-refusal\">\n  <span translate=\"no\">Refusal<\/span>\n<\/a><\/li>\n<li><a href=\"#error-condition-unreachable\">UnreachableHost<\/a><\/li>\n<li><a href=\"#error-condition-wrongpin\">WrongPIN<\/a><\/li>\n<\/ul>\n<p>The tables show the <code>refusalReason<\/code> and <code>message<\/code> you receive in the <code>PaymentResponse.Response.AdditionalResponse<\/code>.<\/p>\n<p>Contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> if you need more information about a refusal reason.<\/p>\n<h3 id=\"error-condition-aborted\">ErrorCondition: Aborted<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Aborted<\/td>\n<td style=\"text-align: left;\">Contactless fallback<\/td>\n<td style=\"text-align: left;\">CONTACTLESS_FALLBACK<\/td>\n<td style=\"text-align: left;\">The shopper abandoned the transaction after they attempted a contactless payment and were prompted to try a different card entry method (PIN or swipe).<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-busy\">ErrorCondition: Busy<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">serviceId<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Busy<\/td>\n<td style=\"text-align: left;\">1234567890<\/td>\n<td style=\"text-align: left;\">Forbidden Request, Service Dialogue PaymentRequest is in Progress<\/td>\n<td style=\"text-align: left;\">Another transaction, with the provided <code>serviceId<\/code>, is still in progress. Using the <code>serviceId<\/code> you can make an <code>AbortRequest<\/code> to <a href=\"\/point-of-sale\/basic-tapi-integration\/cancel-a-transaction#cancel-from-register\">cancel<\/a> the in-progress transaction.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Busy<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">ADMIN_MENU<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Busy<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">(all other messages)<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-cancel\">ErrorCondition: Cancel<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Approved<\/td>\n<td style=\"text-align: left;\">APPROVED<\/td>\n<td style=\"text-align: left;\">Transaction was canceled after being initially approved by the issuer.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Cancelled<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Transaction was canceled.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">card removed<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Shopper's card was removed from the terminal before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Card removed during application selection<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Shopper's card was removed from the terminal before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Card removed during transaction<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Shopper's card was removed from the terminal before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Card removed during transaction (first ac)<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Shopper's card was removed from the terminal before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Card removed during transaction (verify cardholder)<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Shopper's card was removed from the terminal before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Card removed while processing online<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Shopper's card was removed from the terminal before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Card swapped mid-transaction<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">Card removed from the terminal and swapped for another card during the transaction.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">chip cancelled tx (2nd ac returned AAC)<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The Application Authentication Cryptogram (AAC) on the card declined the transaction offline.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Merchant cancelled<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The merchant canceled the transaction before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Merchant cancelled after contactless fallback<\/td>\n<td style=\"text-align: left;\">CONTACTLESS_FALLBACK<\/td>\n<td style=\"text-align: left;\">The merchant canceled the transaction before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Merchant cancelled during online authorization<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The merchant canceled the transaction before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Merchant cancelled during validate call<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The merchant canceled the transaction before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Merchant cancelled tx<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The merchant canceled the transaction before the transaction finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper Cancelled<\/td>\n<td style=\"text-align: left;\">SHOPPER_CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before completing it.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled after contactless fallback<\/td>\n<td style=\"text-align: left;\">CONTACTLESS_FALLBACK<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled during application selection<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled during dcc selection<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled during online authorization<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled during validate call<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled Manual Key Entry<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled pin entry<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper cancelled tx<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper canceled the transaction before it finished.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Shopper did not present a card<\/td>\n<td style=\"text-align: left;\">CANCELLED<\/td>\n<td style=\"text-align: left;\">The shopper did not present a card, so the transaction was canceled.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-deviceout\">ErrorCondition: DeviceOut<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">DeviceOut<\/td>\n<td style=\"text-align: left;\">Crash recovery<\/td>\n<td style=\"text-align: left;\">POI_is_Temporary_Unavailable_Terminal_not_ready<\/td>\n<td style=\"text-align: left;\">Terminal stopped responding for an unknown reason, causing the transaction to fail.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">DeviceOut<\/td>\n<td style=\"text-align: left;\">Low battery<\/td>\n<td style=\"text-align: left;\">Failed starting transaction: Low Battery<\/td>\n<td style=\"text-align: left;\">Battery charge level dropped below the minimum battery level configured in your Customer Area. Connect the terminal to a power source and retry, or retry using a different terminal.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-invalidcard\">ErrorCondition: InvalidCard<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">InvalidCard<\/td>\n<td style=\"text-align: left;\">Card data authentication failed<\/td>\n<td style=\"text-align: left;\">DECLINED<\/td>\n<td style=\"text-align: left;\">Failed to obtain the relevant card data. The shopper should use an alternate payment method.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">InvalidCard<\/td>\n<td style=\"text-align: left;\">No checking account available on Card<\/td>\n<td style=\"text-align: left;\">NO_CHECKING_ACCOUNT<\/td>\n<td style=\"text-align: left;\">No checking account available on the card.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">InvalidCard<\/td>\n<td style=\"text-align: left;\">No savings account available on Card<\/td>\n<td style=\"text-align: left;\">NO_SAVINGS_ACCOUNT<\/td>\n<td style=\"text-align: left;\">No savings account available on the card.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-notallowed\">ErrorCondition: NotAllowed<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">NotAllowed<\/td>\n<td style=\"text-align: left;\">Blocked Card<\/td>\n<td style=\"text-align: left;\">BLOCK_CARD<\/td>\n<td style=\"text-align: left;\">The selected card application is blocked. It cannot be used for the transaction.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">NotAllowed<\/td>\n<td style=\"text-align: left;\">Invalid Amount<\/td>\n<td style=\"text-align: left;\">INVALID_AMOUNT<\/td>\n<td style=\"text-align: left;\">An amount mismatch occurred during the transaction.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">NotAllowed<\/td>\n<td style=\"text-align: left;\">Payment details are not supported<\/td>\n<td style=\"text-align: left;\">ERROR<\/td>\n<td style=\"text-align: left;\">The used payment method is not supported. Contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-refusal\">ErrorCondition: Refusal<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Acquirer Error<\/td>\n<td style=\"text-align: left;\">ERROR<\/td>\n<td style=\"text-align: left;\">The transaction did not go through due to an error that occurred on the acquirer's end.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">AID banned<\/td>\n<td style=\"text-align: left;\">ERROR<\/td>\n<td style=\"text-align: left;\">The application is temporarily in our AID penalty box until its payments network can be reached again.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Always refused<\/td>\n<td style=\"text-align: left;\">DECLINED<\/td>\n<td style=\"text-align: left;\">Gift card refused.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Amount too low to be accepted by Card Network<\/td>\n<td style=\"text-align: left;\">DECLINED<\/td>\n<td style=\"text-align: left;\">The card network doesn't accept the entered amount because it is too low.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Card blocked<\/td>\n<td style=\"text-align: left;\">BLOCK_CARD<\/td>\n<td style=\"text-align: left;\">The card has been blocked and cannot be used. The shopper should contact their bank.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Card requires online pin<\/td>\n<td style=\"text-align: left;\">PIN_REQUIRED<\/td>\n<td style=\"text-align: left;\">Card requires online pin<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">CVC Declined<\/td>\n<td style=\"text-align: left;\">CVC_DECLINED<\/td>\n<td style=\"text-align: left;\">The specified <a href=\"\/get-started-with-adyen\/adyen-glossary\/#card-security-code-cvc-cvv-cid\">CVC (card security code)<\/a> is invalid.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">declined<\/td>\n<td style=\"text-align: left;\">DECLINED<\/td>\n<td style=\"text-align: left;\">Transaction has been declined for a unspecified reason.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Declined Non Generic<\/td>\n<td style=\"text-align: left;\">DECLINED<\/td>\n<td style=\"text-align: left;\"><a href=\"https:\/\/developer.mastercard.com\/repower\/documentation\/code-and-formats\/error-codes\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">This response represents all response codes that cannot be reliably mapped.<\/a> This makes it easier to differentiate between generic declines (for example, Mastercard \"05: Do not honor\" response) and more specific ones.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Expired Card<\/td>\n<td style=\"text-align: left;\">CARD_EXPIRED<\/td>\n<td style=\"text-align: left;\">The card has expired. It cannot be used for the transaction.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Issuer Suspected Fraud<\/td>\n<td style=\"text-align: left;\">ISSUER_SUSPECTED_FRAUD<\/td>\n<td style=\"text-align: left;\">Issuer reported the transaction as suspected fraud.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Mobile PIN required<\/td>\n<td style=\"text-align: left;\">MOBILE_PIN_REQUIRED<\/td>\n<td style=\"text-align: left;\">Mostly for <a href=\"\/point-of-sale\/what-we-support\/payment-methods#nfc-wallets\">NFC wallet transactions<\/a> when extra authentication is needed on the phone to complete the transaction (like enter PIN, unlock phone, or fingerprint).<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Not enough balance<\/td>\n<td style=\"text-align: left;\">NOT_ENOUGH_BALANCE<\/td>\n<td style=\"text-align: left;\">The card does not have enough money to cover the payable amount.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Not Submitted<\/td>\n<td style=\"text-align: left;\">NOT_SUBMITTED<\/td>\n<td style=\"text-align: left;\">The transaction was not submitted correctly for processing.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Not supported<\/td>\n<td style=\"text-align: left;\">NOT_SUPPORTED<\/td>\n<td style=\"text-align: left;\">The shopper's bank doesn't support or doesn't allow this type of transaction.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Pin tries exceeded<\/td>\n<td style=\"text-align: left;\">PIN_TRIES_EXCEEDED<\/td>\n<td style=\"text-align: left;\">The shopper specified an incorrect PIN more that three times in a row. This error also occurs for example with a Bancontact\/Mister Cash (BCMC) payment where the shopper exceeded the maximum time between transactions without using a PIN.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Pin validation not possible<\/td>\n<td style=\"text-align: left;\">PIN_VALIDATION_NOT_POSSIBLE<\/td>\n<td style=\"text-align: left;\">It is not possible to validate the specified PIN number.<\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Refused<\/td>\n<td style=\"text-align: left;\">DECLINED<\/td>\n<td style=\"text-align: left;\">The transaction was refused. This response is also returned when the transaction is declined based on the fraud rules and checks on the EMV chip.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Restricted Card<\/td>\n<td style=\"text-align: left;\">RESTRICTED_CARD<\/td>\n<td style=\"text-align: left;\">Several 'Decline' codes are mapped to this refusal reason response value. For example: <ul><li markdown=\"1\">62: Restricted Card<\/li><li markdown=\"1\">62: Invalid card in this country\/region<\/li><\/ul><\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Timeout waiting for card after contactless fallback<\/td>\n<td style=\"text-align: left;\">CONTACTLESS_FALLBACK<\/td>\n<td style=\"text-align: left;\">Transaction timed out. Shopper should retry or use an alternate payment method.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Transaction Not Permitted<\/td>\n<td style=\"text-align: left;\">TRANSACTION_NOT_PERMITTED<\/td>\n<td style=\"text-align: left;\">Several 'Decline' codes are mapped to this refusal reason response value. For example: <ul><li markdown=\"1\">57: Transaction not permitted to issuer\/cardholder<\/li><li markdown=\"1\">57: Transaction not allowed for this merchant<\/li><li markdown=\"1\">58: Transaction not permitted to acquirer\/terminal<\/li><\/ul><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Withdrawal count exceeded<\/td>\n<td style=\"text-align: left;\">WITHDRAWAL_COUNT_EXCEEDED<\/td>\n<td style=\"text-align: left;\">The number of withdrawals permitted for the shopper's card was exceeded. Also used for contactless transactions (Contactless Withdrawal Count Exceeded).<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refusal<\/td>\n<td style=\"text-align: left;\">Withdrawal amount exceeded<\/td>\n<td style=\"text-align: left;\">WITHDRAWAL_AMOUNT_EXCEEDED<\/td>\n<td style=\"text-align: left;\">The withdrawal amount permitted for the shopper's card was exceeded. Also used for contactless transactions (Contactless Withdrawal Amount Exceeded).<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-unreachable\">ErrorCondition: UnreachableHost<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">UnreachableHost<\/td>\n<td style=\"text-align: left;\">failed to go online<\/td>\n<td style=\"text-align: left;\">DECLINED<\/td>\n<td style=\"text-align: left;\">Unable to go online.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">UnreachableHost<\/td>\n<td style=\"text-align: left;\">Issuer Unavailable<\/td>\n<td style=\"text-align: left;\">ISSUER_UNAVAILABLE<\/td>\n<td style=\"text-align: left;\">It is not possible to contact the shopper's bank to authorize the transaction.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"error-condition-wrongpin\">ErrorCondition: WrongPIN<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">ErrorCondition<\/th>\n<th style=\"text-align: left;\">refusalReason<\/th>\n<th style=\"text-align: left;\">message<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: center;\">Retry?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">WrongPIN<\/td>\n<td style=\"text-align: left;\">Invalid Pin<\/td>\n<td style=\"text-align: left;\">INVALID_PIN<\/td>\n<td style=\"text-align: left;\">The specified PIN number is incorrect or invalid.<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/error-scenarios\/raw-acquirer-responses\"\n                        target=\"_self\"\n                        >\n                    Raw acquirer responses\n                <\/a><\/li><li><a href=\"\/point-of-sale\/error-scenarios\"\n                        target=\"_self\"\n                        >\n                    Handle responses\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/point-of-sale\/error-scenarios\/refusal-reasons-pos","articleFields":{"description":"Learn about the refusal reasons for point-of-sale payment requests.","feedback_component":true,"id":"28875180","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"28-01-2022 21:01"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/error-scenarios\/refusal-reasons-pos","title":"Terminal API refusal reasons","content":"When your payment request is declined, we include an error category in the ErrorCondition field of the payment response, and a further explanation in the refusalReason inside the Response.AdditionalResponse.\nThe refusal reasons we provide are based on the raw responses we receive from acquirers and issuers.\n\nYou can use the ErrorCondition to code your POS app. The refusalReason and message fields are included for additional insight, and should not be coded against.\n\nRefusal reasons by error condition\nThe following tables show the most common refusal reasons for point-of-sale payment transactions, grouped by the  ErrorCondition in the PaymentResponse.Response:\n\n\n  Aborted\n\n\n  Busy\n\n\n  Cancel\n\nDeviceOut\nInvalidCard\nNotAllowed\n\n  Refusal\n\nUnreachableHost\nWrongPIN\n\nThe tables show the refusalReason and message you receive in the PaymentResponse.Response.AdditionalResponse.\nContact our Support Team if you need more information about a refusal reason.\nErrorCondition: Aborted\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nAborted\nContactless fallback\nCONTACTLESS_FALLBACK\nThe shopper abandoned the transaction after they attempted a contactless payment and were prompted to try a different card entry method (PIN or swipe).\n\n\n\n\nErrorCondition: Busy\n\n\n\nErrorCondition\nserviceId\nmessage\nDescription\nRetry?\n\n\n\n\nBusy\n1234567890\nForbidden Request, Service Dialogue PaymentRequest is in Progress\nAnother transaction, with the provided serviceId, is still in progress. Using the serviceId you can make an AbortRequest to cancel the in-progress transaction.\n\n\n\nBusy\n\nADMIN_MENU\n\n\n\n\nBusy\n\n(all other messages)\n\n\n\n\n\nErrorCondition: Cancel\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nCancel\nApproved\nAPPROVED\nTransaction was canceled after being initially approved by the issuer.\n\n\n\nCancel\nCancelled\nCANCELLED\nTransaction was canceled.\n\n\n\nCancel\ncard removed\nCANCELLED\nShopper's card was removed from the terminal before the transaction finished.\n\n\n\nCancel\nCard removed during application selection\nCANCELLED\nShopper's card was removed from the terminal before the transaction finished.\n\n\n\nCancel\nCard removed during transaction\nCANCELLED\nShopper's card was removed from the terminal before the transaction finished.\n\n\n\nCancel\nCard removed during transaction (first ac)\nCANCELLED\nShopper's card was removed from the terminal before the transaction finished.\n\n\n\nCancel\nCard removed during transaction (verify cardholder)\nCANCELLED\nShopper's card was removed from the terminal before the transaction finished.\n\n\n\nCancel\nCard removed while processing online\nCANCELLED\nShopper's card was removed from the terminal before the transaction finished.\n\n\n\nCancel\nCard swapped mid-transaction\nCANCELLED\nCard removed from the terminal and swapped for another card during the transaction.\n\n\n\nCancel\nchip cancelled tx (2nd ac returned AAC)\nCANCELLED\nThe Application Authentication Cryptogram (AAC) on the card declined the transaction offline.\n\n\n\nCancel\nMerchant cancelled\nCANCELLED\nThe merchant canceled the transaction before the transaction finished.\n\n\n\nCancel\nMerchant cancelled after contactless fallback\nCONTACTLESS_FALLBACK\nThe merchant canceled the transaction before the transaction finished.\n\n\n\nCancel\nMerchant cancelled during online authorization\nCANCELLED\nThe merchant canceled the transaction before the transaction finished.\n\n\n\nCancel\nMerchant cancelled during validate call\nCANCELLED\nThe merchant canceled the transaction before the transaction finished.\n\n\n\nCancel\nMerchant cancelled tx\nCANCELLED\nThe merchant canceled the transaction before the transaction finished.\n\n\n\nCancel\nShopper cancelled\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper Cancelled\nSHOPPER_CANCELLED\nThe shopper canceled the transaction before completing it.\n\n\n\nCancel\nShopper cancelled after contactless fallback\nCONTACTLESS_FALLBACK\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper cancelled during application selection\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper cancelled during dcc selection\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper cancelled during online authorization\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper cancelled during validate call\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper cancelled Manual Key Entry\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper cancelled pin entry\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper cancelled tx\nCANCELLED\nThe shopper canceled the transaction before it finished.\n\n\n\nCancel\nShopper did not present a card\nCANCELLED\nThe shopper did not present a card, so the transaction was canceled.\n\n\n\n\nErrorCondition: DeviceOut\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nDeviceOut\nCrash recovery\nPOI_is_Temporary_Unavailable_Terminal_not_ready\nTerminal stopped responding for an unknown reason, causing the transaction to fail.\n\n\n\nDeviceOut\nLow battery\nFailed starting transaction: Low Battery\nBattery charge level dropped below the minimum battery level configured in your Customer Area. Connect the terminal to a power source and retry, or retry using a different terminal.\n\n\n\n\nErrorCondition: InvalidCard\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nInvalidCard\nCard data authentication failed\nDECLINED\nFailed to obtain the relevant card data. The shopper should use an alternate payment method.\n\n\n\nInvalidCard\nNo checking account available on Card\nNO_CHECKING_ACCOUNT\nNo checking account available on the card.\n\n\n\nInvalidCard\nNo savings account available on Card\nNO_SAVINGS_ACCOUNT\nNo savings account available on the card.\n\n\n\n\nErrorCondition: NotAllowed\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nNotAllowed\nBlocked Card\nBLOCK_CARD\nThe selected card application is blocked. It cannot be used for the transaction.\n\n\n\nNotAllowed\nInvalid Amount\nINVALID_AMOUNT\nAn amount mismatch occurred during the transaction.\n\n\n\nNotAllowed\nPayment details are not supported\nERROR\nThe used payment method is not supported. Contact our Support Team.\n\n\n\n\nErrorCondition: Refusal\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nRefusal\nAcquirer Error\nERROR\nThe transaction did not go through due to an error that occurred on the acquirer's end.\n\n\n\nRefusal\nAID banned\nERROR\nThe application is temporarily in our AID penalty box until its payments network can be reached again.\n\n\n\nRefusal\nAlways refused\nDECLINED\nGift card refused.\n\n\n\nRefusal\nAmount too low to be accepted by Card Network\nDECLINED\nThe card network doesn't accept the entered amount because it is too low.\n\n\n\nRefusal\nCard blocked\nBLOCK_CARD\nThe card has been blocked and cannot be used. The shopper should contact their bank.\n\n\n\nRefusal\nCard requires online pin\nPIN_REQUIRED\nCard requires online pin\n\n\n\nRefusal\nCVC Declined\nCVC_DECLINED\nThe specified CVC (card security code) is invalid.\n\n\n\nRefusal\ndeclined\nDECLINED\nTransaction has been declined for a unspecified reason.\n\n\n\nRefusal\nDeclined Non Generic\nDECLINED\nThis response represents all response codes that cannot be reliably mapped. This makes it easier to differentiate between generic declines (for example, Mastercard \"05: Do not honor\" response) and more specific ones.\n\n\n\nRefusal\nExpired Card\nCARD_EXPIRED\nThe card has expired. It cannot be used for the transaction.\n\n\n\nRefusal\nIssuer Suspected Fraud\nISSUER_SUSPECTED_FRAUD\nIssuer reported the transaction as suspected fraud.\n\n\n\nRefusal\nMobile PIN required\nMOBILE_PIN_REQUIRED\nMostly for NFC wallet transactions when extra authentication is needed on the phone to complete the transaction (like enter PIN, unlock phone, or fingerprint).\n\n\n\nRefusal\nNot enough balance\nNOT_ENOUGH_BALANCE\nThe card does not have enough money to cover the payable amount.\n\n\n\nRefusal\nNot Submitted\nNOT_SUBMITTED\nThe transaction was not submitted correctly for processing.\n\n\n\nRefusal\nNot supported\nNOT_SUPPORTED\nThe shopper's bank doesn't support or doesn't allow this type of transaction.\n\n\n\nRefusal\nPin tries exceeded\nPIN_TRIES_EXCEEDED\nThe shopper specified an incorrect PIN more that three times in a row. This error also occurs for example with a Bancontact\/Mister Cash (BCMC) payment where the shopper exceeded the maximum time between transactions without using a PIN.\n\n\n\nRefusal\nPin validation not possible\nPIN_VALIDATION_NOT_POSSIBLE\nIt is not possible to validate the specified PIN number.\n\n\n\nRefusal\nRefused\nDECLINED\nThe transaction was refused. This response is also returned when the transaction is declined based on the fraud rules and checks on the EMV chip.\n\n\n\nRefusal\nRestricted Card\nRESTRICTED_CARD\nSeveral 'Decline' codes are mapped to this refusal reason response value. For example: 62: Restricted Card62: Invalid card in this country\/region\n\n\n\nRefusal\nTimeout waiting for card after contactless fallback\nCONTACTLESS_FALLBACK\nTransaction timed out. Shopper should retry or use an alternate payment method.\n\n\n\nRefusal\nTransaction Not Permitted\nTRANSACTION_NOT_PERMITTED\nSeveral 'Decline' codes are mapped to this refusal reason response value. For example: 57: Transaction not permitted to issuer\/cardholder57: Transaction not allowed for this merchant58: Transaction not permitted to acquirer\/terminal\n\n\n\nRefusal\nWithdrawal count exceeded\nWITHDRAWAL_COUNT_EXCEEDED\nThe number of withdrawals permitted for the shopper's card was exceeded. Also used for contactless transactions (Contactless Withdrawal Count Exceeded).\n\n\n\nRefusal\nWithdrawal amount exceeded\nWITHDRAWAL_AMOUNT_EXCEEDED\nThe withdrawal amount permitted for the shopper's card was exceeded. Also used for contactless transactions (Contactless Withdrawal Amount Exceeded).\n\n\n\n\nErrorCondition: UnreachableHost\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nUnreachableHost\nfailed to go online\nDECLINED\nUnable to go online.\n\n\n\nUnreachableHost\nIssuer Unavailable\nISSUER_UNAVAILABLE\nIt is not possible to contact the shopper's bank to authorize the transaction.\n\n\n\n\nErrorCondition: WrongPIN\n\n\n\nErrorCondition\nrefusalReason\nmessage\nDescription\nRetry?\n\n\n\n\nWrongPIN\nInvalid Pin\nINVALID_PIN\nThe specified PIN number is incorrect or invalid.\n\n\n\n\nSee also\n\n\n                    Raw acquirer responses\n                \n                    Handle responses\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Handle responses","lvl3":"Terminal API refusal reasons"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/error-scenarios","lvl3":"\/point-of-sale\/error-scenarios\/refusal-reasons-pos"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Terminal","refusal","reasons"]}}
