{"title":"Response handling","category":"default","creationDate":1779620072,"content":"<p>The type of response and the details of a response depend on the transaction's stage in the payment lifecycle. Some response details also depend on the entity that is returning the response.<\/p>\n<p>Response details are returned in the API response.<\/p>\n<h2>Types of responses<\/h2>\n<p>The following sections indicate the types of responses, how to interpret them, and recommendations on follow-up actions to take.<\/p>\n<h3>HTTP status codes<\/h3>\n<p>The HTTP status code indicates the status of the API request you sent. The status code shows whether your request is processed successfully, or whether your request encountered an error.<\/p>\n<p>View the list of <a href=\"\/development-resources\/response-handling\/#http-responses\">HTTP status codes<\/a> to understand how to interpret these codes.<\/p>\n<h3>Error codes and messages<\/h3>\n<p>When you make an API request to Adyen and there is an error, you receive a response with a <a href=\"\/development-resources\/response-handling\/#http-responses\">HTTP status code<\/a> different from <code>200<\/code>. In this response, you get <code>errorCode<\/code> and <code>message<\/code> fields that help you diagnose and resolve the error. Errors range from connection issues to wrong payment method setups.<\/p>\n<p>View the list of Adyen <a href=\"\/development-resources\/error-codes\/#generic-error-codes\">error codes and messages<\/a> for an explanation of these codes and how they look in the API response.<\/p>\n<h3>Raw acquirer responses<\/h3>\n<p>A successful payment request (HTTP status code <code>200\/OK<\/code>) does not automatically mean that the payment is successful. The transaction can also be refused or cancelled by the responding financial institution, such as an issuer or payment method.<\/p>\n<p>When a payment is successfully submitted a raw acquirer response is returned that indicates whether the financial institution authorized or rejected the payment. If applicable, the raw acquirer response provides reasons for a transaction that is rejected.<\/p>\n<p>View the list of <a href=\"\/development-resources\/raw-acquirer-responses\/\">raw acquirer responses<\/a> for the most commonly used payment methods.<\/p>\n<h2>How Adyen handles responses<\/h2>\n<p>When handling responses, the raw acquirer response is mapped to a refusal reason and result code.<\/p>\n<h3>Refusal reasons<\/h3>\n<p>Every payment method has its own set of raw acquirer responses. To provide an easier interpretation, Adyen maps each raw acquirer response to a unique <a href=\"\/development-resources\/refusal-reasons\/\">refusal reason<\/a>.<\/p>\n<p>Refusal reasons are included in the API response.<\/p>\n<h3>Result codes<\/h3>\n<p>The <a href=\"\/account\/payments-lifecycle\/?utm_source=bo_live&amp;tab=unsuccessful_payment_2#payment\">result code<\/a> summarizes the status of the response:<\/p>\n<table width=\"100%\">\n<tr>\n<th width=\"35%\">Result codes<\/th>\n<th>Description<\/th>\n<\/tr>\n<tr>\n<td>\n<span translate=\"no\"><b>Authorised<\/b><\/span>\n<\/td>\n<td>\nThe payment is approved by the financial institution.\n<\/td>\n<\/tr>\n<tr>\n<td>\n<span translate=\"no\"><b>Refused<\/b><\/span>\n<\/td>\n<td>\n<p>The transaction is rejected by the payment method or card issuer. The payment method is received, and the request is rejected by the financial institution (e.g. payment method, card issuer). The payment is also refused by Adyen if the risk score is more than 99 points.<\/p>\n<p>More reasons for receiving <span translate=\"no\"><b>Refused<\/b><\/span> include:<\/p>\n<ul>\n<li>Insufficient funds<\/li>\n<li>Issuer unavailable<\/li>\n<li>Suspected fraud<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<span translate=\"no\"><b>Error<\/b><\/span>\n<\/td>\n<td>\n<p>The payment is received, but an error occurred while communicating with the financial institution.<\/p>\n<p>Errors that are returned by Adyen can include the following reasons:\n<\/p><ul>\n<li>Misconfiguration of an acquirer account<\/li>\n<li>Incorrect data elements were submitted<\/li>\n<\/ul>\n\n<p>The full list of Adyen errors can be found in the Error codes and messages page.<\/p>\n<p>Errors can also be returned by external financial institutions, including:\n<\/p><ul>\n<li>Format errors<\/li>\n<li>Issuer is unavailable to respond<\/li>\n<\/ul>\n\n<p>More examples of errors returned by external financial institutions can be found on the <a href=\"\/development-resources\/raw-acquirer-responses\/\">Raw acquirer responses<\/a> page.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<span translate=\"no\"><b>Cancelled<\/b><\/span>\n<\/td>\n<td>\n<p>A cancellation request for a transaction is submitted and approved.<\/p>\n\n<\/td>\n<\/tr>\n\n<\/table>\n<p>Result codes are included in the API response.<\/p>","url":"https:\/\/docs.adyen.com\/development-resources\/overview-response-handling","articleFields":{"description":"Learn about how Adyen handles responses.","feedback_component":true,"id":"24222882","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"12-05-2021 10:56"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/overview-response-handling","title":"Response handling","content":"The type of response and the details of a response depend on the transaction's stage in the payment lifecycle. Some response details also depend on the entity that is returning the response.\nResponse details are returned in the API response.\nTypes of responses\nThe following sections indicate the types of responses, how to interpret them, and recommendations on follow-up actions to take.\nHTTP status codes\nThe HTTP status code indicates the status of the API request you sent. The status code shows whether your request is processed successfully, or whether your request encountered an error.\nView the list of HTTP status codes to understand how to interpret these codes.\nError codes and messages\nWhen you make an API request to Adyen and there is an error, you receive a response with a HTTP status code different from 200. In this response, you get errorCode and message fields that help you diagnose and resolve the error. Errors range from connection issues to wrong payment method setups.\nView the list of Adyen error codes and messages for an explanation of these codes and how they look in the API response.\nRaw acquirer responses\nA successful payment request (HTTP status code 200\/OK) does not automatically mean that the payment is successful. The transaction can also be refused or cancelled by the responding financial institution, such as an issuer or payment method.\nWhen a payment is successfully submitted a raw acquirer response is returned that indicates whether the financial institution authorized or rejected the payment. If applicable, the raw acquirer response provides reasons for a transaction that is rejected.\nView the list of raw acquirer responses for the most commonly used payment methods.\nHow Adyen handles responses\nWhen handling responses, the raw acquirer response is mapped to a refusal reason and result code.\nRefusal reasons\nEvery payment method has its own set of raw acquirer responses. To provide an easier interpretation, Adyen maps each raw acquirer response to a unique refusal reason.\nRefusal reasons are included in the API response.\nResult codes\nThe result code summarizes the status of the response:\n\n\nResult codes\nDescription\n\n\n\nAuthorised\n\n\nThe payment is approved by the financial institution.\n\n\n\n\nRefused\n\n\nThe transaction is rejected by the payment method or card issuer. The payment method is received, and the request is rejected by the financial institution (e.g. payment method, card issuer). The payment is also refused by Adyen if the risk score is more than 99 points.\nMore reasons for receiving Refused include:\n\nInsufficient funds\nIssuer unavailable\nSuspected fraud\n\n\n\n\n\nError\n\n\nThe payment is received, but an error occurred while communicating with the financial institution.\nErrors that are returned by Adyen can include the following reasons:\n\nMisconfiguration of an acquirer account\nIncorrect data elements were submitted\n\n\nThe full list of Adyen errors can be found in the Error codes and messages page.\nErrors can also be returned by external financial institutions, including:\n\nFormat errors\nIssuer is unavailable to respond\n\n\nMore examples of errors returned by external financial institutions can be found on the Raw acquirer responses page.\n\n\n\n\nCancelled\n\n\nA cancellation request for a transaction is submitted and approved.\n\n\n\n\n\nResult codes are included in the API response.","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Response handling"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/development-resources","lvl2":"\/development-resources\/overview-response-handling"},"levels":3,"category":"Development Resources","category_color":"green","tags":["Response","handling"]}}
